Menentukan jenis model traffic yang akan digunakan

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 penghitungan durasi dalam traffic. Anda dapat menentukan jenis model lalu lintas yang akan 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 tersebut menggunakan jenis model traffic BEST_GUESS.

Untuk menentukan jenis traffic

1. Tetapkan asal dan tujuan Anda.

2. Jika waktu keberangkatan Anda di masa mendatang, sertakan waktu menggunakan parameter departure_time. Jika Anda tidak menentukan waktu keberangkatan, defaultnya adalah sekarang.

3. Pilih model traffic yang akan digunakan dengan parameter trafficModel dan salah satu jenis berikut:

   • BEST_GUESS (default) untuk meminta agar duration_in_traffic yang ditampilkan adalah perkiraan waktu tempuh terbaik berdasarkan informasi historis kondisi lalu lintas dan lalu lintas yang sedang berlangsung. Lalu lintas live menjadi lebih penting jika departure_time semakin dekat ke waktu sekarang. Menggunakan jenis default BEST_GUESS akan memberikan prediksi yang paling berguna untuk sebagian besar kasus penggunaan.

   • PESSIMISTIC untuk meminta duration_in_traffic yang ditampilkan membuat model waktu berdasarkan kondisi lalu lintas historis pada hari lalu lintas buruk. Jenis ini memberikan perkiraan durasi yang kemungkinan besar lebih lama daripada waktu perjalanan sebenarnya di sebagian besar hari. Terkadang, hari-hari dengan kondisi lalu lintas yang sangat buruk mungkin masih melebihi estimasi ini.

   • OPTIMISTIC untuk meminta duration_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 perjalanan sebenarnya di hampir setiap hari. Pada hari-hari tertentu dengan kondisi yang sangat baik, waktu tempuh mungkin masih lebih cepat daripada perkiraan ini.

   Contoh:

   "trafficModel": "OPTIMISTIC"

4. 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 traffic, Routes API akan menggunakan jenis model traffic yang Anda minta.

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 estimasi durasi menggunakan jenis model traffic OPTIMISTIC untuk perjalanan:

"duration": "1238s"

Jika Anda mengubah jenis model traffic menjadi PESSIMISTIC, durasi yang ditampilkan akan lebih lama:

"duration": "2436s"