مرجع سریع Routes API

‫Routes API یک سرویس وب با دو روش است: Compute Routes مسیری را بین دو مکان با نقاط‌مسیر میانی اختیاری برمی‌گرداند، و Compute Route Matrix مسافت و زمان سفر را برای ترکیبی از مبدأها و مقصدها (تا ۶۲۵ عنصر مسیر) برمی‌گرداند.

میانای برنامه‌سازی کاربردی مسیرها: حقایق کلیدی

  • محصول: Routes API
  • با این نام‌ها نیز شناخته می‌شود: Routes API v2،‏ Compute Routes،‏ Compute Route Matrix
  • دسته: مسیرها
  • پلاتفرم: سرویس وب (REST)
  • اجرا در: سرور (کد پسین)
  • مرحله راه‌اندازی: GA
  • چرخه حیات: فعال
  • نمای کلی: نمای کلی Routes API
  • دردسترس بودن منطقه‌ای: جهانی. مسیریابی موتورسیکلت، مسیرهای بوم‌سازگار، و محاسبه عوارض محدود به کشورها و شهرهای پشتیبانی‌شده است و قلمروهای وابسته با کد CLDR خودشان پشتیبانی نمی‌شوند مگراینکه فهرست شده باشند. برای نشانی‌های صورت‌حساب منطقه اقتصادی اروپا (EEA)، شرایط EEA در https://developers.google.com/maps/comms/eea/routes استفاده از شرح یا مراحل مسیر را با هر نقشه‌ای ممنوع می‌کند. (جزئیات پوشش)

Routes API: when to use it

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

  • برای رانندگی، پیاده‌روی، دوچرخه‌سواری، موتورسواری، یا حمل‌ونقل عمومی به مسیری بین مبدأ و مقصد با نقاط‌مسیر میانی اختیاری نیاز دارید.
  • در یک درخواست، به مسافت‌ها و زمان‌های سفر برای چندین جفت مبدأ-مقصد نیاز دارید (حداکثر ۶۲۵ عنصر).
  • به تخمین هزینه عوارض (شهرهای منتخب)، مسیرهای بوم‌سازگار (مناطق منتخب)، چندخطی‌های آگاه از ترافیک، یا مسیریابی خودروهای بزرگ (دسترسی محدود) نیاز دارید.
  • درحال انتقال برنامه سرور از Directions API یا Distance Matrix API قدیمی هستید.

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

Routes API: setup

بسته‌های رسمی Routes API:

  • npm: @googlemaps/routing
  • pypi: google-maps-routing
  • برو: cloud.google.com/go/maps
  • maven: com.google.maps:google-maps-routing

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

  • مشکل: فهرست پیش‌فرضی برای فیلدهای برگردانده‌شده وجود ندارد؛ درخواست‌های بدون ماسک فیلد (سرصفحه X-Goog-FieldMask یا پارامتر $fields) خطا برمی‌گردانند. راه‌حل: همیشه ماسک فیلدی ارسال کنید که فیلدهای پاسخ موردنیازتان را فهرست کند. ‫/maps/documentation/routes/choose_fields را ببینید.
  • مشکل: استفاده از ماسک فیلد عام (*) در تولید باعث افزایش هزینه و تأخیر می‌شود و با اضافه شدن ویژگی‌های پیشرفته جدید به پاسخ، هزینه می‌تواند به‌طور غیرمنتظره‌ای افزایش یابد. اصلاح: از * فقط درطول توسعه استفاده کنید؛ در نسخه تولید فقط فیلدهای موردنیازتان را درخواست کنید. ‫/maps/documentation/routes/choose_fields را ببینید.
  • مشکل: اطلاعات عوارض و مصرف سوخت فقط با افزودن آن‌ها به ماسک فیلد برگردانده نمی‌شوند؛ از زمان GA، آن‌ها باید به‌طور صریح فعال شوند. اصلاح: آرایه extraComputations (برای مثال TOLLS، FUEL_CONSUMPTION) را علاوه‌بر پوشش فیلد به درخواست اضافه کنید. /maps/documentation/routes/migrate-routes-preview را ببینید.
  • مشکل: Compute Route Matrix‏ ۶۲۵ عنصر را مجاز می‌کند، اما وقتی routingPreference‏ TRAFFIC_AWARE_OPTIMAL باشد، فقط ۱۰۰ عنصر مجاز است. اصلاح: هنگام استفاده از TRAFFIC_AWARE_OPTIMAL، مبدأها و مقصدها را روی ۱۰۰ یا کمتر نگه دارید، یا درخواست را تقسیم کنید. /maps/documentation/routes/compute_route_matrix را ببینید.

کارهایی که می‌توانید با Routes API انجام دهید

برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیت‌ها با یکدیگر مقایسه کنید.