چرا باید به Routes API منتقل شوید؟

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

«میانای برنامه‌سازی کاربردی مسیرها» عملکرد بهبودیافته‌ای برای محاسبه مسیرها، فاصله، و زمان سفر ارائه می‌دهد، و به همین دلیل جایگزین کردن برنامه‌هایی که از «میانای برنامه‌سازی کاربردی مسیرها» و «میانای برنامه‌سازی کاربردی ماتریس فاصله» استفاده می‌کنند ارزشمند است. بیشتر عملکردهای Routes API با هر دو Directions API و Distance Matrix API سازگار با نسخه قدیمی است.

از این راهنما برای درک تفاوت‌های کلیدی در «میانای برنامه‌سازی کاربردی مسیرها» در مقایسه با محصولاتی که جایگزین آن‌ها می‌شود، و همچنین نحوه مدیریت تغییرات ضروری استفاده کنید. برای جزئیات بیشتر درباره ویژگی‌های دیگر «میانای برنامه‌سازی کاربردی مسیرها»، نمای کلی محصول را ببینید.

بهبودهای کلیدی

این بخش برخی‌از بهبودهایی را که می‌توانید هنگام استفاده از «میانای برنامه‌سازی کاربردی مسیرها» در برنامه‌هایتان انتظار داشته باشید پوشش می‌دهد.

حدود افزایش‌یافته درخواست

Routes API Compute Route Matrix
  • حداکثر ۶۲۵ عنصر، مگراینکه TRAFFIC_AWARE_OPTIMAL را مشخص کنید.
  • حداکثر ۱۰۰ عنصر با TRAFFIC_AWARE_OPTIMAL. اولویت‌های رهیابی بهبودیافته را ببینید.
  • حداکثر ۵۰ نقطه بین راه (مبدأ + مقصد) بااستفاده از «شناسه مکان».
Distance Matrix API
  • حداکثر ۲۵ مبدأ یا ۲۵ مقصد در هر درخواست.
  • حداکثر ۱۰۰ عنصر (تعداد مبدأ × تعداد مقصد) برای هر درخواست سمت سرور.

پاسخ‌های سریع‌تر به درخواست

ویژگی «محاسبه ماتریس مسیر» بهبودهای زیر را در تأخیر ارائه می‌دهد:

  • دریافت عناصر جاری‌سازی پاسخ قبل‌از اینکه کل ماتریس محاسبه شود.
  • از ماسک‌های فیلد برای سفارشی‌سازی جزئیات پاسخ استفاده کنید و فقط داده‌های موردنیازتان را درخواست کنید. این روشی بهینه است که به کاهش هزینه‌هایتان نیز کمک می‌کند.
  • محاسبات مسیر بهبودیافته برای ترافیک، تا بتوانید بین کیفیت داده و زمان پاسخ‌دهی توازن برقرار کنید.

بهبودهای مسیریابی

ویژگی محاسبه مسیر این بهبودهای مسیریابی را ارائه می‌دهد:

  • اطلاعات عوارض علاوه‌بر مسافت و زمان تخمینی رسیدن.
  • مسیرهای وسیله نقلیه ۲ چرخ.
  • نقطه‌مسیرهای توقف را ازنظر ایمنی بررسی کنید.
  • با تنظیم جهت سفر و کنار جاده برای ایستگاه‌های بین راهی، دقت «زمان تخمینی رسیدن» افزایش یافت.

فقط داده‌هایی را که نیاز دارید درخواست کنید

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

میانای برنامه‌سازی کاربردی مسیرها
محاسبه مسیرها
محاسبه ماتریس مسیر 		درخواست‌هایتان باید از پوشش فیلد برای مشخص کردن فیلدهایی که می‌خواهید در پاسخ برگردانده شود استفاده کنند. ماسک کردن فیلد تضمین می‌کند که داده‌های غیرضروری درخواست نکنید، که این امر از زمان پردازش غیرضروری و هزینه‌های صورت‌حساب جلوگیری می‌کند.
برای اطلاعات بیشتر، انتخاب فیلدها برای برگرداندن را ببینید.
Directions API
Distance Matrix API 		فهرست پیش‌فرضی از فیلدها را برمی‌گرداند، حتی اگر برنامه‌تان به آن‌ها نیاز نداشته باشد. این کار می‌تواند منجر به زمان پردازش غیرضروری و هزینه‌های صورت‌حساب شود.

