Rota matrisi isteği, bir başlangıç ve hedef dizisi giriş olarak alır ara hedefler. Routes API, her kaynaktan rotayı hesaplar her bir hedef ara noktasına giden bir ara nokta anlamına gelir. Örneğin, iki kaynak iki hedef ara nokta ile iki hedef ara nokta içerirse API, bu işlem için gösterir.
API yanıtı bir dizi içerir. Bu dizide her dizi öğesi bir varış noktasından bir hedef ara noktaya kadar olan rotayı ayarlayın. Bu nedenle, iki başlangıç ara noktası ve iki hedef ara nokta belirtin; yanıt dizisi , hesaplanan her rota için bir tane olmak üzere dört öğe içerir.
Yanıtı kullanarak müşterilerinize farklı rota seçenekleri sunabilirsiniz ve kullanıcının gereksinimlerine uygun rotayı seçmesine izin verin.
Alan maskeleri hakkında
Rota hesaplamak için bir yöntem çağırdığınızda bir alan belirtmelisiniz maskesi (ör. yanıtta döndürülmesini istediğiniz alanları tanımlar) Hayır, varsayılan değer listesidir. Bu listeyi çıkarırsanız yöntemler hatası.
Bu belgedeki örneklerde, alan maskeleri dikkate alınmadan yanıt nesnesinin tamamı gösterilmektedir. Üretim ortamında yanıtınız yalnızca alan maskesinde açıkça belirttiğiniz alanları dahil edin.
Daha fazla bilgi için İade edilecek bilgileri seçme başlıklı makaleye bakın.
Telif haklarını görüntüleme hakkında
Sonuçları kullanıcılarınıza görüntülerken aşağıdaki telif hakkı bildirimini eklemeniz gerekir:
Powered by Google, ©YEAR Google
Örneğin:
Powered by Google, ©2023 Google
Yanıttaki rotayı belirleme
Aşağıdakileri tanımlamak için originIndex
ve destinationIndex
yanıt özelliklerini kullanın:
her yolu gösterir. Bu mülkler aşağıdaki değerin sıfır tabanlı dizinini içerir:
yol gösterir. Bu, ilk kalkış ara noktası ve ilk hedef ara nokta anlamına gelir.
değeri 0 dizi dizininde yer alıyor.
Örneğin, yanıttaki bir rota şunları içeriyor:
"originIndex": 1, "destinationIndex": 0
Bu tesisler, rotanın başlangıç noktasından hesaplandığını gösterir giriş dizisindeki dizin 1'den ve dizin 0.
Sonraki rota için:
"originIndex": 4, "destinationIndex": 1
Rota, girişte 4. dizindeki başlangıç ara noktasından hesaplandı dizisinden ve giriş dizisindeki 1. dizindeki hedef ara noktadan alınır.
Yanıt hakkında
İlgili içeriği oluşturmak için kullanılan JSON nesnesi temsil eden, her dizi öğesinin bir dizi içerdiği bir diziyi temsil eden Bir kalkış ara noktasından bir hedef ara noktasına kadar olan rotayı tanımlar.
originIndex
ve destinationIndex
özellikleriyle birlikte her bir rota
rotayla ilgili distanceMeters
gibi bilgiler içerir,
duration
ve travelAdvisory
.
Yanıt şu biçimdedir:
[ // One array element for each combination of origin and destination waypoints. { // The route for source waypoint 0 and destination waypoint 0. "originIndex": 0, "destinationIndex": 0, "status": { object (Status) }, "condition": enum (RouteMatrixElementCondition), "distanceMeters": integer, "duration": string, "staticDuration": string, "travelAdvisory": { object (RouteTravelAdvisory) }, "fallbackInfo": { object (FallbackInfo) } } { // The route for source waypoint 0 and destination waypoint 1. "originIndex": 0, "destinationIndex": 1, "status": { object (Status) }, "condition": enum (RouteMatrixElementCondition), "distanceMeters": integer, "duration": string, "staticDuration": string, "travelAdvisory": { object (RouteTravelAdvisory) }, "fallbackInfo": { object (FallbackInfo) } } … ]