Rota matrisi isteği, bir başlangıç ve hedef ara noktalar dizisi girdi olarak alır. Ardından Routes API, her bir başlangıç yol işaretinden her bir hedef yol işaretine giden rotayı hesaplar. Örneğin, iki kaynak yol noktası ve iki hedef yol noktası 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. Bu nedenle, iki başlangıç ve iki hedef yol noktası belirtirseniz yanıt dizisi, her hesaplanan rota için birer 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
Bir rotayı hesaplamak için bir yöntemi çağırırken, yanıtta döndürülmesini istediğiniz alanları tanımlayan bir alan maskesi belirtmeniz gerekir. Döndürülen alanların varsayılan listesi yoktur. Bu listeyi atlarsanız yöntemler hata döndürür.
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ı içerir.
Daha fazla bilgi için Geri döndürülecek bilgileri seçme başlıklı makaleyi inceleyin.
Telif hakkı bilgilerini gösterme hakkında
Sonuçları kullanıcılarınıza gösterirken aşağıdaki telif hakkı beyanını eklemeniz gerekir:
Powered by Google, ©YEAR Google
Örneğin:
Powered by Google, ©2023 Google
Yanıtta rotayı tanımlama
Yanıttaki her 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. Yani istekteki ilk başlangıç yol noktası ve ilk hedef yol noktası, dizi dizini 0'dadır.
Örneğin, yanıttaki bir rota şunları içerir:
"originIndex": 1, "destinationIndex": 0
Bu özellikler, rotanın giriş dizisindeki 1. dizinde bulunan başlangıç yol işaretinden ve 0. dizinde bulunan hedef yol işaretinden hesaplandığını gösterir.
Sonraki rota için:
"originIndex": 4, "destinationIndex": 1
Rota, giriş dizisindeki 4. dizinde bulunan başlangıç yol işaretinden ve giriş dizisindeki 1. dizinde bulunan hedef yol işaretinden hesaplanmıştır.
Yanıt hakkında
API yanıtını temsil eden JSON nesnesi, her bir dizi öğesinin bir başlangıç yol işaretinden bir hedef yol işaretine giden rotayı tanımladığı bir dizi içerir.
Her rota, originIndex ve destinationIndex özelliklerinin yanı sıra distanceMeters, duration ve travelAdvisory gibi o rotaya özgü 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)
}
}
…
]