‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

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

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

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

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

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

به‌روزرسانی نقاط پایانی REST API

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

از Directions API

Directions API	`https://maps.googleapis.com/maps/api/directions/outputFormat?parameters`
میانای برنامه‌سازی کاربردی Routes	`https://routes.googleapis.com/directions/v2:computeRoutes`

از Distance Matrix API

Distance Matrix API	`https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters`
میانای برنامه‌سازی کاربردی Routes	`https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix`

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

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

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

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

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

مشخص کردن نقطه‌مسیرها به‌عنوان چندخطی‌های کدبندی‌شده در Directions API (قدیمی) دردسترس است تا تعداد زیادی نقطه‌مسیر در حد نشانی وب ۱۶۳۸۴ نویسه جا شود. این ویژگی در Routes 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`	فقط برای Compute Routes پشتیبانی می‌شود.
`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`