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

Bu kılavuzda, Directions API veya DISTANCE Matrix API'yi kullanan uygulamaların Routes API'yi kullanan uygulamalara nasıl taşınacağı açıklanmaktadır. Routes API hakkında ayrıntılı bilgi için ürüne genel bakış sayfasını inceleyin.

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 ve Mesafe Matrisi API'si ile yapılandırma özelliklerini, bir HTTP GET isteğine URL parametreleri olarak iletirsiniz. Örneğin, Directions API için:

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

Routes API ile parametreleri bir istek gövdesinde veya HTTP POST isteğinin parçası olarak başlıklarda iletirsiniz. Örnekler:

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

16.384 karakterlik URL sınırındaki çok sayıda ara noktayı sığdırmak için, Directions API'de referans noktalarını kodlanmış çoklu çizgiler olarak belirtme özelliği mevcuttur. Ara noktaları, REST veya gRPC istek gövdesinde enlem/boylam koordinatları olarak iletilebileceği için bu özellik Routes API'de gerekli değildir. Örnekler için Rota matrisi hesaplama belgesindeki HTTP Örneği bölümüne veya Ara ara noktalar belirtme belgesindeki Ara ara nokta tanımlama bölümüne bakın.

Parametreleri dönüştür

Aşağıdaki tablolarda, yeniden adlandırılan veya değiştirilen Directions API ve DISTANCE Matris API'deki parametreler ya da GA sürümünde desteklenmeyen parametreler listelenmiştir. 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 departureTime ile aynı anda kullanılamaz.
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 için destek eklendi.
region regionCode
traffic_model trafficModel Daha fazla bilgi
transit_mode "travelMode": "TRANSIT" Directions API'de bir toplu taşıma rotasında, seyahatin her bir segmenti (ör. yürüyüş veya toplu taşıma) tek bir adım olarak kabul edilir ve bu ulaşım şekli için ayrı yol tarifleri alt adımlarda yer alır. Buna karşılık Routes API'de adımlar, tüm seyahat türlerinde tutarlı bir şekilde tek bir navigasyon talimatıdır. Yani her gezinme talimatı bir adımdır. Routes API, tek bir ulaşım modunda birden fazla adım için "stepsOverview" bölümünde söz konusu ulaşım şekliyle ilgili adımların özetini içeren meta veriler sağlar. Bu meta verileri istemek için "routes.legs.stepsOverview" alan maskesini kullanın. 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. Sonuçları kullanıcılarınıza gösterirken aşağıdaki ifadeyi eklemeniz gerekir:

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 Kullanılamıyor. API tarafından bildirilen hatalar için HTTP yanıt kodlarını kullanın. Daha fazla bilgi için İstek hatalarını işleme bölümüne bakın.
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 Kullanılamıyor.
legs.start_address Kullanılamıyor.
overview_polyline çoklu çizgi
summary description
waypoint_order optimizedIntermediateWaypointIndex