انتقال از Directions API (قدیمی) یا Distance Matrix API (قدیمی)

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

این راهنما نحوه انتقال برنامه‌هایی را که از 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
میانای برنامه‌سازی کاربردی مسیرها https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

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

با «میانای برنامه‌سازی کاربردی مسیرها» و «میانای برنامه‌سازی کاربردی ماتریس فاصله»، ویژگی‌های پیکربندی را به‌عنوان پارامترهای نشانی وب به درخواست HTTP GET ارسال می‌کنید. برای مثال، برای Directions API:

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

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

تبدیل کردن ایستگاه‌های بین راهی کدبندی‌شده با چندخطی به ایستگاه‌های بین راهی مکان

مشخص کردن ایستگاه‌های بین راهی به‌عنوان چندخطی‌های کدگذاری‌شده در Directions API (قدیمی) دردسترس است تا تعداد زیادی ایستگاه بین راهی در حد مجاز نشانی وب ۱۶۳۸۴ نویسه جای بگیرد. این ویژگی در «میانای برنامه‌سازی کاربردی مسیرها» لازم نیست زیرا ایستگاه‌های بین راهی را می‌توان در بدنه درخواست REST یا gRPC به‌صورت مختصات عرض جغرافیایی/طول جغرافیایی منتقل کرد. برای مثال، مثال HTTP در سند محاسبه ماتریس مسیر، یا تعریف ایستگاه بین راهی در سند مشخص کردن ایستگاه‌های بین راهی را ببینید.

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

جدول‌های زیر پارامترهای موجود در 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" در «میانای برنامه‌سازی کاربردی مسیرها» (قدیمی)، در مسیر حمل‌ونقل عمومی، هر بخش از سفر با حالت سفر یکسان (برای نمونه، پیاده‌روی یا حمل‌ونقل عمومی) یک مرحله درنظر گرفته می‌شود و دستورالعمل‌های جداگانه برای آن حالت سفر در زیرمرحله‌ها قرار دارد. درمقابل، در Routes API، مراحل به‌طور مداوم یک دستورالعمل ناوبری در همه انواع سفر هستند. بنابراین هر دستورالعمل پیمایش یک مرحله است. برای چند مرحله در یک حالت سفر، Routes API فراداده‌ای ارائه می‌دهد که حاوی خلاصه‌ای از مراحل آن حالت سفر در `stepsOverview` است. برای درخواست این فراداده، از پوشش فیلد `routes.legs.stepsOverview` استفاده کنید. بیشتر بدانید.
transit_routing_preference transitRoutingPreference بیشتر بدانید
units units بیشتر بدانید
waypoints intermediates پشتیبانی از چندخطی‌های کدبندی‌شده برداشته شد.
‫optimize=true برای ایستگاه‌های بین راهی "optimizeWaypointOrder": "true" بیشتر بدانید

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

پارامتر «دستورات» یا «ماتریس فاصله» پارامتر Routes API یادداشت‌ها
copyrights

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

Powered by Google, ©YEAR Google

برای مثال:

Powered by Google, ©2022 Google
distance distanceMeters فاصله فقط به متر دردسترس است.
duration_in_traffic duration در «میانای برنامه‌سازی کاربردی مسیرها» برداشته شده است، از duration استفاده کنید.
status دردسترس نیست. از کدهای پاسخ HTTP برای خطاهای گزارش‌شده توسط API استفاده کنید. برای اطلاعات بیشتر، خطاهای درخواست مدیریت را ببینید.
geocoded_waypoints geocoding_results فقط برای «محاسبه مسیرها» پشتیبانی می‌شود. فقط حاوی اطلاعات پاسخ زمین‌کدیابی برای ایستگاه‌های بین راهی مشخص‌شده به‌عنوان نشانی است.
bounds viewport
legs.end_address دردسترس نیست.

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

  • اگر با نشانی شروع می‌کنید: از تکمیل خودکار مکان یا Geocoding API برای تبدیل آن به شناسه مکان استفاده کنید.
  • اگر با مختصات شروع کنید: برای ارائه مکان معنادارتر، از جستجوی مقصد استفاده کنید. دستیابی به نشانی ازطریق مختصات می‌تواند پیچیده باشد و منجر به چسبیدن نادرست شود. «میانای برنامه‌سازی کاربردی مسیرها» مختصات را به نشانی‌های زمین‌کد معکوس تبدیل نمی‌کند.
legs.start_address دردسترس نیست.
overview_polyline چندخطی
summary description
waypoint_order optimizedIntermediateWaypointIndex