Tentukan bagaimana dan apakah menyertakan data lalu lintas

Preferensi lalu lintas yang Anda pilih menyeimbangkan akurasi detail rute dengan performa permintaan. Saat membuat permintaan, Anda ingin mempertimbangkan apakah lebih baik untuk menampilkan hasil seakurat mungkin, atau menampilkan hasil 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. Preferensi ini berbeda-beda dalam hal memperhitungkan kondisi traffic ke dalam penghitungan rute. Setiap preferensi pemilihan rute memberikan hasil yang berbeda pada tingkat tertentu dalam hal kualitas rute, perkiraan PWT, dan latensi respons.

Kondisi lalu lintas merupakan karakteristik laju arus lalu lintas. Contoh:

  • Jika tidak ada kemacetan, kondisi lalu lintas dianggap normal, dan lalu lintas berjalan dengan kecepatan normal tanpa hambatan.
  • Mendekati jam sibuk, kepadatan lalu lintas meningkat, yang menyebabkan lalu lintas melambat, sehingga menghasilkan kondisi lalu lintas yang ringan hingga sedang.
  • Dalam traffic bumper ke bumper, laju aliran akan berhenti, sehingga menghasilkan kondisi lalu lintas yang padat.

Traffic tidak sadar

Jika Anda menetapkan preferensi pemilihan rute TRAFFIC_UNAWARE, rute akan dihitung tanpa memperhitungkan kondisi lalu lintas saat ini. Preferensi pemilihan rute ini memberikan latensi respons terendah (respons ditampilkan paling cepat).

Setelan default-nya adalah TRAFFIC_UNAWARE.

Dalam respons:

  • PWT terdapat dalam properti respons duration.

  • Properti respons duration dan staticDuration berisi nilai yang sama.

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

Sadar lalu lintas

Saat Anda menetapkan preferensi pemilihan rute TRAFFIC_AWARE, rute akan dihitung dengan memperhitungkan kondisi lalu lintas saat ini. Hasilnya, detail rute dan rute lebih akurat mencerminkan kondisi dunia nyata. Karena peningkatan kualitas data ini mengorbankan latensi respons, pengoptimalan performa diterapkan untuk mengurangi banyak latensi.

Dalam respons:

  • PWT yang mempertimbangkan traffic real-time dimuat 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 masalah jika respons ditampilkan dengan peningkatan latensi yang sedang.

Pengelolaan traffic optimal

Saat Anda menetapkan preferensi pemilihan rute TRAFFIC_AWARE_OPTIMAL, rute akan dihitung dengan memperhitungkan kondisi lalu lintas saat ini, 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 TRAFFIC_AWARE_OPTIMAL setara dengan mode yang digunakan oleh maps.google.com dan aplikasi seluler Google Maps.

Saat menggunakan opsi ini dengan Compute Route Matrix, jumlah elemen dalam permintaan (jumlah asal × jumlah tujuan) tidak boleh lebih dari 100. Untuk mengetahui informasi selengkapnya tentang batas Compute Route Matrix, lihat Menghitung matriks rute.

Dalam respons:

  • PWT yang mempertimbangkan traffic real-time dimuat 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 menampilkan dengan keterlambatan terlama). Gunakan preferensi pemilihan rute ini jika Anda menginginkan hasil dengan kualitas tertinggi, tanpa memperhatikan lamanya waktu respons.

Pengaruh penetapan waktu keberangkatan

Anda juga dapat menggunakan properti departureTime untuk menetapkan waktu keberangkatan untuk sebuah perjalanan. Jika Anda tidak menetapkan properti departureTime, properti 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 yang tidak tergantung waktu.

  • Untuk TRAFFIC_AWARE dan TRAFFIC_AWARE_OPTIMAL, yang mempertimbangkan kondisi traffic langsung, traffic langsung menjadi lebih penting jika departureTime semakin mendekati nilai saat ini. Semakin jauh Anda menetapkan waktu keberangkatan ke masa mendatang, semakin banyak pertimbangan yang diberikan untuk kondisi lalu lintas historis.

Contoh penetapan preferensi pemilihan rute

Kode JSON berikut menunjukkan cara menetapkan preferensi perutean 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"
}

Mengonfigurasi traffic pada polyline

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