Routes Preferred API menyediakan tiga preferensi pemilihan rute untuk menghitung rute. Perbedaannya terletak pada sejauh mana keduanya memperhitungkan kondisi lalu lintas ke dalam penghitungan rute. Setiap preferensi pemilihan rute menghasilkan hasil yang berbeda dalam hal kualitas rute, perkiraan waktu kedatangan (ETA), dan latensi respons.
Tentang kondisi lalu lintas
Kondisi lalu lintas mencirikan tingkat arus lalu lintas. Contoh:
Jika tidak ada kemacetan, kondisi lalu lintas dianggap normal, dan lalu lintas mengalir dengan kecepatan reguler 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 arus lalu lintas terhenti, sehingga menghasilkan kondisi lalu lintas yang padat.
Tidak memperhitungkan lalu lintas
Saat Anda menetapkan preferensi pemilihan rute TRAFFIC_UNAWARE, rute akan dihitung tanpa memperhitungkan kondisi lalu lintas. Preferensi pemilihan rute ini memberikan latensi respons terendah
(respons ditampilkan paling cepat).
Gunakan preferensi pemilihan rute ini jika Anda ingin respons ditampilkan secepat mungkin, dan perkiraan detail rute sudah cukup.
Memperhitungkan traffic
Saat Anda menetapkan preferensi pemilihan rute TRAFFIC_AWARE, rute akan dihitung dengan mempertimbangkan kondisi lalu lintas. Hasilnya, rute dan detail rute akan lebih akurat mencerminkan kondisi dunia nyata. 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 tidak keberatan jika respons ditampilkan dengan sedikit peningkatan latensi.
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 waktu yang diperlukan untuk merespons.
Contoh
Kode JSON berikut menunjukkan cara menetapkan preferensi pemilihan rute dalam isi entity 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" }