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övdesi 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, 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. Ö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ü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 Compute rotaları için desteklenir. |
mode |
travelMode |
|
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şı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. 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:
Örneğin:
|
|
distance |
distanceMeters |
Mesafe yalnızca metre cinsinden sunulur. |
duration_in_traffic |
duration |
Routes API'den kaldırıldı, duration politikasını kullanın. |
status |
Yok. Şunun için HTTP yanıt kodlarını kullanın: hataları gösterir. Daha fazla bilgi için İstek hatalarını yönetme 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 |
Yok. | |
legs.start_address |
Yok. | |
overview_polyline |
çoklu çizgi | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |