Tentukan bagaimana dan apakah menyertakan data lalu lintas

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. 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:

  • 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 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 pemilihan rute ini memberikan latensi respons terendah (respons ditampilkan dengan cepat).

TRAFFIC_UNAWARE adalah setelan default.

Dalam respons:

  • PWT dimuat dalam properti respons duration.

  • Properti respons duration dan staticDuration berisi hal yang sama dengan sejumlah nilai.

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

Memahami traffic

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

Dalam respons:

  • Perkiraan waktu tiba (ETA) 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:

  • Perkiraan waktu tiba (ETA) 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 pemilihan rute ini jika Anda ingin hasil dengan kualitas tertinggi, tanpa mempertimbangkan berapa lama respons diperlukan.

Pengaruh setelan waktu keberangkatan

Secara opsional, Anda dapat menggunakan properti departureTime untuk menetapkan waktu keberangkatan untuk berkemah. Jika Anda tidak menetapkan properti departureTime, properti tersebut akan ditetapkan secara default ke waktu 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 menampilkan lalu lintas live tertentu, traffic langsung menjadi makin penting. semakin dekat departureTime ke waktu sekarang. Semakin jauh Anda menetapkan waktu keberangkatan di masa mendatang, semakin banyak pertimbangan yang diberikan pada lalu lintas historis kondisi tertentu.

Contoh setelan preferensi pemilihan rute

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

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