computeRouteMatrix yöntemini (REST) veya akış ComputeRouteMatrix yöntemini (gRPC) çağırarak birden fazla kaynak ve hedef için bir rotanın mesafesini ve süresini hesaplamak üzere Routes API'yi kullanın.
Kalkış ve varış noktalarının listelendiği bu yöntem, her kalkışta başlayıp her hedefte sona eren bir rotanın mesafesini ve süresini hesaplar.
Toplu taşıma rotası matrisi alma
Toplu taşıma sırasında bir rota matrisi de hesaplayabilirsiniz. Bir örnek için Toplu taşımayla ilgili rota matrisi alma konusuna bakın.
İstek sınırları
Compute Rota Matrisi yöntemleri, adres veya yer kimlikleri kullanan ara noktalar ve öğeler için aşağıdaki istek sınırlarını uygular. Öğeler, bir rota matrisindeki her bir kalkış ve varış noktası arasındaki rotalardır. Bu nedenle, öğe sayısı, başlangıç noktası sayısı ile hedef sayısının çarpımıyla eşittir. Örneğin, 10 kökeniniz ve 10 hedefiniz varsa 100 öğeniz olur:
TRANSIT
rotası olmayan rotalar için öğe sayısı 625'i aşamaz.TRANSIT
rota belirtirseniz öğe sayısı 100'den fazla olamaz.TRAFFIC_AWARE_OPTIMAL
değerini belirtirseniz öğe sayısı 100'ü aşamaz.TRAFFIC_AWARE_OPTIMAL
hakkında daha fazla bilgi için Trafik verilerinin nasıl eklenip eklenmeyeceğini belirtme bölümüne bakın.Adres veya yer kimliğini kullanarak kalkış ve varış noktaları belirtirseniz bu şekilde toplamda en fazla 50 tane belirtebilirsiniz.
Yanıt hataları
İşlem Rotası Matrisi yöntemlerinin bir özelliği, hataların yanıtın tamamı veya bağımsız yanıt öğeleri için döndürülebilmesidir. Örneğin, isteğin bozuk olması (örneğin, sıfır kaynağı varsa) yanıtın tamamında hata bulunur.
Bununla birlikte, yanıttaki öğelerin bir alt kümesi için hata geçerliyse (örneğin, tek bir kaynak ve hedef kombinasyonu için rota hesaplanamaz) yalnızca hatadan etkilenen öğeler hata kodu döndürür.
gRPC Akış sonuçları
ComputeRouteMatrix gRPC yöntemi, bir başlangıç ve hedef listesi alır ve her başlangıç ve hedef kombinasyonu için rota bilgilerini içeren bir akış döndürür. Sonuçlar akış olarak döndürüldüğünden, sonuçları işlemeye başlamadan önce olası tüm rota kombinasyonlarının hesaplanmasını beklemeniz gerekmez.
Akış tarafından döndürülen öğelerin herhangi bir sırada döndürüleceği garanti edilmez. Dolayısıyla, her yanıt öğesi bir origin_index
ve bir destination_index
içerir. İstek tarafından belirtilen başlangıç noktaları ve hedefler için rota kaynağı, belirli bir öğe için origins[origin_index]
ile eşdeğerdir ve rota hedefi destinations[destination_index]
ile eşdeğerdir.
Bu diziler sıfır dizine sahiptir. Kalkış ve hedef listelerindeki
siparişlerin saklanması önemlidir.
Rota Matrisi Örnekleri Hesaplama
Rota matrisi hesaplamak için HTTP isteğinde computeRouteMatrix yöntemini kullanın.
HTTP örneği
Aşağıdaki örnekte bir computeRouteMatrix
HTTP isteği gösterilmektedir. Bu örnekte siz:
İki başlangıç noktası ve iki hedef ara nokta içeren bir dizi belirtin. Yöntem, her kalkış noktasından her hedefe giden rotayı hesaplar. Böylece yanıt dört rota içerir.
Dizide, ilk öğe 0 dizininde, ikincisi dizin 1'dedir ve bu şekilde devam eder.
Hangi yanıt (REST) veya ComputeRoutesResponse (gRPC) alanlarının döndürüleceğini belirtmek için bir yanıt alanı maskesi ekleyin. Bu örnekte, isteği her bir rota için
originIndex
,destinationIndex
,duration
,distanceMeters
,status
vecondition
döndürülecek şekilde yapılandırın. Daha fazla bilgi için Döndürülecek alanları seçme bölümüne bakın.
curl -X POST -d '{ "origins": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420761, "longitude": -122.081356 } } }, "routeModifiers": { "avoid_ferries": true} }, { "waypoint": { "location": { "latLng": { "latitude": 37.403184, "longitude": -122.097371 } } }, "routeModifiers": { "avoid_ferries": true} } ], "destinations": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420999, "longitude": -122.086894 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.383047, "longitude": -122.044651 } } } } ], "travelMode": "DRIVE", "routingPreference": "TRAFFIC_AWARE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \ 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
Yanıt, tüm kalkış ve varış ara noktalarının kombinasyonu için dört olası rota içerir.
originIndex
ve destinationIndex
yanıt alanlarını kullanarak yanıttaki her bir rotayı tanımlayın. Örneğin, yanıttaki originIndex
değeri 1, istekteki origins
dizisindeki 1. dizinde ara noktadan hesaplanan bir rotaya karşılık gelir.
[ { "originIndex": 0, "destinationIndex": 0, "status": {}, "distanceMeters": 822, "duration": "160s", "condition": "ROUTE_EXISTS" }, { "originIndex": 1, "destinationIndex": 0, "status": {}, "distanceMeters": 2919, "duration": "361s", "condition": "ROUTE_EXISTS" }, { "originIndex": 1, "destinationIndex": 1, "status": {}, "distanceMeters": 5598, "duration": "402s", "condition": "ROUTE_EXISTS" }, { "originIndex": 0, "destinationIndex": 1, "status": {}, "distanceMeters": 7259, "duration": "712s", "condition": "ROUTE_EXISTS" } ]
gRPC örnekleri
Örneğin gRPC istekleri için Örnek gRPC isteği ile ilgili örneklere bakın. Bu sayfadaki Java örneğinde hem İşlem Rotaları hem de İşlem Rotası Matrisi'ni çağırır.