Rota matrisi yanıtını inceleme

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Rota matrisi isteği, başlangıç ve hedef ara noktalarından oluşan bir diziyi giriş olarak alır. Routes API, her başlangıç ara noktasından her hedef ara noktaya 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 tane olmak üzere dört öğe içerir.

Yanıttan yararlanarak müşterilerinize farklı rota seçenekleri sunabilir ve kullanıcıların ihtiyaçlarına uygun rotayı seçmelerini sağlayabilirsiniz.

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 atlarsanız yöntemler hata döndürür.

Bu dokümandaki ö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 Döndürülecek bilgileri seçme bölümüne bakın.

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ıttaki rotayı 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ıç noktası ve giriş hedef ara noktalarının sıfır tabanlı dizinini içerir. Yani istekteki ilk başlangıç ara noktası ve ilk hedef ara noktası, 0 dizinindedir.

Örneğin, yanıttaki bir rota şunları içerir:

"originIndex": 1,
"destinationIndex": 0

Bu özellikler, rotanın giriş dizisindeki 1 dizinindeki başlangıç ara noktasından ve 0 dizinindeki 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ından ve giriş dizisindeki 1. dizinde bulunan varış noktasından hesaplandı.

Yanıttaki rota bilgileri hakkında

API yanıtı, her bir 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övdesi şeklindedir.

originIndex ve destinationIndex özelliklerinin yanı sıra her öğe yalnızca o rotaya özgü temel bilgileri (ör. distanceMeters, duration ve travelAdvisory) içerir. Bir rota hakkında daha ayrıntılı bilgi (ör. çoklu çizgi) almak 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)
    }
  }
  …
]