Bu kılavuzda, Directions API veya Uzaklık Matrisi API'sini kullanan uygulamaların, Routes API'den nasıl yararlanılacağı açıklanmaktadır. Routes API ile ilgili ayrıntılar için ürüne genel bakış sayfasına göz atı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 |
Rotalar API'si | https://routes.googleapis.com/directions/v2:computeRoutes |
Uzaklık Matrisi API'sinden
Distance Matrix API | https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters |
Rotalar API'si | 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'si ile yapılandırma özelliklerini bir HTTP GET
isteğine URL parametreleri olarak eklersiniz. Ö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 HTTP POST
isteğinin parçası olarak aktarabilirsiniz. Örnekler için aşağıdaki sayfaları inceleyin:
Çoklu çizgi kodlu ara noktaları konum ara noktalarına dönüştürme
16.384 karakterlik URL sınırına çok sayıda ara nokta sığdırmak için, ara noktaları kodlanmış çoklu çizgi olarak belirtme Directions API'sinde bulunmaktadır. Ara noktalar, REST veya gRPC istek gövdesinde enlem/boylam koordinatları olarak iletilebileceği için Routes API'de bu özelliğin kullanılması gerekmez. Örnekler için Rota matrisi hesaplama belgesindeki HTTP Örneği bölümüne veya Ara referans noktaları belirleme belgesindeki Ara ara referans noktası tanımlama bölümüne bakın.
Parametreleri dönüştürme
Aşağıdaki tablolarda, Directions API'de ve Uzaklık Matrisi API'sinde bulunan ve yeniden adlandırılmış veya değiştirilmiş 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 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, aynı ulaşım şekline (ör. Yaya veya Toplu Taşıma) sahip her bir seyahat segmenti tek bir adım olarak kabul edilir ve bu ulaşım şekliyle ilgili ayrı yol tarifleri de alt adımlar halinde verilir. Buna karşılık, Routes API'deki adımlar tüm seyahat türlerinde tutarlı bir şekilde tek bir navigasyon talimatıdır. Yani her navigasyon talimatı bir adımdır. Bir ulaşım modunda birden fazla adım için Routes API, "stepsOverview" bölümünde ilgili seyahat modu 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 |
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 edilmedi. Sonuçları kullanıcılarınıza gösterirken aşağıdaki ifadeyi eklemeniz gerekir:
Örneğin:
|
|
distance |
distanceMeters |
Mesafe yalnızca metre olarak mevcuttur. |
duration_in_traffic |
duration |
Routes API'de kaldırıldı, duration alanını 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 noktalar için 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 |