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övdesini 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,
ö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. Örneğin, bkz. HTTP Örneği Rota matrisi hesaplama dokümanında yer alan Ara bir ara nokta belirleyin Ara ara noktaları belirtme dokümanını inceleyin.
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 İşlem 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 her bir bir seyahat segmenti (ör. Yaya veya Transit) tek bir adım, sonraki seyahat için de tek tek yol tarifi olarak kabul edilir olduğunu da görebilirsiniz. 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 kullanabilirsiniz. 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'de kaldırıldı, duration kullanın. |
status |
Yok. Şunun için HTTP yanıt kodlarını kullanın: hataları gösterir. İstek hatalarını işleme bölümüne bakın. konulu videomuzu izleyin. | |
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 |