Tentukan bagaimana dan apakah menyertakan data lalu lintas

Preferensi lalu lintas yang Anda pilih akan menyeimbangkan akurasi detail rute dengan performa permintaan. Saat membuat permintaan, Anda perlu mempertimbangkan apakah lebih baik menampilkan hasil yang paling akurat, atau menampilkan hasil secepat mungkin. Routes API menyediakan opsi yang memungkinkan Anda mengontrol kualitas data respons vs latensi respons.

Perhatian: Permintaan yang menggunakan TRAFFIC_AWARE dan TRAFFIC_AWARE_OPTIMAL akan ditagih dengan tarif yang lebih tinggi. Pelajari penagihan lebih lanjut.

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:

• Saat tidak ada kemacetan, kondisi lalu lintas dianggap normal dan arus lalu lintas dengan kecepatan normal tanpa hambatan.
• Mendekati jam sibuk, kepadatan lalu lintas akan meningkat, yang menyebabkan lalu lintas melambat, sehingga menghasilkan kondisi lalu lintas yang 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 mempertimbangkan kondisi lalu lintas saat ini. Preferensi pemilihan rute ini memberikan latensi respons terendah (respons ditampilkan dengan cepat).

TRAFFIC_UNAWARE adalah setelan default.

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.

Dalam respons:

• Perkiraan waktu tiba (ETA) terdapat dalam properti respons duration.

• Properti respons duration dan staticDuration berisi nilai yang sama.

Gunakan preferensi pemilihan rute ini jika Anda ingin respons ditampilkan dengan cepat, dan detail pemilihan rute perkiraan sudah cukup baik.

Catatan: Setelan ini setara dengan saat traffic saat ini tidak digunakan di Directions API dan Distance Matrix API.

Memahami traffic

Saat Anda menetapkan preferensi pemilihan rute TRAFFIC_AWARE, rute akan dihitung dengan memperhitungkan 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.

Dalam respons:

• Perkiraan waktu tiba (ETA) yang mempertimbangkan traffic real-time terdapat dalam properti respons duration.

• Properti respons staticDuration berisi durasi perjalanan melalui rute tanpa mempertimbangkan kondisi lalu lintas.

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.

Catatan: Setelan ini baru untuk Routes API dan tidak memiliki padanan di Directions API dan Distance Matrix API.

Optimal sesuai lalu lintas

Saat Anda menetapkan preferensi pemilihan rute TRAFFIC_AWARE_OPTIMAL, rute dihitung dengan mempertimbangkan kondisi traffic saat ini, tetapi tidak ada pengoptimalan performa yang diterapkan. 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 menggunakan opsi ini dengan Compute Route Matrix, jumlah elemen dalam permintaan (jumlah asal × jumlah tujuan) tidak boleh melebihi 100. Untuk mengetahui informasi selengkapnya tentang batas Compute Route Matrix, lihat Menghitung matriks rute.

Dalam respons:

• Perkiraan waktu tiba (ETA) yang mempertimbangkan traffic real-time terdapat dalam properti respons duration.

• Properti respons staticDuration berisi durasi perjalanan melalui rute tanpa mempertimbangkan kondisi lalu lintas.

Preferensi pemilihan rute ini memberikan latensi respons tertinggi (yaitu, respons ditampilkan dengan penundaan terlama). Gunakan preferensi pemilihan rute ini jika Anda ingin hasil dengan kualitas tertinggi, tanpa mempertimbangkan berapa lama respons diperlukan.

Catatan: Opsi ini setara dengan menentukan departure_time di Directions API dan Distance Matrix API.

Pengaruh setelan waktu keberangkatan

Anda dapat menggunakan properti departureTime secara opsional untuk menetapkan waktu keberangkatan perjalanan. Jika Anda tidak menetapkan properti departureTime, properti tersebut akan ditetapkan secara default ke waktu saat Anda membuat permintaan.

• Untuk TRAFFIC_UNAWARE, Anda tidak dapat menetapkan departureTime karena pilihan rute dan durasi didasarkan pada jaringan jalan dan kondisi lalu lintas rata-rata tanpa memperhitungkan waktu.

• Untuk TRAFFIC_AWARE dan TRAFFIC_AWARE_OPTIMAL, yang mempertimbangkan kondisi traffic real time, traffic live akan menjadi lebih penting jika departureTime semakin dekat ke waktu sekarang. Semakin jauh Anda menetapkan waktu keberangkatan ke masa mendatang, semakin banyak pertimbangan untuk kondisi lalu lintas historis.

Contoh preferensi pemilihan rute setelan

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 di polyline

Routes API memungkinkan Anda meminta informasi tentang kondisi lalu lintas di sepanjang polyline berbasis traffic. Lihat Meminta polyline untuk informasi selengkapnya.