Rota matrisi yanıtını inceleme

Rota matrisi isteği, giriş olarak başlangıç ve hedef ara noktalarının bir dizisini alır. Ardından, Routes API her başlangıç ara noktasından her hedef ara noktasına giden rotayı hesaplar. Örneğin, iki başlangıç ara noktası ve iki hedef ara noktası belirtirseniz API dört ayrı rota hesaplar.

API yanıtı, her dizi öğesinin bir başlangıç yol noktasından bir hedef yol noktasına giden rotaya karşılık geldiği bir dizi içerir. Bu nedenle, iki başlangıç ara noktası ve iki hedef ara noktası belirtirseniz yanıt dizisi, hesaplanan her rota için bir öğe 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ğırdığınızda, yanıtta hangi alanların döndürülmesini istediğinizi tanımlayan bir alan maskesi belirtmeniz gerekir. Döndürülen alanların varsayılan bir 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 Hangi bilgilerin döndürüleceğini seçme başlıklı makaleyi inceleyin.

Telif haklarını 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ıtın rotasını belirleme

Yanıttaki her rotayı tanımlamak için originIndex ve destinationIndex yanıt özelliklerini kullanın. Bu özellikler, rotayı hesaplamak için kullanılan giriş başlangıç ve giriş hedef ara noktalarının sıfır tabanlı dizinini içerir. Bu, istekteki ilk başlangıç noktası ve ilk hedef noktasının dizi dizininde 0 olduğu anlamına gelir.

Örneğin, yanıttaki bir rotada şunlar bulunur:

"originIndex": 1,
"destinationIndex": 0

Bu özellikler, rotanın giriş dizisindeki 1. dizindeki başlangıç ara noktasından ve 0. dizindeki hedef ara noktasından hesaplandığını gösterir.

Sonraki rota için:

"originIndex": 4,
"destinationIndex": 1

Rota, giriş dizisindeki 4. dizinde bulunan başlangıç noktası ara noktasından ve giriş dizisindeki 1. dizinde bulunan hedef ara noktasından hesaplanmıştır.

Yanıt hakkında

API yanıtını temsil eden JSON nesnesi bir dizi içerir. Dizideki her öğe, bir başlangıç yol noktasından bir hedef yol noktasına giden rotayı tanımlar.

originIndex ve destinationIndex özelliklerinin yanı sıra her rotada distanceMeters, duration ve travelAdvisory gibi rotaya özgü bilgiler bulunur.

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)
    }
  }
  …
]