Menetapkan tingkat data traffic

Developer Wilayah Ekonomi Eropa (EEA)

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

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

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

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

Cara menetapkan tingkat traffic

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

Defaultnya adalah hasil yang tidak memperhitungkan lalu lintas. Anda dapat memilih opsi lalu lintas dengan preferensi pemilihan rute TRAFFIC_UNAWARE, TRAFFIC_AWARE, dan TRAFFIC_AWARE_OPTIMAL. Setiap preferensi pemilihan rute menghasilkan hasil yang berbeda dalam kualitas rute, perkiraan PWT, dan latensi respons.

Kondisi lalu lintas

Kondisi lalu lintas mencirikan tingkat arus lalu lintas:

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

  • Lalu lintas lancar hingga sedang: Kemacetan meningkat, dengan lalu lintas mengalir dengan kecepatan yang berkurang.

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

Tidak memperhitungkan lalu lintas

TRAFFIC_UNAWARE adalah setelan default. Gunakan preferensi pemilihan rute ini jika Anda menginginkan respons ditampilkan secepat mungkin, dan perkiraan detail pemilihan rute sudah cukup.

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 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 lalu lintas historis. Untuk TRAFFIC_UNAWARE, kolom ini berisi nilai yang sama dengan duration.

Memperhitungkan 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 sedikit peningkatan latensi.

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

Berikut adalah respons yang akan Anda lihat:

  • duration: Perkiraan waktu kedatangan (ETA) dengan mempertimbangkan informasi lalu lintas real-time.

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

Optimal sesuai lalu lintas

Gunakan preferensi pemilihan rute ini jika Anda menginginkan hasil dengan kualitas tertinggi tanpa memperhitungkan berapa lama respons yang diperlukan. Preferensi pemilihan rute ini memiliki penundaan terlama 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 menyeluruh 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) dibatasi. 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 lalu lintas historis.

Tetapkan waktu keberangkatan (opsional)

Gunakan properti ini hanya untuk permintaan yang memperhitungkan lalu lintas dengan waktu keberangkatan yang harus ditetapkan di masa mendatang. Jika Anda tidak menetapkan properti departureTime, properti ini 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 segera dilakukan karena preferensi ini mempertimbangkan kondisi lalu lintas langsung. Lalu lintas live menjadi lebih penting dan relevan jika departureTime semakin dekat ke waktu sekarang. Semakin jauh Anda menetapkan waktu keberangkatan ke masa mendatang, semakin 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 pemilihan rute TRAFFIC_AWARE_OPTIMAL 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"
}