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 |
|
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:
Örneğin:
|
|
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 |