Meninjau respons matriks rute

Permintaan matriks rute mengambil array titik jalan asal dan tujuan sebagai input. Kemudian Routes API akan menghitung rute dari setiap titik jalan asal ke setiap titik jalan tujuan. Misalnya, jika Anda menentukan dua titik jalan asal dan dua titik jalan tujuan, API akan menghitung empat rute yang terpisah.

Respons API berisi array, dengan setiap elemen array sesuai dengan rute dari satu titik jalan asal ke satu titik jalan tujuan. Oleh karena itu, jika Anda menentukan dua titik jalan asal dan dua titik jalan tujuan, array respons berisi empat elemen, satu untuk setiap rute yang dihitung.

Dengan respons tersebut, Anda dapat memberikan berbagai opsi rute kepada pelanggan, lalu mengizinkan pengguna memilih rute yang sesuai dengan kebutuhan mereka.

Catatan: Matriks rute tidak menampilkan informasi rute yang mendetail, seperti segmen, langkah, dan polyline rute. Untuk mendapatkan informasi rute yang mendetail, teruskan satu tempat asal dan satu tujuan ke Compute Routes.

Tentang mask kolom

Saat memanggil metode untuk menghitung rute, Anda harus menentukan mask kolom yang menentukan kolom mana yang ingin Anda tampilkan dalam respons. Tidak ada daftar default untuk kolom yang ditampilkan. Jika Anda menghapus daftar ini, metode tersebut akan menampilkan error.

Contoh dalam dokumen ini menunjukkan seluruh objek respons tanpa mempertimbangkan mask kolom. Dalam lingkungan produksi, respons Anda hanya akan menyertakan kolom yang Anda tentukan secara eksplisit di mask kolom.

Untuk mengetahui informasi selengkapnya, lihat Memilih informasi yang akan ditampilkan.

Tentang menampilkan hak cipta

Anda harus menyertakan pernyataan hak cipta berikut saat menampilkan hasil kepada pengguna:

Powered by Google, ©YEAR Google

Contoh:

Powered by Google, ©2023 Google

Identifikasi rute dalam respons

Gunakan properti respons originIndex dan destinationIndex untuk mengidentifikasi setiap rute dalam respons. Properti ini berisi indeks berbasis nol dari titik jalan origin input dan input destination yang digunakan untuk menghitung rute. Artinya titik jalan asal pertama dan titik jalan tujuan pertama dalam permintaan berada di indeks array 0.

Misalnya, rute dalam respons berisi:

"originIndex": 1,
"destinationIndex": 0

Properti ini menunjukkan bahwa rute dihitung dari titik jalan asal pada indeks 1 dalam array input, dan dari titik jalan tujuan di indeks 0.

Untuk rute berikutnya:

"originIndex": 4,
"destinationIndex": 1

Rute dihitung dari titik jalan asal di indeks 4 dalam array input, dan dari titik jalan tujuan pada indeks 1 dalam array input.

Tentang respons

Objek JSON yang mewakili respons API berisi array, dengan setiap elemen array menentukan rute dari satu titik jalan asal ke satu titik jalan tujuan.

Bersama dengan properti originIndex dan destinationIndex, setiap rute berisi informasi khusus untuk rute tersebut, seperti distanceMeters, duration, dan travelAdvisory.

Respons memiliki bentuk:

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