Menampilkan rute utama beserta rute alternatif opsional, dengan menetapkan titik jalan terminal dan perantara.
CATATAN: Metode ini mengharuskan Anda menentukan mask kolom respons dalam input. Anda dapat memberikan mask kolom respons menggunakan parameter URL $fields
atau fields
, atau dengan menggunakan header HTTP/gRPC X-Goog-FieldMask
(lihat header dan parameter URL yang tersedia. Nilainya adalah daftar jalur kolom yang dipisahkan koma. Lihat dokumentasi mendetail tentang cara membuat jalur kolom.
Misalnya, dalam metode ini:
- Mask kolom untuk semua kolom yang tersedia (untuk inspeksi manual):
X-Goog-FieldMask: *
- Mask kolom untuk durasi tingkat Rute, jarak, dan polyline (contoh penyiapan produksi):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google tidak menyarankan penggunaan mask kolom respons karakter pengganti (*
), atau menetapkan mask kolom di tingkat atas (routes
), karena:
- Memilih kolom yang Anda perlukan saja akan membantu server kami menyimpan siklus komputasi, sehingga memungkinkan kami menampilkan hasilnya kepada Anda dengan latensi yang lebih rendah.
- Memilih hanya 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 memilih semua kolom di tingkat teratas, Anda mungkin akan mengalami penurunan performa karena kolom baru yang kami tambahkan akan otomatis disertakan dalam respons.
- Memilih kolom yang Anda perlukan saja akan menghasilkan ukuran respons yang lebih kecil, sehingga throughput jaringan yang lebih tinggi.
Permintaan HTTP
POST https://routespreferred.googleapis.com/v1alpha:computeRoutes
URL menggunakan sintaksis gRPC Transcoding.
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "origin": { object ( |
Kolom | |
---|---|
origin |
Wajib. Titik jalan asal. |
destination |
Wajib. Titik jalan tujuan. |
intermediates[] |
Opsional. Kumpulan titik jalan di sepanjang rute (tidak termasuk titik terminal), untuk berhenti di atau lewat. Hingga 25 titik jalan perantara didukung. |
travelMode |
Opsional. Menentukan moda transportasi. |
routingPreference |
Opsional. Menentukan cara menghitung rute. Server mencoba menggunakan preferensi pemilihan rute yang dipilih untuk menghitung rute. Jika preferensi pemilihan rute menghasilkan error atau latensi yang lebih panjang, error akan ditampilkan. Di masa mendatang, kami mungkin menerapkan mekanisme penggantian untuk menggunakan opsi yang berbeda saat opsi yang disukai tidak memberikan hasil yang valid. Anda dapat menentukan opsi ini hanya jika |
polylineQuality |
Opsional. Menentukan preferensi Anda untuk kualitas polyline. |
polylineEncoding |
Opsional. Menentukan encoding yang lebih disukai untuk polyline. |
departureTime |
Opsional. Waktu keberangkatan. Jika Anda tidak menetapkan nilai ini, nilai ini akan ditetapkan secara default ke waktu saat Anda membuat permintaan. Jika Anda menetapkan nilai ini ke waktu yang telah terjadi, permintaan akan gagal. Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
computeAlternativeRoutes |
Menentukan apakah akan menghitung rute alternatif selain rute. |
routeModifiers |
Opsional. Kumpulan kondisi yang harus dipenuhi yang memengaruhi cara penghitungan rute. |
languageCode |
Opsional. Kode bahasa BCP-47, seperti "en-US" atau "sr-Latn". Untuk informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Lihat Dukungan Bahasa untuk melihat daftar bahasa yang didukung. Jika Anda tidak memberikan nilai ini, bahasa tampilan akan disimpulkan dari lokasi permintaan rute. |
units |
Opsional. Menentukan satuan ukuran untuk kolom tampilan. Ini mencakup kolom |
optimizeWaypointOrder |
Jika OptimizeWaypointOrder disetel ke true, upaya dilakukan untuk mengurutkan ulang titik jalan perantara yang ditentukan untuk meminimalkan biaya keseluruhan rute. Jika ada titik jalan perantara melalui titik jalan, permintaan akan gagal. Gunakan ComputeRoutesResponse.Routes.". Jika routes.optimize_intermediate_ memutuskan_titik jalan_ tidak diminta dalam header |
Isi respons
Jika berhasil, isi respons memuat instance ComputeRoutesResponse
.
Cakupan Otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/maps-platform.routespreferred
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.