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

Bu kılavuzda, Directions API veya Distance Matrix API kullanan uygulamaların nasıl Rotalar API'ye taşınacağı açıklanmaktadır. Routes API hakkında ayrıntılı bilgi için ürüne genel bakış başlıklı makaleyi inceleyin.

Taşıma için faturalandırmayla ilgili en iyi uygulamalar

Bu kılavuz, API kullanımınız ikinci katman fiyatlandırmaya geçmeye yetecek kadar yüksekse geçerlidir. Bir API'nin daha yeni bir sürümüne geçiş yaparken farklı bir SKU için de faturalandırılıyorsunuz. Geçiş yaptığınız ay boyunca maliyetlerin artmasını önlemek için mümkün olduğunca ayın başına yakın bir zamanda üretimde yeni API'lere geçmenizi öneririz. Bu sayede, taşıma ayı boyunca en uygun maliyetli aylık fiyatlandırma katmanlarına ulaşabilirsiniz. Fiyatlandırma katmanları hakkında bilgi edinmek için fiyatlandırma sayfasını ve fiyatlandırmayla ilgili SSS bölümünü inceleyin.

REST API uç noktalarını güncelleme

Yeni Routes API uç noktalarını kullanacak şekilde 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

Distance Matrix API'den

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övdesi kullanacak şekilde dönüştürme

Directions API ve Distance Matrix API'de 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ği kapsamında üstbilgilerde iletirsiniz. Örnekler için:

Çoklu çizgiyle kodlanmış yol noktalarını konum yol noktalarına dönüştürme

Directions API'de, 16.384 karakterlik URL sınırına çok sayıda yol noktası sığdırmak için yol noktalarını kodlanmış çoklu çizgiler olarak belirtebilirsiniz. Yol işaretleri, REST veya gRPC istek gövdesinde enlem/boylam koordinatları olarak iletilebildiğinden bu özellik Routes API'de gerekli değildir. Örnekler için Rota matrisi hesaplama belgesindeki HTTP Örneği'ne veya Ara yol işaretleri belirtme belgesindeki Ara yol işareti tanımlama'ya bakın.

Parametreleri dönüştürme

Aşağıdaki tablolarda, Directions API ve Distance Matrix API'de yeniden adlandırılmış veya değiştirilmiş parametreler ya da GA sürümünde desteklenmeyen parametreler listelenmektedir. Bu parametrelerden herhangi birini kullanıyorsanız kodunuzu güncelleyin.

İstek parametresi dönüşümleri

Yol tarifleri 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 Compute 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, toplu taşıma rotasında, aynı seyahat moduna (ör. Yürüyüş veya Toplu Taşıma) sahip bir seyahatin her segmenti bir adım olarak kabul edilir ve bu seyahat modu için ayrı ayrı talimatlar alt adımlarda yer alır. Buna karşılık, Rotalar API'sinde adımlar tüm seyahat türlerinde tutarlı bir şekilde tek bir navigasyon talimatı olarak kullanılır. Dolayısıyla her gezinme talimatı bir adımdır. Routes API, tek bir seyahat modundaki birden fazla adım için "stepsOverview" alanında, ilgili seyahat modunun adımlarını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 units Daha fazla bilgi
waypoints intermediates Kodlanmış çoklu çizgiler desteği kaldırıldı.
optimize=true yol işaretleri için "optimizeWaypointOrder": "true" Daha fazla bilgi

Yanıt parametresi dönüşümleri

Yol tarifleri veya Mesafe matrisi parametresi Routes API parametresi Notlar
copyrights

Yanıta dahil edilmemiştir. Sonuçları kullanıcılarınıza gösterirken aşağıdaki beyanı eklemeniz gerekir:

Powered by Google, ©YEAR Google

Örneğin:

Powered by Google, ©2022 Google
distance distanceMeters Mesafe yalnızca metre cinsinden gösterilir.
duration_in_traffic duration Rotalar API'sinden kaldırılmıştır. duration değerini kullanın.
status Yok. API tarafından bildirilen hatalar için HTTP yanıt kodlarını kullanın. Daha fazla bilgi için İstek hatalarını yönetme bölümüne bakın.
geocoded_waypoints geocoding_results Yalnızca Compute rotaları için desteklenir. Yalnızca adres olarak belirtilen yol işaretleri için 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