Directions API'den veya DISTANCE Matrix API'den geçiş

Bu kılavuzda, Routes API'yi seçin. Routes API hakkında ayrıntılı bilgi için ürüne göz atın. genel bakış bölümüne bakın.

REST API uç noktalarını güncelleme

Yeni Routes API uç noktalarını kullanmak için kodunuzu güncelleyin

Directions API'den

Directions API https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API https://routes.googleapis.com/directions/v2:computeRoutes

Mesafe Matrisi API'sinden

Distance Matrix API https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
Routes API https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

URL parametrelerini HTTPS istek gövdesini kullanacak şekilde dönüştürme

Yol Tarifi API'si ve Mesafe Matrisi API'si ile, yapılandırma özelliklerini HTTP GET isteğine URL parametreleri olarak iletin. Örneğin, örneğin, Directions API için:

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

Routes API ile parametreleri bir istek gövdesinde veya başlıklarda geçirirsiniz HTTP POST isteği kapsamında. Örnekler:

Çoklu çizgiyle kodlanmış ara noktaları konum ara noktalarına dönüştürün

Referans noktalarını kodlanmış çoklu çizgiler olarak belirtme Geniş bir alana uyması için Directions API 16.384 karakterlik URL sınırındaki ara nokta sayısı. Bu özellik gereklidir çünkü ara noktalar Enlem/boylam koordinatları olarak REST veya gRPC istek gövdesi. Örneğin, bkz. HTTP Örneği Rota matrisi hesaplama dokümanında yer alan Ara bir ara nokta belirleyin Ara ara noktaları belirtme dokümanını inceleyin.

Parametreleri dönüştür

Aşağıdaki tablolarda, Directions API ve DISTANCE Matris API 'nin Değiştirilmiş veya yeniden adlandırılmış ya da GA'da desteklenmeyen parametreler kullanabilirsiniz. Bu parametrelerden herhangi birini kullanıyorsanız kodunuzu güncelleyin.

Parametre dönüşümlerini iste

Yol Tarifi veya Mesafe matrisi parametresi Routes API parametresi Notlar
alternatives computeAlternativeRoutes
arrival_time arrivalTime Yalnızca TRANSIT modunda kullanılabilir ve aynı anda kullanılamaz saat departureTime olarak ayarlandı.
avoid routeModifiers
departure_time departureTime arrivalTime ile aynı anda kullanılamaz.
language languageCode Yalnızca İşlem Rotaları için desteklenir.
mode travelMode

TWO_WHEELER ve TRANSIT.
region regionCode
traffic_model trafficModel Daha fazla bilgi
transit_mode "travelMode": "TRANSIT" Directions API'de toplu taşıma rotasında her bir bir seyahat segmenti (ör. Yaya veya Transit) tek bir adım, sonraki seyahat için de tek tek yol tarifi olarak kabul edilir olduğunu da görebilirsiniz. Buna karşın Routes API, adımlar tutarlı bir şekilde tek bir gezinme talimatıdır sizi bekliyor. Yani her gezinme talimatı bir adımdır. Routes API, tek bir ulaşım modunda birden fazla adım için söz konusu ulaşım şekline yönelik adımların özetini içeren meta veriler `stepsOverview`. Bu meta verileri istemek için şunu kullanın: "routes.legs.stepsOverview" alan maskesi kullanabilirsiniz. Daha fazla bilgi edinin.
transit_routing_preference transitRoutingPreference Daha fazla bilgi
units Rota matrisi için kullanılamıyor.
waypoints intermediates Kodlanmış çoklu çizgiler desteği kaldırıldı.
Ara noktalar için optimize=true "optimizeWaypointOrder": "true" Daha fazla bilgi

Yanıt parametresi dönüşümleri

Yol Tarifi veya Mesafe matrisi parametresi Routes API parametresi Notlar
copyrights

Yanıta dahil değildir. Aşağıdakileri eklemelisiniz şu ifadeleri kullanın:

Powered by Google, ©YEAR Google

Örneğin:

Powered by Google, ©2022 Google
distance distanceMeters Mesafe yalnızca metre cinsinden sunulur.
duration_in_traffic duration Routes API'de kaldırıldı, duration kullanın.
status Yok. Şunun için HTTP yanıt kodlarını kullanın: hataları gösterir. İstek hatalarını işleme bölümüne bakın. konulu videomuzu izleyin.
geocoded_waypoints geocoding_results Yalnızca İşlem Rotaları için desteklenir. Yalnızca adres olarak belirtilen ara noktalara ilişkin coğrafi kodlama yanıt bilgilerini içerir.
bounds viewport
legs.end_address Yok.
legs.start_address Yok.
overview_polyline çoklu çizgi
summary description
waypoint_order optimizedIntermediateWaypointIndex