محاسبات بهبودیافته مسیر برای ترافیک

‫Routes API از سه اولویت مسیریابی پشتیبانی می‌کند که می‌توانید از آن‌ها برای ایجاد توازن بین تأخیر پاسخ و کیفیت داده هنگام درخواست اطلاعات ترافیک استفاده کنید.

برای اطلاعات بیشتر، به پیکربندی کیفیت دربرابر تأخیر مراجعه کنید.

TRAFFIC_UNAWARE
(پیش‌فرض)		 برای محاسبه مسیر، از داده‌های ترافیک میانگین مستقل از زمان استفاده می‌کند، نه داده‌های ترافیک زنده، که منجر به کمترین تأخیر پاسخ می‌شود. این تنظیم معادل زمانی است که از ترافیک در «میانای برنامه‌سازی کاربردی مسیرها» و «میانای برنامه‌سازی کاربردی ماتریس فاصله» استفاده نمی‌شود.
TRAFFIC_AWARE
(جدید)		 کیفیت ترافیک زنده بهینه‌شده ازنظر عملکرد برای کاهش تأخیر. برخلاف TRAFFIC_AWARE_OPTIMAL، این تنظیم بهینه‌سازی‌هایی را برای کاهش قابل‌توجه تأخیر اعمال می‌کند. این تنظیم برای «میانای برنامه‌سازی کاربردی Routes» نیز جدید است و در «میانای برنامه‌سازی کاربردی Directions» یا «میانای برنامه‌سازی کاربردی Distance Matrix» معادل ندارد.
TRAFFIC_AWARE_OPTIMAL داده‌های ترافیک جامع و با کیفیت بالا. این تنظیم بالاترین تأخیر را ایجاد می‌کند و معادل تنظیم departure_time در Directions API و Distance Matrix API است.
این اولویت معادل حالت استفاده‌شده توسط maps.google.com و برنامه تلفن همراه Google Maps است.

مقایسه محاسبه مسیر

جدول زیر گزینه‌های مسیریابی را بین سرویس‌های Routes API و Directions API و Distance Matrix API مقایسه می‌کند.

گزینه ترافیک میانای برنامه‌سازی کاربردی مسیرها Directions API
Distance Matrix API		 تأخیر
ترافیک هم‌زمان وجود ندارد TRAFFIC_UNAWARE ‫departure_time دارایی تنظیم نشده است سریع‌ترین تأخیر در بین سه حالت.
شرایط ترافیک لحظه‌ای اعمال شد TRAFFIC_AWARE معادل ندارد

حالت جدیدی که توسط Routes API اضافه شده است. این روش نسبت‌به TRAFFIC_UNAWARE تأخیر کمی بیشتری دارد و هزینه کیفیت «زمان تخمینی رسیدن» آن کم است.

تأخیر آن بسیار کمتر از TRAFFIC_AWARE_OPTIMAL است.
داده‌های ترافیک زنده جامع و با کیفیت بالا اعمال شد TRAFFIC_AWARE_OPTIMAL ‫departure_time مجموعه دارایی

معادل حالت استفاده‌شده توسط maps.google.com و برنامه تلفن همراه Google Maps.

برای «محاسبه ماتریس مسیر»، تعداد عناصر در یک درخواست (تعداد مبدأها × تعداد مقصدها) نمی‌تواند از ۱۰۰ بیشتر شود.

تفاوت‌های کلیدی

این بخش تفاوت‌های کلیدی بین «میانای برنامه‌سازی کاربردی مسیرها» و سرویس‌هایی را که جایگزین می‌کند پوشش می‌دهد، و همچنین روش‌هایی که می‌توانید هنگام انتقال از این سرویس‌ها در برنامه‌های موجودتان به این تفاوت‌ها رسیدگی کنید.

به‌جای دو سرویس، با یک سرویس تماس بگیرید

میانای برنامه‌سازی کاربردی مسیرها برای اینکه برنامه‌تان از Compute Routes و Compute Route Matrix استفاده کند، فقط یک سرویس را در «کنسول API» فعال کنید.
برای اطلاعات بیشتر، راه‌اندازی در کنسول Google API را ببینید.
Directions API
Distance Matrix API 		دو سرویس را فعال کنید: Directions API و Distance Matrix API به‌عنوان سرویس‌های جداگانه در «کنسول API».

‫HTTPS POST درخواست مصرف می‌کند

