Menentukan jenis model traffic yang akan digunakan

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 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, nilai defaultnya adalah sekarang.

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

    • BEST_GUESS (default) untuk meminta duration_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 jika departure_time semakin dekat ke waktu sekarang. Menggunakan jenis default dari BEST_GUESS memberikan prediksi yang paling berguna untuk sebagian besar kasus penggunaan.

    • PESSIMISTIC untuk meminta agar duration_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 agar 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 tempuh yang sebenarnya hampir setiap hari. Hari-hari tertentu dengan kondisi yang baik mungkin masih lebih cepat dari 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 lalu lintas, Routes API menggunakan lalu lintas jenis model 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"