Menetapkan tingkat data traffic

Developer Wilayah Ekonomi Eropa (EEA)

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

  • Sesuai lalu lintas -- Menampilkan hasil yang paling akurat (latensi lebih tinggi).

  • Tidak mengetahui lalu lintas -- Menampilkan hasil secepat mungkin (latensi terendah).

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

Cara menyetel tingkat lalu lintas

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

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 perutean menghasilkan hasil yang berbeda dalam kualitas rute, perkiraan waktu tiba (ETA), dan latensi respons.

Kondisi lalu lintas

Kondisi lalu lintas mencirikan laju aliran traffic:

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

  • Lalu lintas ringan hingga sedang: Kemacetan meningkat, dengan lalu lintas yang bergerak pada kecepatan yang lebih rendah.

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

Tidak menyadari lalu lintas

TRAFFIC_UNAWARE adalah setelan default. Gunakan preferensi perutean ini jika Anda ingin respons ditampilkan secepat mungkin, dan detail perutean yang diperkirakan sudah cukup.

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

Jika Anda memilih TRAFFIC_UNAWARE, rute dan durasi akan dipilih berdasarkan jaringan jalan dan kondisi lalu lintas tanpa memperhitungkan waktu rata-rata, 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, kolom ini berisi nilai yang sama dengan duration.

Mengetahui lalu lintas

Gunakan preferensi perutean ini jika Anda menginginkan detail perutean yang lebih akurat daripada TRAFFIC_UNAWARE, tetapi Anda tidak keberatan jika respons ditampilkan dengan peningkatan latensi yang sedang.

Saat Anda menetapkan preferensi perutean TRAFFIC_AWARE, layanan akan menghitung rute dengan mempertimbangkan kondisi lalu lintas saat ini. Hasilnya, rute dan detail rute mencerminkan kondisi dunia nyata dengan lebih akurat. Karena peningkatan kualitas data ini mengorbankan latensi respons, pengoptimalan performa diterapkan untuk mengurangi sebagian besar latensi.

Berikut adalah respons yang akan Anda lihat:

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

  • staticDuration Waktu tempuh untuk rute dengan hanya mempertimbangkan informasi traffic historis.

Optimal sesuai lalu lintas

Gunakan preferensi perutean ini jika Anda menginginkan hasil berkualitas tertinggi tanpa memperhatikan durasi respons. Preferensi pemilihan rute ini memiliki penundaan terlama dalam menampilkan respons (latensi tertinggi).

Saat Anda menetapkan preferensi perutean TRAFFIC_AWARE_OPTIMAL, layanan menghitung rute dengan mempertimbangkan kondisi lalu lintas saat ini, tetapi tidak menerapkan pengoptimalan performa. Dalam mode ini, server melakukan penelusuran jaringan jalan yang lebih menyeluruh untuk menemukan rute 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 dengan 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 mengetahui traffic di mana waktu keberangkatan harus pada waktu mendatang. Jika Anda tidak menetapkan properti departureTime, properti tersebut akan secara default ditetapkan ke waktu saat Anda membuat permintaan.

Gunakan properti departureTime bersama dengan opsi TRAFFIC_AWARE dan TRAFFIC_AWARE_OPTIMAL jika Anda ingin menyesuaikan cara layanan memprediksi lalu lintas 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 dalam waktu dekat karena preferensi ini mempertimbangkan kondisi traffic langsung. Lalu lintas live menjadi lebih penting dan relevan jika departureTime semakin dekat ke waktu sekarang. Makin jauh waktu keberangkatan yang Anda tetapkan ke masa depan, makin banyak pertimbangan yang diberikan pada kondisi lalu lintas historis dalam memilih rute.

Contoh: Cara memilih pemilihan rute sesuai lalu lintas

Kode JSON berikut menunjukkan cara menetapkan preferensi perutean 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 di sepanjang polyline yang mengetahui lalu lintas. Lihat Meminta polyline untuk mengetahui informasi selengkapnya.