โมเดลการจราจรใช้อัลกอริทึมและปัจจัยที่เฉพาะเจาะจงเพื่อคาดการณ์ว่าเงื่อนไขการจราจรส่งผลต่อระยะเวลาเดินทางทั้งหมดของเส้นทางที่กำหนดอย่างไร 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
จะให้การคาดการณ์ที่มีประโยชน์มากที่สุดสำหรับการใช้งานส่วนใหญ่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"