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ıç noktası ara noktasından her hedef ara noktasına giden rotayı hesaplar. Örneğin, iki başlangıç noktası ve iki hedef 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ıç noktası ve iki varış 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 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ş varış noktası ara noktalarının sıfır tabanlı dizinini içerir. Bu, istekteki ilk başlangıç ara noktası ve ilk hedef ara 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. dizinde bulunan başlangıç ara noktasından ve 0. dizinde bulunan 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 hesaplandı.

Yanıtın rota bilgileri hakkında

API yanıtı, her dizi öğesinin bir başlangıç yol noktasından bir hedef yol noktasına giden rotayı tanımladığı bir dizi içerir. Bu öğeler, gRPC yönteminde RouteMatrixElements veya HTTP yanıtında yanıt gövdesidir.

originIndex ve destinationIndex özelliklerinin yanı sıra her öğe yalnızca söz konusu rotaya özgü temel bilgileri (ör. distanceMeters, duration ve travelAdvisory) içerir. Bir rota (ör. çoklu çizgi) hakkında daha ayrıntılı bilgi edinmek için computeRoutes simgesini kullanın.

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