Routes Preferred API menyediakan tiga preferensi pemilihan rute untuk menghitung rute. Keduanya berbeda dalam hal mempertimbangkan kondisi lalu lintas dalam penghitungan rute. Setiap preferensi pemilihan rute menghasilkan hasil yang berbeda-beda sehubungan dengan kualitas rute, perkiraan ETA, dan latensi respons.
Tentang kondisi lalu lintas
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 kemacetan total, laju aliran berhenti, sehingga menghasilkan kondisi lalu lintas yang padat.
Tidak mengetahui traffic
Saat Anda menetapkan preferensi pemilihan rute TRAFFIC_UNAWARE
, rute dihitung tanpa memperhitungkan kondisi lalu lintas. Preferensi pemilihan rute ini memberikan latensi respons terendah
(respons ditampilkan dengan cepat).
Gunakan preferensi pemilihan rute ini jika Anda ingin respons ditampilkan dengan cepat, dan detail pemilihan rute perkiraan sudah cukup baik.
Memahami traffic
Saat Anda menetapkan preferensi pemilihan rute TRAFFIC_AWARE
, rute akan dihitung dengan mempertimbangkan kondisi lalu lintas. Akibatnya, rute dan detail rute mencerminkan kondisi di dunia nyata secara lebih akurat. Karena peningkatan kualitas data ini mengorbankan latensi respons, pengoptimalan performa diterapkan untuk mengurangi sebagian besar latensi.
Gunakan preferensi pemilihan rute ini jika Anda menginginkan detail pemilihan rute yang lebih akurat, tetapi Anda tidak keberatan jika respons ditampilkan dengan peningkatan latensi yang moderat.
Optimal sesuai lalu lintas
Saat Anda menetapkan preferensi pemilihan rute TRAFFIC_AWARE_OPTIMAL
, rute dihitung dengan mempertimbangkan kondisi lalu lintas, tetapi tidak ada pengoptimalan performa yang diterapkan. Dalam mode ini, server melakukan
penelusuran jaringan jalan yang lebih menyeluruh untuk menemukan rute yang optimal.
Preferensi pemilihan rute ini memberikan latensi respons tertinggi (yaitu, respons ditampilkan dengan penundaan terlama). Gunakan preferensi pemilihan rute ini jika Anda menginginkan hasil dengan kualitas tertinggi, tanpa mempertimbangkan berapa lama respons diperlukan.
Contoh
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" }