Rota matrisi isteği, giriş olarak bir başlangıç ve hedef ara nokta dizisi alır. Daha sonra Routes API, her bir başlangıç ara noktasından her hedef ara noktaya kadar olan rotayı hesaplar. Örneğin, iki başlangıç ara noktası ve iki hedef ara nokta belirtirseniz API, dört ayrı rota hesaplar.
API yanıtı bir dizi içerir. Bu dizide her dizi öğesi, bir başlangıç ara noktasından bir hedef ara noktaya gelen rotaya karşılık gelir. Bu nedenle, iki başlangıç ara noktası ve iki hedef ara nokta belirtirseniz yanıt dizisi, hesaplanan her rota için bir tane olacak şekilde dört öğe içerir.
Yanıtı kullanarak müşterilerinize farklı rota seçenekleri sunabilir ve ardından kullanıcının gereksinimlerine 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östermektedir. Bir üretim ortamında, yanıtınız yalnızca alan maskesinde açıkça belirttiğiniz alanları içerir.
Daha fazla bilgi için Döndürülecek bilgileri seçme bölümüne 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ı beyanını 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 girişinin sıfır tabanlı dizinini ve giriş hedef ara noktalarını içerir. Bu, istekteki ilk başlangıç ara noktasının ve ilk hedef ara noktasının 0. dizi dizininde olduğu anlamına gelir.
Örneğin, yanıttaki bir rota şunları içerir:
"originIndex": 1, "destinationIndex": 0
Bu özellikler, rotanın giriş dizisindeki 1. dizindeki başlangıç ara noktasından ve dizin 0'daki hedef ara noktadan hesaplandığını gösterir.
Sonraki rotada:
"originIndex": 4, "destinationIndex": 1
Rota, giriş dizisindeki 4. dizindeki başlangıç ara noktasından ve giriş dizisindeki 1. dizindeki hedef ara noktadan hesaplandı.
Yanıt hakkında
API yanıtını temsil eden JSON nesnesi bir dizi içerir. Bu dizide, her dizi öğesi bir başlangıç ara noktasından bir hedef ara noktaya kadar rotayı tanımlar.
originIndex ve destinationIndex mülklerinin yanı sıra her rota, rotaya özel distanceMeters, duration ve travelAdvisory gibi bilgiler içerir.
Yanıtın biçimi şu şekildedir:
[
// 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)
}
}
…
]