Menetapkan tingkat data traffic

Preferensi traffic yang Anda pilih menyeimbangkan akurasi detail rute dengan performa permintaan dengan salah satu dari dua cara:

  • Traffic aware -- Menampilkan hasil yang paling akurat (latensi yang lebih tinggi).

  • Tidak mempertimbangkan traffic -- Menampilkan hasil secepat mungkin (latensi terendah).

Saat Anda membuat permintaan, pertimbangkan apakah lebih baik menampilkan hasil yang paling akurat, atau menampilkan hasil secepat mungkin. Routes API menyediakan opsi yang memungkinkan Anda mengontrol kualitas data respons dibandingkan latensi respons.

Cara menetapkan tingkat traffic

Routes API menyediakan RoutingPreference (REST) dan RoutingPreference (gRPC) yang memungkinkan Anda menentukan preferensi pemilihan rute untuk menghitung rute.

Setelan defaultnya adalah hasil yang tidak mengetahui traffic. Anda memilih opsi traffic dengan preferensi pemilihan rute TRAFFIC_UNAWARE, TRAFFIC_AWARE, dan TRAFFIC_AWARE_OPTIMAL. Setiap preferensi pemilihan rute menghasilkan hasil yang berbeda dalam kualitas rute, perkiraan waktu tiba, dan latensi respons.

Kondisi lalu lintas

Kondisi lalu lintas mencirikan kecepatan aliran traffic:

  • Lalu lintas normal: Tidak ada kemacetan dengan lalu lintas yang mengalir dengan kecepatan normal.

  • Traffic ringan hingga sedang: Kemacetan meningkat, dengan traffic yang mengalir dengan kecepatan yang berkurang.

  • Lalu lintas padat: Kemacetan parah, dengan kecepatan lalu lintas yang sangat berkurang.

Tidak mengetahui traffic

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

Rute TRAFFIC_UNAWARE dihitung tanpa memperhitungkan kondisi lalu lintas saat ini. Preferensi pemilihan rute ini menghasilkan respons permintaan tercepat (latensi terendah).

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.

Berikut adalah respons yang akan Anda lihat:

  • duration - Berisi PWT untuk rute.

  • staticDuration: PWT untuk rute yang hanya mempertimbangkan informasi traffic historis. Untuk TRAFFIC_UNAWARE, ini berisi nilai yang sama dengan duration.

Memahami traffic

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.

Saat Anda menetapkan preferensi pemilihan rute TRAFFIC_AWARE, layanan akan menghitung rute dengan mempertimbangkan 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.

Berikut adalah respons yang akan Anda lihat:

  • duration: PWT yang mempertimbangkan informasi lalu lintas real-time.

  • staticDuration Perkiraan waktu tiba untuk rute yang hanya mempertimbangkan informasi traffic historis.

Optimal sesuai lalu lintas

Gunakan preferensi pemilihan rute ini jika Anda menginginkan hasil dengan kualitas tertinggi tanpa memperhatikan waktu yang diperlukan untuk respons. Preferensi pemilihan rute ini memiliki penundaan terpanjang dalam menampilkan respons (latensi tertinggi).

Saat Anda menetapkan preferensi pemilihan rute TRAFFIC_AWARE_OPTIMAL, layanan akan menghitung rute dengan mempertimbangkan kondisi lalu lintas saat ini, tetapi tidak menerapkan pengoptimalan performa. 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 Anda menggunakan opsi ini dengan Compute Route Matrix, jumlah elemen dalam permintaan (jumlah asal × jumlah tujuan) tidak boleh melebihi

  1. Untuk mengetahui informasi selengkapnya tentang batas Compute Route Matrix, lihat Menghitung matriks rute.

Berikut adalah respons yang akan Anda lihat:

  • duration: PWT untuk rute yang mempertimbangkan informasi lalu lintas real-time.

  • staticDuration: PWT untuk rute yang hanya mempertimbangkan informasi traffic historis.

Menetapkan waktu keberangkatan (opsional)

Gunakan properti ini hanya untuk permintaan yang mempertimbangkan traffic dengan waktu keberangkatan yang harus di masa mendatang. Jika Anda tidak menetapkan properti departureTime, properti tersebut akan ditetapkan secara default ke waktu Anda membuat permintaan.

Gunakan properti departureTime bersama dengan opsi TRAFFIC_AWARE dan TRAFFIC_AWARE_OPTIMAL jika Anda ingin menyesuaikan cara layanan memprediksi traffic saat memilih rute.

  • TRAFFIC_UNAWARE: Tidak direkomendasikan karena pilihan rute dan durasi didasarkan pada jaringan jalan dan kondisi lalu lintas rata-rata tanpa memperhitungkan waktu tertentu.

  • TRAFFIC_AWARE dan TRAFFIC_AWARE_OPTIMAL: Direkomendasikan untuk keberangkatan yang akan dilakukan dalam waktu dekat karena preferensi ini mempertimbangkan kondisi lalu lintas secara real time. Lalu lintas live menjadi lebih penting dan relevan jika departureTime lebih dekat ke waktu sekarang. Makin jauh Anda menetapkan waktu keberangkatan ke masa mendatang, makin banyak pertimbangan yang diberikan pada kondisi traffic historis dalam memilih rute.

Contoh: Cara memilih pemilihan rute sesuai lalu lintas

Kode JSON berikut menunjukkan cara menetapkan preferensi pemilihan rute TRAFFIC_AWARE_OPTIMAL 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 sepanjang polyline yang mempertimbangkan lalu lintas. Lihat Meminta polyline untuk informasi selengkapnya.