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

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

بهترین شیوه های صدور صورت حساب برای مهاجرت

این راهنما در صورتی اعمال می‌شود که میزان استفاده از API شما به اندازه کافی بالا باشد تا به قیمت‌گذاری سطح دوم بروید. هنگام مهاجرت به نسخه جدیدتر یک API، برای SKU دیگری نیز صورتحساب دریافت می کنید. برای جلوگیری از افزایش هزینه‌ها در طول ماه انتقال، توصیه می‌کنیم تا حد امکان نزدیک به ابتدای ماه به 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 از 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

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

region regionCode
traffic_model trafficModel بیشتر بدانید
transit_mode "travelMode": "TRANSIT" در Directions API، در یک مسیر ترانزیت، هر بخش از یک سفر با حالت سفر یکسان (مثلاً پیاده روی یا ترانزیت) یک مرحله در نظر گرفته می شود و مسیرهای جداگانه برای آن حالت سفر در مراحل فرعی است. در مقابل، در Routes API، مراحل به طور مداوم یک دستورالعمل ناوبری در تمام انواع سفر هستند. بنابراین هر دستورالعمل ناوبری یک مرحله است. برای چند مرحله در یک حالت سفر، Routes API ابرداده‌ای را ارائه می‌کند که حاوی خلاصه‌ای از مراحل آن حالت سفر، در «stepsOverview» است. برای درخواست این ابرداده، از ماسک فیلد «routes.legs.stepsOverview» استفاده کنید. بیشتر بدانید .
transit_routing_preference transitRoutingPreference بیشتر بدانید
units units بیشتر بدانید
waypoints intermediates پشتیبانی از چند خطوط کدگذاری شده حذف شد.
optimize=true for waypoints "optimizeWaypointOrder": "true" بیشتر بدانید

تبدیل پارامترهای پاسخ

پارامتر ماتریس جهت یا فاصله پارامتر Routes API یادداشت ها
copyrights

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

Powered by Google, © YEAR Google

به عنوان مثال:

Powered by Google, ©2022 Google

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