Model traffic menggunakan algoritma dan faktor tertentu untuk memprediksi traffic
kondisi yang berdampak pada total waktu perjalanan untuk rute tertentu. Routes API
menawarkan berbagai jenis model traffic untuk memprioritaskan berbagai faktor yang digunakan dalam
menghitung durasi dalam lalu lintas. Anda dapat menentukan jenis model traffic
seperti rute yang akan digunakan saat menghitung durasi rute atau rute Anda
yang dihasilkan. Saat Anda menetapkan jenis model traffic, nilai yang ditampilkan di
Kolom duration
bervariasi bergantung pada model traffic yang Anda pilih.
Routes API Compute Routes
dan
Metode Compute Route Matrix
mendukung jenis model traffic.
Secara default, kedua metode tersebut menggunakan jenis model traffic BEST_GUESS
.
Untuk menentukan jenis traffic
Tetapkan asal dan tujuan Anda.
Jika waktu keberangkatan Anda di masa mendatang, sertakan waktu menggunakan Parameter
departure_time
. Jika Anda tidak menentukan waktu keberangkatan, waktu tersebut akan ditetapkan secara default ke sekarang.Pilih model traffic yang akan digunakan dengan parameter
trafficModel
dan salah satu jenis berikut:BEST_GUESS
(default) untuk memintaduration_in_traffic
yang ditampilkan adalah perkiraan waktu perjalanan terbaik berdasarkan informasi yang diketahui tentang kondisi lalu lintas historis dan lalu lintas langsung. Lalu lintas langsung menjadi lebih penting jikadeparture_time
semakin dekat ke waktu sekarang. Menggunakan jenis defaultBEST_GUESS
memberikan prediksi yang paling berguna untuk sebagian besar kasus penggunaan.PESSIMISTIC
untuk meminta agarduration_in_traffic
yang ditampilkan memodelkan berdasarkan kondisi lalu lintas historis pada hari-hari lalu lintas yang padat. Jenis ini memberikan perkiraan durasi yang kemungkinan besar lebih panjang daripada waktu tempuh yang sebenarnya hampir setiap hari. Hari-hari tertentu dengan kondisi buruk kondisi mungkin masih melebihi estimasi ini.OPTIMISTIC
untuk meminta agarduration_in_traffic
yang ditampilkan memodelkan waktu berdasarkan kondisi lalu lintas historis pada hari lalu lintas yang baik. Jenis ini memberikan perkiraan durasi yang kemungkinan besar lebih singkat daripada waktu tempuh yang sebenarnya hampir setiap hari. Hari-hari tertentu dengan kondisi yang baik mungkin masih lebih cepat dari perkiraan ini.
Contoh:
"trafficModel": "OPTIMISTIC"
Tentukan kolom
routes.duration
di mask kolom.REST
-H X-Goog-FieldMask: routes.duration
RPC
const (fieldMask = "routes.duration")
Saat memperkirakan waktu dalam lalu lintas, Routes API menggunakan jenis model lalu lintas yang Anda minta.
Contoh: Permintaan model traffic
Misalnya, permintaan ini menetapkan bahwa durasi diperkirakan menggunakan
OPTIMISTIC
jenis model lalu lintas 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 estimasi durasi menggunakan model traffic OPTIMISTIC
jenis perjalanan:
"duration": "1238s"
Jika Anda mengubah jenis model traffic menjadi PESSIMISTIC
, durasi yang ditampilkan adalah
lagi:
"duration": "2436s"