โมเดลการจราจรใช้อัลกอริทึมและปัจจัยที่เฉพาะเจาะจงเพื่อคาดการณ์ว่าเงื่อนไขการจราจรจะส่งผลต่อระยะเวลารวมที่ใช้เดินทางในเส้นทางนั้นๆ อย่างไร Routes API มีโมเดลการเข้าชมประเภทต่างๆ เพื่อจัดลําดับความสําคัญของปัจจัยต่างๆ ที่ใช้ในการคํานวณระยะเวลาในการเข้าชม คุณสามารถระบุประเภทโมเดลการจราจรที่คุณต้องการให้เส้นทางใช้ เมื่อคำนวณระยะเวลาสำหรับเส้นทางหรือเมทริกซ์เส้นทางของคุณ เมื่อคุณกำหนดประเภทรูปแบบการเข้าชม ค่าที่แสดงผลในช่อง duration
จะแตกต่างกันไปตามรูปแบบการเข้าชมที่คุณเลือก
ทั้งเมธอด Routes API Compute Routes
และ Compute Route Matrix
รองรับประเภทโมเดลการรับส่งข้อมูล
โดยค่าเริ่มต้น ทั้ง 2 วิธีจะใช้รูปแบบการเข้าชมประเภทBEST_GUESS
เพื่อระบุประเภทการเข้าชม
กำหนดต้นทางและจุดหมาย
หากเวลาออกเดินทางเป็นเวลาในอนาคต ให้ระบุเวลาโดยใช้พารามิเตอร์
departure_time
หากคุณไม่ระบุเวลาออกเดินทาง ค่าเริ่มต้นจะเป็นตอนนี้เลือกรูปแบบการเข้าชมที่จะใช้กับพารามิเตอร์
trafficModel
และประเภทใดประเภทหนึ่งต่อไปนี้BEST_GUESS
(ค่าเริ่มต้น) เพื่อขอให้duration_in_traffic
ที่แสดงผลเป็นเวลาเดินทางโดยประมาณที่ดีที่สุดตามข้อมูลที่ทราบเกี่ยวกับสภาพการจราจรที่ผ่านมาและการเข้าชมแบบเรียลไทม์ ข้อมูลการจราจรสดจะยิ่ง มีความสำคัญมากขึ้นเมื่อdeparture_time
อยู่ใกล้ขึ้น การใช้ประเภทBEST_GUESS
เริ่มต้นจะให้การคาดการณ์ที่เป็นประโยชน์มากที่สุดสำหรับ Use Case ส่วนใหญ่PESSIMISTIC
เพื่อขอให้duration_in_traffic
ที่แสดงผลจำลองเวลาตามสภาพการจราจรที่ผ่านมาในวันที่มีการเข้าชมที่ไม่ดี ประเภทนี้จะให้ระยะเวลาโดยประมาณที่น่าจะนานกว่าระยะเวลาเดินทางจริงในเกือบทุกวัน วันที่อาจมีสภาพไม่ดีในบางครั้ง อาจยังคงเกินค่าประมาณนี้ได้OPTIMISTIC
เพื่อขอให้duration_in_traffic
ที่แสดงผลจำลองเวลาตามสภาพการจราจรที่ผ่านมาในวันที่มีการเข้าชมที่ดี ประเภทนี้จะให้ระยะเวลาโดยประมาณที่มีแนวโน้มว่าจะสั้นกว่าระยะเวลาเดินทางจริงในเกือบทุกวัน วันที่เป็นครั้งคราวซึ่งมีสภาวะที่ดีเป็นพิเศษอาจยังเร็วกว่าค่าประมาณนี้
ตัวอย่างเช่น
"trafficModel": "OPTIMISTIC"
ระบุช่อง
routes.duration
ในมาสก์ของช่องพัก
-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"