از Directions API یا Distance Matrix API مهاجرت کنید

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

نقاط پایانی REST API را به روز کنید

کد خود را برای استفاده از نقاط پایانی Routes API جدید به‌روزرسانی کنید

از Directions API

Directions API https://maps.googleapis.com/maps/api/directions/ outputFormat ? parameters
Routes API https://routes.googleapis.com/directions/v2:computeRoutes

از Distance Matrix API

Distance Matrix API https://maps.googleapis.com/maps/api/distancematrix/ outputFormat ? parameters
Routes API https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

پارامترهای URL را برای استفاده از بدنه درخواست HTTPS تبدیل کنید

با Directions API و Distance Matrix API، ویژگی های پیکربندی را به عنوان پارامترهای URL به درخواست HTTP GET منتقل می کنید. به عنوان مثال، برای Directions API:

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

با Routes API، پارامترها را در بدنه درخواست یا سرصفحه ها به عنوان بخشی از درخواست HTTP POST ارسال می کنید. برای مثال، نگاه کنید به:

نقاط بین راه نشان داده شده به صورت چند خطوط کدگذاری شده را به نقاط بین راهی تبدیل کنید

تعیین نقاط بین راه به‌عنوان چندخط‌های کدگذاری‌شده در Directions API برای جا دادن تعداد زیادی از نقاط راه در محدودیت URL از 8192 نویسه موجود است. این ویژگی در Routes API ضروری نیست، زیرا ایستگاه‌های بین راهی را می‌توان در بدنه درخواست‌های REST یا gRPC به عنوان ایستگاه‌های بین راهی منتقل کرد.

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

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

پارامتر مسیرها یا ماتریس فاصله پارامتر Routes API یادداشت
alternatives computeAlternativeRoutes
arrival_time در دسترس نیست زیرا حالت TRANSIT در دسترس نیست.
avoid routeModifiers
copyrights

در پاسخ گنجانده نشده است. هنگام نمایش نتایج به کاربران خود باید عبارت زیر را درج کنید:

Powered by Google, © YEAR Google

مثلا:

Powered by Google, ©2022 Google

departure_time departureTime
distance distanceMeters فاصله فقط بر حسب متر در دسترس است.
duration_in_traffic در Routes API حذف شد، duration استفاده کنید. برای اطلاعات بیشتر، تغییرات عملکرد برای Routes API جدید را در بالا ببینید.
language languageCode فقط برای مسیرهای محاسباتی پشتیبانی می شود.
mode travelMode

پشتیبانی برای TWO_WHEELER اضافه شد.

حالت TRANSIT در دسترس نیست.

region regionCode

status در دسترس نیست. از کدهای پاسخ HTTP برای خطاهای گزارش شده توسط API استفاده کنید. برای اطلاعات بیشتر به رسیدگی به خطاهای درخواست مراجعه کنید.
traffic_model در دسترس نیست.
transit_mode در دسترس نیست زیرا حالت TRANSIT در دسترس نیست.
transit_routing_preference در دسترس نیست زیرا حالت TRANSIT در دسترس نیست.
units برای ماتریس مسیر در دسترس نیست.
waypoints intermediates پشتیبانی از چند خطوط کدگذاری شده حذف شد.
optimize=true for waypoints در دسترس نیست.