Mencatat daftar tempat asal dan tujuan, serta menampilkan aliran data yang berisi informasi rute untuk setiap kombinasi tempat asal dan tujuan.
CATATAN: Metode ini mengharuskan Anda menentukan mask kolom respons di input. Anda dapat memberikan mask kolom respons dengan menggunakan parameter URL $fields
atau fields
, atau dengan menggunakan header HTTP/gRPC X-Goog-FieldMask
(lihat parameter dan header URL yang tersedia. Nilainya adalah daftar jalur kolom yang dipisahkan koma. Lihat dokumentasi mendetail ini tentang cara membuat jalur kolom.
Misalnya, dalam metode ini:
- Mask kolom dari semua kolom yang tersedia (untuk pemeriksaan manual):
X-Goog-FieldMask: *
- Mask kolom untuk durasi rute, jarak, status elemen, kondisi, dan indeks elemen (contoh penyiapan produksi):
X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration
Anda harus menyertakan status
di mask kolom, karena jika tidak, semua pesan akan terlihat baik-baik saja. Google tidak menyarankan penggunaan mask kolom respons karakter pengganti (*
), karena:
- Memilih kolom yang Anda perlukan akan membantu server kami menyimpan siklus komputasi, sehingga kami dapat menampilkan hasilnya kepada Anda dengan latensi yang lebih rendah.
- Memilih kolom yang Anda perlukan dalam tugas produksi akan memastikan performa latensi yang stabil. Kami mungkin menambahkan lebih banyak kolom respons di masa mendatang, dan kolom baru tersebut mungkin memerlukan waktu komputasi tambahan. Jika Anda memilih semua kolom, atau jika Anda memilih semua kolom di tingkat teratas, Anda mungkin mengalami penurunan performa karena kolom baru yang kami tambahkan akan otomatis disertakan dalam respons.
- Hanya memilih kolom yang dibutuhkan akan menghasilkan ukuran respons yang lebih kecil, sehingga throughput jaringan yang lebih tinggi.
Permintaan HTTP
POST https://routespreferred.googleapis.com/v1:computeRouteMatrix
URL menggunakan sintaksis gRPC Transcoding.
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "origins": [ { object ( |
Kolom | |
---|---|
origins[] |
Wajib. Array asal, yang menentukan baris matriks respons. Beberapa batasan ukuran berlaku pada kardinalitas asal dan tujuan:
|
destinations[] |
Wajib. Array tujuan, yang menentukan kolom matriks respons. |
travelMode |
Opsional. Menentukan moda transportasi. |
routingPreference |
Opsional. Menentukan cara menghitung rute. Server mencoba menggunakan preferensi perutean yang dipilih untuk menghitung rute. Jika preferensi pemilihan rute menghasilkan error atau latensi tambahan yang panjang, error akan ditampilkan. Di masa mendatang, kami mungkin akan menerapkan mekanisme penggantian untuk menggunakan opsi yang berbeda saat opsi yang dipilih tidak memberikan hasil yang valid. Anda dapat menentukan opsi ini hanya jika |
departureTime |
Opsional. Waktu keberangkatan. Jika Anda tidak menetapkan nilai ini, waktu default akan disetel ke waktu saat Anda membuat permintaan. Jika Anda menetapkan nilai ini ke waktu yang telah terjadi, permintaan akan gagal. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
Isi respons
Jika berhasil, isi respons akan berisi instance RouteMatrixElement
.
Cakupan Otorisasi
Memerlukan cakupan OAuth berikut ini:
https://www.googleapis.com/auth/maps-platform.routespreferred
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.