ระบุประเภทโมเดลการเข้าชมที่จะใช้

โมเดลการจราจรใช้อัลกอริทึมและปัจจัยที่เฉพาะเจาะจงเพื่อคาดการณ์ว่าสภาพการจราจรจะส่งผลต่อระยะเวลาเดินทางทั้งหมดของเส้นทางที่กำหนดอย่างไร Routes API มีโมเดลการจราจรหลายประเภทเพื่อจัดลำดับความสำคัญของปัจจัยต่างๆ ที่ใช้ในการคำนวณระยะเวลาในการจราจร คุณสามารถระบุประเภทโมเดลการจราจรที่ต้องการให้เส้นทางใช้เมื่อคำนวณระยะเวลาของเส้นทางหรือเมทริกซ์เส้นทาง เมื่อตั้งค่าประเภทโมเดลการจราจร ค่าที่แสดงในช่อง duration จะแตกต่างกันไปตามโมเดลการจราจรที่คุณเลือก

ทั้งเมธอด Compute Routes และ Compute Route Matrix ของ Routes API รองรับประเภทโมเดลการจราจร

โดยค่าเริ่มต้น ทั้ง 2 เมธอดจะใช้ประเภทโมเดลการจราจร BEST_GUESS

วิธีระบุประเภทการจราจร

1. ตั้งค่าจุดเริ่มต้นและจุดหมาย

2. หากเวลาออกเดินทางอยู่ในอนาคต ให้ระบุเวลาโดยใช้พารามิเตอร์ departure_time หากไม่ระบุเวลาออกเดินทาง ระบบจะใช้เวลาปัจจุบันเป็นค่าเริ่มต้น

3. ตั้งค่าพารามิเตอร์ routingPreference เป็น TRAFFIC_AWARE_OPTIMAL การตั้งค่า routingPreference เป็น TRAFFIC_UNAWARE หรือ TRAFFIC_AWARE ไม่เข้ากันกับพารามิเตอร์ trafficModel

4. เลือกโมเดลการจราจรที่จะใช้กับพารามิเตอร์ trafficModel และประเภทใดประเภทหนึ่งต่อไปนี้

   • BEST_GUESS (ค่าเริ่มต้น) เพื่อขอให้ duration_in_traffic ที่แสดงเป็นค่าประมาณที่ดีที่สุดของระยะเวลาเดินทางโดยพิจารณาจากข้อมูลสภาพการจราจรในอดีตและสภาพการจราจรแบบเรียลไทม์ สภาพการจราจรแบบเรียลไทม์จะมีความสำคัญมากขึ้นเมื่อ departure_time ใกล้เคียงกับเวลาปัจจุบัน การใช้ประเภท BEST_GUESS เป็นค่าเริ่มต้นจะให้การคาดการณ์ที่เป็นประโยชน์มากที่สุดสำหรับ Use Case ส่วนใหญ่

   • PESSIMISTIC เพื่อขอให้ duration_in_traffic ที่แสดงเป็นค่าประมาณเวลาโดยอิงตามสภาพการจราจรในอดีตในวันที่การจราจรไม่ดี ประเภทนี้จะให้ระยะเวลาโดยประมาณที่นานกว่า ระยะเวลาเดินทางจริงในวันส่วนใหญ่ บางวันที่มีสภาพการจราจรแย่เป็นพิเศษอาจใช้เวลานานกว่าค่าประมาณนี้

   • OPTIMISTIC เพื่อขอให้ duration_in_traffic ที่แสดงเป็นค่าประมาณเวลาโดยอิงตามสภาพการจราจรในอดีตในวันที่การจราจรดี ประเภทนี้จะให้ระยะเวลาโดยประมาณที่สั้นกว่า ระยะเวลาเดินทางจริงในวันส่วนใหญ่ บางวันที่มีสภาพการจราจรดีเป็นพิเศษอาจใช้เวลาเดินทางเร็วกว่าค่าประมาณนี้

   เช่น

   "trafficModel": "OPTIMISTIC"

5. ระบุช่อง routes.duration ในมาสก์ของช่อง

   REST

   -H X-Goog-FieldMask: routes.duration

   RPC

   const (fieldMask = "routes.duration")

เมื่อ Routes API ประมาณเวลาในการจราจร ระบบจะใช้ประเภทโมเดลการจราจรที่คุณขอ

ตัวอย่าง: คำขอโมเดลการจราจร

ตัวอย่างเช่น คำขอนี้ระบุให้ประมาณระยะเวลาโดยใช้ประเภทโมเดลการจราจร OPTIMISTIC ในเวลาออกเดินทางที่เฉพาะเจาะจง

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'

คำขอนี้จะแสดงระยะเวลาโดยประมาณโดยใช้ประเภทโมเดลการจราจร OPTIMISTIC สำหรับการเดินทาง

"duration": "1238s"

หากคุณเปลี่ยนประเภทโมเดลการจราจรเป็น PESSIMISTIC ระยะเวลาที่แสดงจะนานขึ้น

"duration": "2436s"