Rota matrisi yanıtını inceleme

Rota matrisi isteği, bir başlangıç ve hedef dizisi giriş olarak alır ara hedefler. Routes API daha sonra her kaynaktan rotayı hesaplar ara nokta anlamına gelir. Örneğin, iki kaynak iki hedef ara nokta ile iki hedef ara nokta içerirse API, bu işlem için gösterir.

API yanıtı bir dizi içerir. Bu dizide her dizi öğesi bir varış noktasından bir hedef ara noktaya kadar olan rotayı ayarlayın. Bu nedenle, iki başlangıç ara noktası ve iki hedef ara nokta belirtin; yanıt dizisi , hesaplanan her rota için bir tane olmak üzere dört öğe içerir.

Yanıtı kullanarak müşterilerinize farklı rota seçenekleri sunabilirsiniz ve kullanıcının gereksinimlerine uygun rotayı seçmesine izin verin.

Alan maskeleri hakkında

Rota hesaplamak için bir yöntem çağırdığınızda bir alan belirtmelisiniz maskesi (ör. yanıtta döndürülmesini istediğiniz alanları tanımlar) Hayır varsayılan değer listesidir. Bu listeyi çıkarırsanız yöntemler hatası.

Bu dokümandaki örneklerde, yanıt nesnesinin tamamı kabul hesaba katar. Üretim ortamında yanıtınız yalnızca alan maskesinde açıkça belirttiğiniz alanları dahil edin.

Daha fazla bilgi için İade edilecek bilgileri seçme başlıklı makaleye 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ı bildirimini eklemeniz gerekir:

Powered by Google, ©YEAR Google

Örneğin:

Powered by Google, ©2023 Google

Yanıttaki rotayı belirleme

Aşağıdakileri tanımlamak için originIndex ve destinationIndex yanıt özelliklerini kullanın: her yolu gösterir. Bu mülkler aşağıdaki değerin sıfır tabanlı dizinini içerir: yol gösterir. Bu, ilk kalkış ara noktası ve ilk hedef ara nokta anlamına gelir. değeri 0 dizi dizininde yer alıyor.

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

"originIndex": 1,
"destinationIndex": 0

Bu tesisler, rotanın başlangıç noktasından hesaplandığını gösterir giriş dizisindeki dizin 1'den ve dizin 0.

Sonraki rota için:

"originIndex": 4,
"destinationIndex": 1

Rota, girişte 4. dizindeki başlangıç ara noktasından hesaplandı dizisinden ve giriş dizisindeki 1. dizindeki hedef ara noktadan alınır.

Yanıt hakkında

İlgili içeriği oluşturmak için kullanılan JSON nesnesi temsil eden, her dizi öğesinin bir dizi içerdiği bir diziyi temsil eden Bir kalkış ara noktasından bir hedef ara noktasına kadar olan rotayı tanımlar.

originIndex ve destinationIndex özellikleriyle birlikte her bir rota rotayla ilgili distanceMeters gibi bilgiler içerir, duration ve travelAdvisory.

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