مرجع سریع Directions API

‫Directions API (Legacy)‎ یک سرویس وب است که مسیرهای بین مکان‌ها را برای رانندگی، پیاده‌روی، دوچرخه‌سواری، و حمل‌ونقل عمومی، ازجمله مسیرهای چندبخشی با نقطه‌مسیرها، محاسبه می‌کند و مسیرها، بخش‌ها، و مراحل را در قالب JSON یا XML برمی‌گرداند. در وضعیت «قدیمی» است: از اکتبر ۲۰۲۶ نمی‌توان آن را برای پروژه‌های جدید Google Cloud فعال کرد؛ به Routes API منتقل شوید.

Directions API: حقایق کلیدی

  • محصول: Directions API
  • با این نام هم شناخته می‌شود: Directions API (قدیمی)
  • دسته: مسیرها
  • پلاتفرم: سرویس وب (REST)
  • اجرا در: سرور (کد پسین)
  • مرحله راه‌اندازی: GA
  • چرخه حیات: قدیمی
  • جایگزین‌شده با: Routes API
  • نمای کلی: نمای کلی Directions API
  • دردسترس بودن منطقه‌ای: جهانی. پوشش بسته به منطقه و حالت سفر متفاوت است (حمل‌ونقل عمومی به داده‌های ارائه‌دهندگان حمل‌ونقل عمومی بستگی دارد). (جزئیات پوشش)

Directions API: زمان استفاده از آن

در شرایط زیر از Directions API استفاده کنید:

  • شما پروژه Google Cloud موجودی را نگهداری می‌کنید که ازقبل Directions API (قدیمی) در آن فعال است و maps/api/directions را فراخوانی می‌کند.
  • در پروژه موجود، به مسیرهای سمت سرور برای رانندگی، پیاده‌روی، دوچرخه‌سواری، یا حمل‌ونقل عمومی (نقاط‌مسیر فقط برای حالت‌های غیرحمل‌ونقل عمومی) در JSON یا XML نیاز دارید.

در موارد زیر از Directions API استفاده نکنید:

  • درحال شروع پروژه Google Cloud جدیدی هستید؛ از اکتبر ۲۰۲۶، Directions API (قدیمی) را نمی‌توان برای پروژه‌های جدید فعال کرد. درعوض از Routes API استفاده کنید.
  • به ویژگی‌های جدید مسیریابی و عملکرد بهبودیافته نیاز دارید. درعوض از Routes API استفاده کنید.
  • در یک درخواست، به زمان‌های سفر و مسافت‌های بین چندین مبدأ و مقصد نیاز دارید. درعوض از Routes API استفاده کنید.

Directions API: setup

Directions API: اشتباهات رایج

  • مشکل: درخواست‌های ارسال‌شده به Directions API (قدیمی) از پروژه‌ای که میانای برنامه‌سازی کاربردی قدیمی در آن فعال نشده است با LegacyApiNotActivatedMapError ناموفق می‌شود. راه‌حل: اگر مالک برنامه هستید، به Routes API منتقل شوید. به‌عنوان راه‌حلی کوتاه‌مدت درحین انتقال یا انتظار برای به‌روزرسانی برنامه، می‌توانید با تکمیل فرم فعال‌سازی API قدیمی، API قدیمی را فعال کنید. /maps/legacy را ببینید.
  • مشکل: استفاده از پیشوند via: در نقاط‌مسیر باعث می‌شود که آن‌ها به‌عنوان نقاط عبور دقیق درنظر گرفته شوند، که می‌تواند منجر به انحراف‌های شدید یا وضعیت ZERO_RESULTS شود. اصلاح: از نقاط‌مسیر توقفگاه (بدون پیشوند via:) استفاده کنید، مگراینکه نقطه عبور دقیق لازم باشد. /maps/documentation/directions/get-directions را ببینید.
  • مشکل: درخواست‌های دارای ۱۱ تا ۲۵ نقطه‌مسیر، optimize:true، مدت‌های بااحتساب ترافیک (duration_in_traffic)، یا اصلاح‌کننده‌های مکان side_of_road یا heading با شناسه محصول بالاتر Directions Advanced (Pro) صورت‌حساب می‌شوند. راه‌حل: فقط وقتی به این ویژگی‌ها نیاز دارید از آن‌ها استفاده کنید؛ تعداد نقاط‌مسیر را ۱۰ یا کمتر نگه دارید و optimize:true، departure_time (برای رانندگی)، side_of_road، و heading را حذف کنید تا در SKU «ضروریات» بمانید. /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku را ببینید.
  • مشکل: برای رانندگی، departure_time نمی‌تواند در گذشته باشد (درخواست با INVALID_REQUEST ناموفق می‌شود). بدون departure_time، مسیر و مدت‌زمان از میانگین ترافیک مستقل از زمان استفاده می‌کنند و هیچ duration_in_traffic برگردانده نمی‌شود. اصلاح: departure_time را روی now یا زمان آینده با mode=driving تنظیم کنید تا duration_in_traffic را دریافت کنید. درخواست‌هایی که duration_in_traffic را برمی‌گردانند با شناسه کالای «مسیرهای پیشرفته (Pro)» صورت‌حساب می‌شوند. /maps/documentation/directions/get-directions را ببینید.