Permintaan matriks rute mengambil array asal dan tujuan sebagai input titik jalan. Routes API kemudian menghitung rute dari setiap tempat asal titik jalan ke setiap titik jalan tujuan. Misalnya, jika Anda menentukan dua sumber titik jalan dan dua titik jalan tujuan, API lalu menghitung empat titik jalan rute perjalanan.
Respons API berisi sebuah 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, susunan respons berisi empat elemen, satu untuk setiap rute yang dihitung.
Dengan menggunakan respons tersebut, Anda dapat memberikan opsi rute yang berbeda kepada pelanggan dan kemudian membiarkan pengguna memilih rute yang sesuai untuk kebutuhan mereka.
Tentang mask kolom
Saat memanggil metode untuk menghitung rute, Anda harus menetapkan kolom mask yang menentukan kolom mana yang ingin Anda tampilkan dalam respons. Tidak ada daftar default kolom yang ditampilkan. Jika Anda menghilangkan daftar ini, metode akan menampilkan sebuah {i>error<i}.
Contoh dalam dokumen ini menampilkan seluruh objek respons tanpa melalui {i>field mask<i} menjadi pertimbangan pengguna. Dalam lingkungan produksi, respons Anda akan hanya sertakan kolom yang Anda tentukan secara eksplisit dalam mask kolom.
Untuk informasi selengkapnya, lihat Memilih informasi yang ingin ditampilkan.
Tentang menampilkan hak cipta
Anda harus menyertakan pernyataan hak cipta berikut saat menampilkan hasilnya kepada pengguna Anda:
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 perjalanan. Itu berarti titik jalan asal pertama dan titik jalan tujuan pertama
dalam permintaan berada pada indeks array 0.
Misalnya, rute dalam respons berisi:
"originIndex": 1, "destinationIndex": 0
Properti ini menunjukkan bahwa rute dihitung dari tempat asal titik jalan 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 pada indeks 4 pada input array, dan dari titik jalan tujuan di indeks 1 dalam array input.
Tentang respons
Tujuan Objek JSON yang mewakili respons API berisi sebuah array, dengan setiap elemen array mendefinisikan 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 berupa:
[ // 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) } } … ]