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. 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 dan staticDuration 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 menyetel departureTime karena pilihan rute dan durasi didasarkan pada jaringan jalan dan rata-rata tidak bergantung pada waktu kondisi lalu lintas.

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