Rota matrisi yanıtını inceleme

Rota matrisi isteği, başlangıç ve hedef ara noktalarının dizisini giriş olarak alır. Ardından, Routes API her başlangıç noktasından her hedef 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ıç ara noktasından bir hedef ara 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ıtın her rotasını 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 durumda, istekteki ilk başlangıç noktası ve ilk hedef noktası, dizi dizini 0'da yer alır.

Örneğin, yanıttaki bir rotada şunlar yer alıyor:

"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 varış noktası 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, RouteMatrixElements gRPC yönteminde veya HTTP yanıtında yanıt gövdesinde yer alır.

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 hakkında daha ayrıntılı bilgi (ör. çoklu çizgi) edinmek için computeRoutes 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)
    }
  }
  …
]