Rota matrisi isteği, bir başlangıç ve hedef ara noktalar dizisi girdi olarak alır. Daha sonra Routes API, her kaynak ara noktasından her bir hedef ara noktasına kadar olan rotayı hesaplar. Örneğin, iki başlangıç noktası ve iki hedef ara nokta belirtirseniz API, dört ayrı rota hesaplar.
API yanıtı bir dizi içerir. Bu dizi öğesi, bir kaynak ara noktasından bir hedef ara noktasına kadar olan rotaya karşılık gelir. Dolayısıyla, iki başlangıç noktası ve iki hedef ara nokta belirtirseniz 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 sunabilir ve ardından kullanıcının ihtiyaçlarına uygun rotayı seçmesine izin verebilirsiniz.
Alan maskeleri hakkında
Rota hesaplamak için bir yöntem çağırdığınızda, yanıtta döndürülmesini istediğiniz alanları tanımlayan bir alan maskesi belirtmeniz gerekir. Döndürülen alanların varsayılan bir listesi yoktur. Bu listeyi çıkarırsanız yöntemler hata döndürür.
Bu belgedeki örnekler, alan maskeleri dikkate alınmadan yanıt nesnesinin tamamını gösterir. Üretim ortamında yanıtınız yalnızca alan maskesinde açıkça belirttiğiniz alanları içerir.
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
Yanıttaki her bir rotayı tanımlamak için originIndex ve destinationIndex yanıt özelliklerini kullanın. Bu özellikler, rotayı hesaplamak için kullanılan origin girdisinin sıfır tabanlı dizinini ve giriş destination ara noktalarını içerir. Bu, istekteki ilk başlangıç ara noktası ve ilk hedef ara noktasının dizi dizini 0'da olduğu anlamına gelir.
Örneğin, yanıttaki bir rota şunları içeriyor:
"originIndex": 1, "destinationIndex": 0
Bu özellikler, rotanın giriş dizisindeki dizin 1'deki kaynak ara noktasından ve dizin 0'daki hedef ara noktasından hesaplandığını gösterir.
Sonraki rota için:
"originIndex": 4, "destinationIndex": 1
Rota, giriş dizisindeki indeks 4'teki başlangıç noktası ara noktasından ve giriş dizisindeki indeks 1'deki hedef ara noktasından hesaplanmıştır.
Yanıt hakkında
API yanıtını temsil eden JSON nesnesi bir dizi içerir. Bu dizide her dizi öğesi, bir kaynak ara noktasından bir hedef ara noktasına giden yolu tanımlar.
Her rota, originIndex ve destinationIndex özelliklerinin yanı sıra söz konusu rotaya özel distanceMeters, duration ve travelAdvisory gibi bilgiler içerir.
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)
}
}
…
]