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

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

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

โดยค่าเริ่มต้น ทั้ง 2 วิธีจะใช้ประเภทรูปแบบการเข้าชม BEST_GUESS

วิธีระบุประเภทการเข้าชม

  1. กำหนดต้นทางและปลายทาง

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

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

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

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

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

    ตัวอย่างเช่น 

    "trafficModel": "OPTIMISTIC"

  4. ระบุช่อง 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"