این راهنما نحوه انتقال برنامههایی را که از Directions API یا Distance Matrix API استفاده میکنند به Routes API توضیح میدهد. برای جزئیات بیشتر در مورد Routes API، به نمای کلی محصول مراجعه کنید.
کد خود را برای استفاده از نقاط پایانی Routes API جدید بهروزرسانی کنید
Directions API | https://maps.googleapis.com/maps/api/directions/ outputFormat ? parameters |
Routes API | https://routes.googleapis.com/directions/v2:computeRoutes |
Distance Matrix API | https://maps.googleapis.com/maps/api/distancematrix/ outputFormat ? parameters |
Routes API | https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix |
با 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 از 16384 نویسه موجود است. این ویژگی در Routes API ضروری نیست زیرا نقاط بین راه را می توان در بدنه درخواست REST یا gRPC به عنوان مختصات طول و عرض جغرافیایی منتقل کرد. برای مثال، مثال HTTP را در سند ماتریس محاسبه مسیر یا تعریف یک نقطه میانی در سند Specify intermediate waypoints را ببینید.
جداول زیر پارامترهایی را در Directions API و Distance Matrix API که تغییر نام داده یا اصلاح شده اند یا پارامترهایی که در نسخه GA پشتیبانی نمی شوند فهرست می کند. اگر از هر یک از این پارامترها استفاده می کنید، کد خود را به روز کنید.
پارامتر ماتریس جهت یا فاصله | پارامتر Routes API | یادداشت |
---|---|---|
alternatives | computeAlternativeRoutes | |
arrival_time | arrivalTime | فقط در حالت TRANSIT و نه همزمان با departureTime موجود است. |
avoid | routeModifiers | |
departure_time | departureTime | نمی توان همزمان با arrivalTime استفاده کرد. |
language | languageCode | فقط برای مسیرهای محاسباتی پشتیبانی می شود. |
mode | travelMode | پشتیبانی برای |
region | regionCode | |
traffic_model | trafficModel | بیشتر بدانید |
transit_mode | "travelMode": "TRANSIT" | در Directions API، در یک مسیر ترانزیت، هر بخش از یک سفر با حالت سفر یکسان (مثلاً پیاده روی یا ترانزیت) یک مرحله در نظر گرفته می شود و مسیرهای جداگانه برای آن حالت سفر در مراحل فرعی است. در مقابل، در Routes API، مراحل به طور مداوم یک دستورالعمل ناوبری در تمام انواع سفر هستند. بنابراین هر دستورالعمل ناوبری یک مرحله است. برای چند مرحله در یک حالت سفر، Routes API ابردادهای را ارائه میکند که حاوی خلاصهای از مراحل آن حالت سفر، در «stepsOverview» است. برای درخواست این ابرداده، از ماسک فیلد «routes.legs.stepsOverview» استفاده کنید. بیشتر بدانید . |
transit_routing_preference | transitRoutingPreference | بیشتر بدانید |
units | برای ماتریس مسیر در دسترس نیست. | |
waypoints | intermediates | پشتیبانی از چند خطوط کدگذاری شده حذف شد. |
optimize=true for waypoints | "optimizeWaypointOrder": "true" | بیشتر بدانید |
پارامتر ماتریس جهت یا فاصله | پارامتر Routes API | یادداشت |
---|---|---|
copyrights | در پاسخ گنجانده نشده است. هنگام نمایش نتایج به کاربران خود باید عبارت زیر را درج کنید: مثلا: | |
distance | distanceMeters | فاصله فقط بر حسب متر در دسترس است. |
duration_in_traffic | duration | در Routes API حذف شد، duration استفاده کنید. |
status | در دسترس نیست. از کدهای پاسخ HTTP برای خطاهای گزارش شده توسط API استفاده کنید. برای اطلاعات بیشتر به رسیدگی به خطاهای درخواست مراجعه کنید. | |
geocoded_waypoints | geocoding_results | فقط برای مسیرهای محاسباتی پشتیبانی می شود. حاوی اطلاعات پاسخ کدگذاری جغرافیایی فقط برای نقاط راه مشخص شده به عنوان آدرس است. |
bounds | viewport | |
legs.end_address | در دسترس نیست. | |
legs.start_address | در دسترس نیست. | |
overview_polyline | چند خطی | |
summary | description | |
waypoint_order | optimizedIntermediateWaypointIndex |