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

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

ทั้ง Routes API Compute Routes และ วิธี Compute Route Matrix รองรับประเภทรูปแบบการเข้าชม

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

เพื่อระบุประเภทการเข้าชม

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

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

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

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

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

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

    เช่น 

    "trafficModel": "OPTIMISTIC"

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