میانای برنامه‌سازی کاربردی مسیرها پارامترها را در بدنه درخواست یا در سرایندها به‌عنوان بخشی از درخواست HTTP POST ارسال کنید.
برای مثال، به این موارد مراجعه کنید:
- محاسبه مسیر
- محاسبه ماتریس مسیر
Directions API
Distance Matrix API 		پارامترهای نشانی وب را بااستفاده از درخواست HTTP GET ارسال کنید.

تفاوت‌های پاسخ ETA

«میانای برنامه‌سازی کاربردی مسیرها» زمان تخمینی رسیدن را برمی‌گرداند و از دارایی پاسخ duration متفاوت از خدمات «میانای برنامه‌سازی کاربردی مسیرها» و «میانای برنامه‌سازی کاربردی ماتریس فاصله» استفاده می‌کند، همان‌طور که در جدول زیر نشان داده شده است.

نوع ETA میانای برنامه‌سازی کاربردی مسیرها Directions API
Distance Matrix API
زمان تقریبی ورود مستقل از زمان و بدون اطلاع از ترافیک.

بااستفاده از TRAFFIC_UNAWARE تنظیم شد.

  • زمان تخمینی ورود در ویژگی پاسخ duration گنجانده شده است.
  • ویژگی‌های پاسخ duration و staticDuration حاوی مقدار یکسانی هستند.

مربوط به departure_time است که در درخواست تنظیم نشده است.

  • زمان تخمینی ورود در ویژگی پاسخ duration گنجانده شده است.
  • خصوصیت پاسخ duration_in_traffic برگردانده نمی‌شود.
«زمان تقریبی ورود» که ترافیک هم‌زمان را درنظر می‌گیرد.

بااستفاده از TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم می‌شود.

  • «زمان تقریبی ورود» که ترافیک هم‌زمان را درنظر می‌گیرد در دارایی پاسخ duration قرار دارد.
  • ویژگی پاسخ staticDuration حاوی مدت زمان سفر در مسیر بدون درنظر گرفتن شرایط ترافیک است.
  • خصوصیت duration_in_traffic دیگر برگردانده نمی‌شود.

بااستفاده از departure_time در درخواست تنظیم می‌شود.

  • «زمان تقریبی رسیدن» که ترافیک هم‌زمان را درنظر می‌گیرد در دارایی پاسخ duration_in_traffic قرار دارد.

ایستگاه‌های بین راهی چندخطی

با این سرویس که از بدنه درخواست POST پشتیبانی می‌کند و بنابراین دیگر تحت‌تأثیر محدودیت‌های رشته نشانی وب قرار نمی‌گیرد، دیگر نیازی به تبدیل مختصات طول/عرض جغرافیایی به نقاط‌مسیر چندخطی ندارید. برخی‌از کاربران Distance Matrix API با تبدیل کردن نقاط طول/عرض جغرافیایی به ایستگاه‌های چندخطی، مشکل محدودیت درخواست را برطرف کردند.

نشانی‌های قالب‌بندی‌شده (زمین‌کدیابی معکوس)

«میانای برنامه‌سازی کاربردی مسیرها» نشانی‌های قالب‌بندی‌شده را در پاسخ ارائه نمی‌دهد. برای دریافت نشانی‌های قالب‌بندی‌شده، از Geocoding API استفاده کنید که برای این مورد استفاده ساخته شده است و نتایج با کیفیت بالاتری ارائه می‌دهد.

حالت‌های سفر دردسترس

همانند Directions API،‏ Routes API وقتی حالت سفر در درخواست مسیر مشخص نشده باشد، از DRIVE به‌عنوان حالت پیش‌فرض استفاده می‌کند. بااین‌حال، وقتی درخواستی حالت سفر را برای مسیری مشخص می‌کند، Routes API آرایه‌ای از حالت‌های سفر دردسترس را به‌عنوان انتخاب‌های جایگزین برای درخواست برنمی‌گرداند. اگر مورد استفاده شما به این ویژگی متکی است، مشکل را ثبت کنید و نحوه استفاده‌تان از این ویژگی را شرح دهید تا بتوانیم آن را پیگیری کنیم.

‫XML به‌عنوان قالب پاسخ

Routes API قالب XML را به‌عنوان قالب پاسخ ارائه نمی‌دهد. می‌توانید تعدادی مبدل JSON به XML را به‌صورت آنلاین پیدا کنید که باید برای اهداف شما مناسب باشند.