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

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

اگر نشانی صورت‌حساب شما در منطقه اقتصادی اروپا است، از ۸ ژوئیه ۲۰۲۵، شرایط خدمات «پلاتفرم Google Maps» در منطقه اقتصادی اروپا بر استفاده شما از «سرویس‌ها» اعمال خواهد شد. عملکرد بسته به منطقه متفاوت است. بیشتر بدانید.

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

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

روال‌های مطلوب صورت‌حساب برای انتقال

این راهنمایی زمانی کاربرد دارد که استفاده شما از API به‌اندازه‌ای بالا باشد که به سطح دوم قیمت‌گذاری منتقل شوید. هنگام انتقال به نسخه جدیدتر API، صورت‌حساب SKU دیگری نیز برایتان صادر می‌شود. برای جلوگیری از افزایش هزینه‌ها در ماه انتقال، توصیه می‌کنیم تا حد امکان در ابتدای ماه به «میاناهای برنامه‌سازی کاربردی» جدید در مرحله تولید تغییر دهید. این کار تضمین می‌کند که در ماه انتقال به مقرون‌به‌صرفه‌ترین سطوح قیمت‌گذاری ماهانه دست یابید. برای اطلاعات درباره سطوح قیمت‌گذاری، صفحه قیمت‌گذاری و پرسشگان قیمت‌گذاری را ببینید.

به‌روزرسانی نقاط پایانی 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

تبدیل پارامترهای نشانی وب برای استفاده از بدنه درخواست 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	به‌جای پارامتر پُرسمان نشانی وب GET، در بدنه درخواست JSON computeRoutes یا computeRouteMatrix HTTP POST بااستفاده از مقادیر RouteTravelMode (DRIVE، TWO_WHEELER، WALK، TRANSIT، TRUCK، یا BICYCLE برای computeRoutes) ارسال شد. پشتیبانی برای TWO_WHEELER، TRANSIT، و TRUCK اضافه شد.
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 برای نقطه‌مسیرها	"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	فقط برای Compute Routes پشتیبانی می‌شود. فقط حاوی اطلاعات پاسخ زمین‌کدیابی برای ایستگاه‌های بین راهی مشخص‌شده به‌عنوان نشانی است.
bounds	viewport
legs.end_address	دردسترس نیست.	برای مسیریابی با دقت بالا، به‌جای مختصات از شناسه‌های مکان استفاده کنید. شناسه‌های مکان حاوی داده‌هایی هستند که مسیر را به نقاط دسترسی صحیح می‌چسبانند. اگر با نشانی شروع می‌کنید: از تکمیل خودکار جا یا Geocoding API برای تبدیل آن به شناسه جا استفاده کنید. اگر با مختصات شروع کنید: برای ارائه مکان معنادارتر، از جستجوی مقصد استفاده کنید. صرفاً به‌دست آوردن نشانی از مختصات می‌تواند پیچیده باشد و به چسباندن نادرست منجر شود. Routes API مختصات را به نشانی‌ها زمین‌کدیابی معکوس نمی‌کند.
legs.start_address	دردسترس نیست.
overview_polyline	چندخطی
summary	description
waypoint_order	optimizedIntermediateWaypointIndex