Halaman ini diterjemahkan oleh Cloud Translation API.

Tentukan bagaimana dan apakah menyertakan data lalu lintas

Preferensi lalu lintas yang Anda pilih akan menyeimbangkan akurasi detail rute dengan performa permintaan. Saat membuat permintaan, sebaiknya 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 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 faktor kondisi lalu lintas dalam perhitungan rute. Setiap preferensi pemilihan rute memberikan hasil yang berbeda hingga derajat dalam hal kualitas rute, perkiraan PWT, dan latensi respons.

Kondisi lalu lintas menunjukkan laju arus lalu lintas. Contoh:

Saat tidak ada kemacetan, kondisi lalu lintas dianggap normal dan arus lalu lintas dengan kecepatan normal tanpa hambatan.
Mendekati jam sibuk, kepadatan lalu lintas akan meningkat, yang menyebabkan lalu lintas melambat, sehingga menghasilkan kondisi lalu lintas yang ringan hingga sedang.
Dalam lalu lintas bumper ke bumper, kecepatan aliran akan berhenti, sehingga menghasilkan kondisi lalu lintas yang padat.

Tidak sadar traffic

Saat Anda menetapkan preferensi pemilihan rute TRAFFIC_UNAWARE, rute akan dihitung tanpa memperhitungkan kondisi lalu lintas saat ini. Preferensi perutean ini memberikan latensi respons terendah (respons ditampilkan paling cepat).

Setelan default-nya adalah TRAFFIC_UNAWARE.

Jika Anda memilih TRAFFIC_UNAWARE, rute dan durasi yang dipilih didasarkan pada 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.

Dalam respons:

PWT dimuat dalam properti respons duration.
Properti respons duration dan staticDuration berisi nilai yang sama.

Gunakan preferensi perutean ini saat Anda ingin respons ditampilkan tercepat, dan detail perkiraan perutean sudah cukup baik.

Memperhatikan traffic

Saat Anda menetapkan preferensi pemilihan rute TRAFFIC_AWARE, rute akan dihitung dengan memperhitungkan kondisi lalu lintas saat ini. Hasilnya, detail rute dan rute lebih akurat mencerminkan kondisi sebenarnya. Karena peningkatan kualitas data ini mengorbankan latensi respons, pengoptimalan performa diterapkan untuk mengurangi banyak latensi.

Dalam respons:

PWT yang mempertimbangkan traffic real-time dimuat dalam properti respons duration.
Properti respons staticDuration berisi durasi perjalanan melalui rute tanpa memperhitungkan kondisi lalu lintas.

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

Sadar traffic optimal

Saat Anda menetapkan preferensi pemilihan rute TRAFFIC_AWARE_OPTIMAL, rute dihitung dengan memperhitungkan kondisi lalu lintas saat ini, tetapi tidak ada pengoptimalan performa yang diterapkan. 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 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 mengetahui informasi lebih lanjut tentang batas Compute Route Matrix, lihat Menghitung matriks rute.

Dalam respons:

PWT yang mempertimbangkan traffic real-time dimuat dalam properti respons duration.
Properti respons staticDuration berisi durasi perjalanan melalui rute tanpa memperhitungkan kondisi lalu lintas.

Preferensi pemilihan rute ini memberikan latensi respons tertinggi (yaitu, respons ditampilkan dengan penundaan terlama). Gunakan preferensi pemilihan rute ini jika Anda menginginkan hasil dengan kualitas tertinggi, tanpa memperhatikan lama waktu yang dibutuhkan untuk respons.

Pengaruh setelan waktu keberangkatan

Jika ingin, Anda dapat menggunakan properti departureTime untuk menetapkan waktu keberangkatan untuk sebuah perjalanan. Jika Anda tidak menetapkan properti departureTime, nilai 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 kondisi lalu lintas rata-rata tanpa memperhitungkan waktu.
Untuk TRAFFIC_AWARE dan TRAFFIC_AWARE_OPTIMAL, yang mempertimbangkan kondisi traffic real time, traffic live akan menjadi lebih penting jika departureTime semakin dekat ke waktu sekarang. Semakin jauh Anda menetapkan waktu keberangkatan ke masa mendatang, semakin banyak pertimbangan untuk kondisi lalu lintas historis.

Contoh preferensi pemilihan rute setelan

Kode JSON berikut menunjukkan cara menetapkan preferensi pemilihan rute 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"
}

Mengonfigurasi traffic di polyline

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