Preferensi lalu lintas yang Anda pilih menyeimbangkan keakuratan detail rute terkait performa permintaan. Ketika Anda membuat permintaan, Anda ingin mempertimbangkan apakah permintaan itu lebih baik menampilkan hasil seakurat mungkin, atau secepat mungkin. Routes API menyediakan opsi yang memungkinkan Anda mengontrol kualitas data respons vs latensi respons.
Menetapkan tingkat data traffic
Routes API menyediakan RoutingPreference (REST) dan RoutingPreference (gRPC) yang memungkinkan Anda menentukan preferensi pemilihan rute untuk menghitung rute. Preferensi ini berbeda dalam hal sejauh mana kondisi lalu lintas diperhitungkan dalam penghitungan rute. Setiap preferensi pemilihan rute menghasilkan hasil yang berbeda-beda terkait kualitas rute, estimasi ETA, dan latensi respons.
Kondisi lalu lintas mencirikan kecepatan aliran lalu lintas. Contoh:
- Jika tidak ada kemacetan, kondisi lalu lintas dianggap normal, dan arus lalu lintas mengalir dengan kecepatan normal tanpa hambatan.
- Menjelang jam sibuk, kepadatan lalu lintas meningkat, yang menyebabkan lalu lintas melambat, sehingga menghasilkan kondisi lalu lintas ringan hingga sedang.
- Dalam lalu lintas bumper ke bumper, laju aliran berhenti, dan menghasilkan kondisi lalu lintas.
Tidak sadar traffic
Jika Anda menetapkan preferensi pemilihan rute TRAFFIC_UNAWARE
, rute akan dihitung
tanpa memperhitungkan kondisi lalu lintas saat ini. Preferensi pemilihan rute ini
memberikan latensi respons terendah (respons ditampilkan dengan cepat).
TRAFFIC_UNAWARE
adalah setelan default.
Dalam respons:
PWT dimuat dalam properti respons
duration
.Properti respons
duration
danstaticDuration
berisi hal yang sama dengan sejumlah nilai.
Gunakan preferensi pemilihan rute ini jika Anda ingin respons ditampilkan dengan cepat, dan detail pemilihan rute perkiraan sudah cukup baik.
Memahami traffic
Jika Anda menetapkan preferensi pemilihan rute TRAFFIC_AWARE
, rute akan dihitung
memperhitungkan kondisi
lalu lintas saat ini. Akibatnya, rute dan detail rute
lebih akurat mencerminkan kondisi dunia nyata. Karena peningkatan jumlah
kualitas data mengorbankan latensi respons, mengoptimalkan performa
diterapkan untuk mengurangi banyak latensi.
Dalam respons:
Perkiraan waktu tiba (ETA) yang mempertimbangkan traffic real-time terdapat dalam properti respons
duration
.Properti respons
staticDuration
berisi durasi perjalanan sepanjang rute tanpa mempertimbangkan kondisi lalu lintas.
Gunakan preferensi {i>routing<i} ini ketika Anda menginginkan
detail {i>routing<i} yang lebih akurat daripada
TRAFFIC_UNAWARE
, tetapi Anda tidak keberatan jika respons ditampilkan dengan
peningkatan latensi sedang.
Sadar traffic optimal
Jika Anda menetapkan preferensi pemilihan rute TRAFFIC_AWARE_OPTIMAL
, rute akan
dihitung dengan mempertimbangkan kondisi lalu lintas saat ini, tetapi tidak ada performa
pengoptimalan akan diterapkan. Dalam mode ini, server melakukan analisis
mencari jaringan jalan untuk menemukan rute yang optimal.
Preferensi perutean TRAFFIC_AWARE_OPTIMAL
setara dengan mode yang digunakan oleh
maps.google.com dan melalui
Aplikasi seluler Google Maps.
Saat menggunakan opsi ini dengan Compute Route Matrix, jumlah elemen dalam permintaan (jumlah asal × jumlah tujuan) tidak boleh melebihi 100. Untuk informasi selengkapnya tentang batas Compute Route Matrix, lihat Hitung matriks rute.
Dalam respons:
Perkiraan waktu tiba (ETA) yang mempertimbangkan traffic real-time terdapat dalam properti respons
duration
.Properti respons
staticDuration
berisi durasi perjalanan sepanjang rute tanpa mempertimbangkan kondisi lalu lintas.
Preferensi perutean ini memberikan latensi respons tertinggi (yaitu, respons akan kembali dengan penundaan terlama). Gunakan preferensi pemilihan rute ini jika Anda ingin hasil dengan kualitas tertinggi, tanpa mempertimbangkan berapa lama respons diperlukan.
Pengaruh setelan waktu keberangkatan
Secara opsional, Anda dapat menggunakan properti departureTime
untuk menetapkan waktu keberangkatan untuk
berkemah. Jika Anda tidak menetapkan properti departureTime
, properti tersebut akan ditetapkan secara default ke
waktu Anda membuat permintaan.
Untuk
TRAFFIC_UNAWARE
, Anda tidak dapat menetapkandepartureTime
karena pilihan rute dan durasi didasarkan pada jaringan jalan dan kondisi lalu lintas rata-rata tanpa memperhitungkan waktu.Untuk
TRAFFIC_AWARE
danTRAFFIC_AWARE_OPTIMAL
, yang menampilkan lalu lintas live tertentu, traffic langsung menjadi makin penting. semakin dekatdepartureTime
ke waktu sekarang. Semakin jauh Anda menetapkan waktu keberangkatan di masa mendatang, semakin banyak pertimbangan yang diberikan pada lalu lintas historis kondisi tertentu.
Contoh setelan preferensi pemilihan rute
Kode JSON berikut menunjukkan cara menetapkan preferensi pemilihan rute dalam isi entitas pesan permintaan.
{ "origin":{ "location":{ "latLng":{ "latitude":37.419734, "longitude":-122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude":37.417670, "longitude":-122.079595 } } }, "travelMode":"DRIVE", "routingPreference":"TRAFFIC_AWARE_OPTIMAL" }
Mengonfigurasi traffic pada polyline
Routes API memungkinkan Anda meminta informasi tentang kondisi lalu lintas di sepanjang polyline berbasis traffic. Lihat Minta polyline untuk mengetahui informasi selengkapnya.