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