Preferensi traffic yang Anda pilih menyeimbangkan akurasi detail rute dengan performa permintaan dengan salah satu dari dua cara:
Traffic aware -- Menampilkan hasil yang paling akurat (latensi yang lebih tinggi).
Tidak mempertimbangkan traffic -- Menampilkan hasil secepat mungkin (latensi terendah).
Saat Anda membuat permintaan, pertimbangkan apakah lebih baik menampilkan hasil yang paling akurat, atau menampilkan hasil secepat mungkin. Routes API menyediakan opsi yang memungkinkan Anda mengontrol kualitas data respons dibandingkan latensi respons.
Cara menetapkan tingkat traffic
Routes API menyediakan RoutingPreference (REST) dan RoutingPreference (gRPC) yang memungkinkan Anda menentukan preferensi pemilihan rute untuk menghitung rute.
Setelan defaultnya adalah hasil yang tidak mengetahui traffic. Anda memilih opsi traffic dengan
preferensi pemilihan rute
TRAFFIC_UNAWARE
, TRAFFIC_AWARE
, dan TRAFFIC_AWARE_OPTIMAL
. Setiap preferensi pemilihan rute menghasilkan hasil yang berbeda dalam kualitas rute, perkiraan waktu tiba, dan latensi respons.
Kondisi lalu lintas
Kondisi lalu lintas mencirikan kecepatan aliran traffic:
Lalu lintas normal: Tidak ada kemacetan dengan lalu lintas yang mengalir dengan kecepatan normal.
Traffic ringan hingga sedang: Kemacetan meningkat, dengan traffic yang mengalir dengan kecepatan yang berkurang.
Lalu lintas padat: Kemacetan parah, dengan kecepatan lalu lintas yang sangat berkurang.
Tidak mengetahui traffic
TRAFFIC_UNAWARE
adalah setelan default. Gunakan preferensi pemilihan rute ini jika Anda
ingin respons ditampilkan dengan cepat, dan perkiraan detail pemilihan rute sudah cukup baik.
Rute TRAFFIC_UNAWARE
dihitung tanpa memperhitungkan kondisi lalu lintas saat ini. Preferensi pemilihan rute ini menghasilkan respons permintaan tercepat
(latensi terendah).
Jika Anda memilih TRAFFIC_UNAWARE
, rute dan durasi yang dipilih didasarkan pada jaringan jalan dan kondisi lalu lintas rata-rata tanpa memperhitungkan waktu, bukan kondisi jalan saat ini. Akibatnya, rute tersebut mungkin mencakup jalan yang ditutup sementara. Hasil untuk permintaan tertentu dapat berubah seiring waktu karena perubahan pada jaringan jalan, kondisi lalu lintas rata-rata yang diperbarui, dan sifat layanan yang terdistribusi. Hasilnya juga dapat bervariasi di antara rute yang hampir setara di semua waktu atau frekuensi.
Berikut adalah respons yang akan Anda lihat:
duration
- Berisi PWT untuk rute.staticDuration
: PWT untuk rute yang hanya mempertimbangkan informasi traffic historis. UntukTRAFFIC_UNAWARE
, ini berisi nilai yang sama denganduration
.
Memahami traffic
Gunakan preferensi pemilihan rute ini jika Anda menginginkan detail pemilihan rute yang lebih akurat daripada
TRAFFIC_UNAWARE
, tetapi Anda tidak keberatan jika respons ditampilkan dengan
peningkatan latensi yang moderat.
Saat Anda menetapkan preferensi pemilihan rute TRAFFIC_AWARE
, layanan akan menghitung rute dengan mempertimbangkan kondisi lalu lintas saat ini. Akibatnya, rute dan detail rute
lebih akurat mencerminkan kondisi dunia nyata. Karena peningkatan kualitas data ini
diperoleh dengan mengorbankan latensi respons, pengoptimalan performa
diterapkan untuk mengurangi sebagian besar latensi.
Berikut adalah respons yang akan Anda lihat:
duration
: PWT yang mempertimbangkan informasi lalu lintas real-time.staticDuration
Perkiraan waktu tiba untuk rute yang hanya mempertimbangkan informasi traffic historis.
Optimal sesuai lalu lintas
Gunakan preferensi pemilihan rute ini jika Anda menginginkan hasil dengan kualitas tertinggi tanpa memperhatikan waktu yang diperlukan untuk respons. Preferensi pemilihan rute ini memiliki penundaan terpanjang dalam menampilkan respons (latensi tertinggi).
Saat Anda menetapkan preferensi pemilihan rute TRAFFIC_AWARE_OPTIMAL
, layanan
akan menghitung rute dengan mempertimbangkan kondisi lalu lintas saat ini, tetapi tidak menerapkan
pengoptimalan performa. Dalam mode ini, server melakukan penelusuran jaringan jalan yang lebih lengkap untuk menemukan rute yang optimal.
Preferensi pemilihan rute TRAFFIC_AWARE_OPTIMAL
setara dengan mode yang digunakan oleh
maps.google.com dan oleh
aplikasi seluler Google Maps.
Saat Anda menggunakan opsi ini dengan Compute Route Matrix, jumlah elemen dalam permintaan (jumlah asal × jumlah tujuan) tidak boleh melebihi
- Untuk mengetahui informasi selengkapnya tentang batas Compute Route Matrix, lihat Menghitung matriks rute.
Berikut adalah respons yang akan Anda lihat:
duration
: PWT untuk rute yang mempertimbangkan informasi lalu lintas real-time.staticDuration
: PWT untuk rute yang hanya mempertimbangkan informasi traffic historis.
Menetapkan waktu keberangkatan (opsional)
Gunakan properti ini hanya untuk permintaan yang mempertimbangkan traffic dengan waktu keberangkatan yang harus
di masa mendatang. Jika Anda tidak menetapkan properti departureTime
, properti tersebut akan ditetapkan secara default
ke waktu Anda membuat permintaan.
Gunakan properti departureTime
bersama dengan opsi TRAFFIC_AWARE
dan
TRAFFIC_AWARE_OPTIMAL
jika Anda ingin menyesuaikan cara layanan
memprediksi traffic saat memilih rute.
TRAFFIC_UNAWARE
: Tidak direkomendasikan karena pilihan rute dan durasi didasarkan pada jaringan jalan dan kondisi lalu lintas rata-rata tanpa memperhitungkan waktu tertentu.TRAFFIC_AWARE
danTRAFFIC_AWARE_OPTIMAL
: Direkomendasikan untuk keberangkatan yang akan dilakukan dalam waktu dekat karena preferensi ini mempertimbangkan kondisi lalu lintas secara real time. Lalu lintas live menjadi lebih penting dan relevan jikadepartureTime
lebih dekat ke waktu sekarang. Makin jauh Anda menetapkan waktu keberangkatan ke masa mendatang, makin banyak pertimbangan yang diberikan pada kondisi traffic historis dalam memilih rute.
Contoh: Cara memilih pemilihan rute sesuai lalu lintas
Kode JSON berikut menunjukkan cara menetapkan preferensi pemilihan rute TRAFFIC_AWARE_OPTIMAL
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 sepanjang polyline yang mempertimbangkan lalu lintas. Lihat Meminta polyline untuk informasi selengkapnya.