Menentukan jenis model traffic yang akan digunakan

Developer Wilayah Ekonomi Eropa (EEA)

Model traffic menggunakan algoritma dan faktor tertentu untuk memprediksi bagaimana kondisi traffic memengaruhi 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 traffic yang ingin digunakan rute saat menghitung durasi untuk rute atau matriks rute. Saat Anda menetapkan jenis model traffic, nilai yang ditampilkan di kolom duration bervariasi bergantung pada model traffic yang Anda pilih.

Metode Compute Routes dan Compute Route Matrix Routes API mendukung jenis model traffic.

Secara default, kedua metode 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, waktu tersebut akan disetel ke sekarang secara default.

  3. Tetapkan parameter routingPreference ke TRAFFIC_AWARE_OPTIMAL. Menetapkan routingPreference ke TRAFFIC_UNAWARE atau TRAFFIC_AWARE tidak kompatibel dengan parameter trafficModel.

  4. 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 live. Lalu lintas live menjadi lebih penting jika departure_time semakin dekat ke waktu sekarang. Menggunakan jenis BEST_GUESS default memberikan prediksi yang paling berguna untuk sebagian besar kasus penggunaan.

    • PESSIMISTIC untuk meminta agar duration_in_traffic yang ditampilkan memodelkan waktu berdasarkan kondisi lalu lintas historis pada hari-hari dengan lalu lintas padat. Jenis ini memberikan perkiraan durasi yang kemungkinan besar lebih lama daripada waktu tempuh sebenarnya pada sebagian besar hari. Hari-hari tertentu dengan kondisi yang sangat buruk mungkin masih melebihi perkiraan ini.

    • OPTIMISTIC untuk meminta agar duration_in_traffic yang ditampilkan memodelkan waktu berdasarkan kondisi lalu lintas historis pada hari-hari dengan lalu lintas lancar. Jenis ini memberikan perkiraan durasi yang kemungkinan besar lebih singkat daripada waktu tempuh sebenarnya pada sebagian besar hari. Hari-hari tertentu dengan kondisi yang sangat baik mungkin masih lebih cepat dari perkiraan ini.

    Contoh: 

    "trafficModel": "OPTIMISTIC"

  5. 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 menentukan bahwa durasi harus diperkirakan menggunakan jenis model traffic 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 traffic OPTIMISTIC untuk perjalanan:

"duration": "1238s"

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

"duration": "2436s"