Model lalu lintas menggunakan algoritma dan faktor tertentu untuk memprediksi pengaruh kondisi lalu lintas terhadap total waktu perjalanan untuk rute tertentu. Routes API menawarkan berbagai jenis model traffic untuk memprioritaskan berbagai faktor yang digunakan dalam menghitung durasi dalam traffic. Anda dapat menentukan jenis model lalu lintas yang ingin digunakan rute saat menghitung durasi rute atau matriks rute. Saat Anda menetapkan jenis model traffic, nilai yang ditampilkan di kolom duration
bervariasi bergantung pada model traffic yang Anda pilih.
Baik metode Compute Routes
maupun Compute Route Matrix
Routes API mendukung jenis model traffic.
Secara default, kedua metode menggunakan jenis model traffic BEST_GUESS
.
Untuk menentukan jenis traffic
Tetapkan asal dan tujuan Anda.
Jika waktu keberangkatan Anda adalah pada masa mendatang, sertakan waktu menggunakan parameter
departure_time
. Jika Anda tidak menentukan waktu keberangkatan, setelan defaultnya adalah sekarang.Pilih model traffic yang akan digunakan dengan parameter
trafficModel
dan salah satu jenis berikut:BEST_GUESS
(default) untuk meminta bahwaduration_in_traffic
yang ditampilkan adalah perkiraan waktu perjalanan terbaik berdasarkan informasi historis kondisi lalu lintas dan lalu lintas live. Lalu lintas live menjadi lebih penting jikadeparture_time
semakin dekat ke waktu sekarang. Menggunakan jenis defaultBEST_GUESS
akan memberikan prediksi yang paling berguna untuk sebagian besar kasus penggunaan.PESSIMISTIC
untuk meminta agarduration_in_traffic
yang ditampilkan memodelkan waktu berdasarkan kondisi traffic historis pada hari dengan traffic yang buruk. Jenis ini memberikan perkiraan durasi yang kemungkinan besar lebih lama daripada waktu perjalanan sebenarnya pada sebagian besar hari. Hari-hari tertentu dengan kondisi yang sangat buruk masih dapat melebihi perkiraan ini.OPTIMISTIC
untuk meminta agarduration_in_traffic
yang ditampilkan memodelkan waktu berdasarkan kondisi traffic historis pada hari dengan traffic yang baik. Jenis ini memberikan perkiraan durasi yang kemungkinan besar lebih singkat daripada waktu perjalanan sebenarnya pada sebagian besar hari. Hari-hari tertentu yang kondisinya sangat baik mungkin masih lebih cepat dari estimasi ini.
Contoh:
"trafficModel": "OPTIMISTIC"
Tentukan kolom
routes.duration
di mask kolom.REST
-H X-Goog-FieldMask: routes.duration
RPC
const (fieldMask = "routes.duration")
Saat Routes API memperkirakan waktu dalam lalu lintas, jenis model traffic yang Anda minta akan digunakan.
Contoh: Permintaan model traffic
Misalnya, permintaan ini menentukan bahwa durasi diperkirakan menggunakan jenis model lalu lintas OPTIMISTIC
pada waktu keberangkatan tertentu:
curl -X POST -H 'content-type: application/json' -d ' { "origin": { "address": "Kyoto, Japan" }, "destination": { "placeId": "ChIJrYtcv-urAWAR3XzWvXv8n_s" }, "travelMode": "DRIVE", "routingPreference": "TRAFFIC_AWARE_OPTIMAL", "trafficModel": "OPTIMISTIC" }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Permintaan ini menampilkan perkiraan durasi menggunakan jenis model lalu lintas OPTIMISTIC
untuk perjalanan:
"duration": "1238s"
Jika Anda mengubah jenis model traffic menjadi PESSIMISTIC
, durasi yang ditampilkan akan lebih lama:
"duration": "2436s"