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. Ini preferensi akan berbeda dalam hal faktor tersebut memperhitungkan kondisi lalu lintas rute penghitungan. Setiap preferensi {i>routing<i} menghasilkan hasil yang berbeda dengan derajat dalam hal kualitas rute, perkiraan PWT, dan latensi respons.
Kondisi lalu lintas menunjukkan laju arus lalu lintas. Contoh:
- Ketika tidak ada kemacetan, kondisi lalu lintas dianggap normal, dan arus lalu lintas dengan kecepatan reguler yang tidak terhalang.
- Mendekati jam sibuk, kepadatan lalu lintas akan meningkat, yang menyebabkan lalu lintas melambat, yang 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 {i>routing<i} ini
memberikan latensi respons terendah (respons ditampilkan paling cepat).
Setelan default-nya adalah TRAFFIC_UNAWARE
.
Dalam respons:
PWT dimuat dalam properti respons
duration
.Properti respons
duration
danstaticDuration
berisi hal yang sama dengan sejumlah nilai.
Gunakan preferensi {i>routing<i} ini jika Anda ingin respons yang paling cepat ditampilkan, dan detail perkiraan {i>routing<i} sudah cukup baik.
Memperhatikan traffic
Jika Anda menetapkan preferensi pemilihan rute TRAFFIC_AWARE
, rute akan dihitung
memperhitungkan kondisi
lalu lintas saat ini. Akibatnya, rute dan rute
lebih akurat untuk
mencerminkan kondisi di dunia nyata. Karena peningkatan jumlah
kualitas data mengorbankan latensi respons, mengoptimalkan performa
diterapkan untuk mengurangi banyak latensi.
Dalam respons:
PWT 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:
PWT 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 {i>routing<i} ini saat Anda menginginkan hasil dengan kualitas terbaik, tanpa memperhatikan berapa lama waktu yang dibutuhkan.
Pengaruh setelan waktu keberangkatan
Secara opsional, Anda dapat menggunakan properti departureTime
untuk menetapkan waktu keberangkatan untuk
berkemah. Jika Anda tidak menetapkan properti departureTime
, defaultnya adalah
waktu saat Anda membuat permintaan.
Untuk
TRAFFIC_UNAWARE
, Anda tidak dapat menyeteldepartureTime
karena pilihan rute dan durasi didasarkan pada jaringan jalan dan rata-rata tidak bergantung pada waktu kondisi lalu lintas.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 preferensi pemilihan rute setelan
Kode JSON berikut menunjukkan cara mengatur preferensi perutean 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 di polyline
Routes API memungkinkan Anda meminta informasi tentang kondisi lalu lintas di sepanjang polyline berbasis traffic. Lihat Minta polyline untuk mengetahui informasi selengkapnya.