Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

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

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

ผลิตภัณฑ์หรือฟีเจอร์นี้เป็นเวอร์ชันทดลอง (ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป) ผลิตภัณฑ์และฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอาจมีการรองรับที่จำกัด และการเปลี่ยนแปลงผลิตภัณฑ์และ ฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอาจไม่เข้ากันกับเวอร์ชันก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอื่นๆ ข้อเสนอก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอยู่ภายใต้ข้อกำหนดเฉพาะของบริการ Google Maps Platform ดูข้อมูลเพิ่มเติมได้ที่ คำอธิบายเกี่ยวกับระยะการเปิดตัว

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

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

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

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

กำหนดต้นทางและปลายทาง
หากเวลาออกเดินทางเป็นเวลาในอนาคต ให้ระบุเวลาโดยใช้พารามิเตอร์ departure_time หากไม่ระบุเวลาออกเดินทาง ระบบจะใช้เวลาปัจจุบันเป็นค่าเริ่มต้น
ตั้งค่าพารามิเตอร์ routingPreference เป็น TRAFFIC_AWARE_OPTIMAL การตั้งค่า routingPreference เป็น TRAFFIC_UNAWARE หรือ TRAFFIC_AWARE ใช้ร่วมกับพารามิเตอร์ trafficModel ไม่ได้
เลือกรูปแบบการเข้าชมที่จะใช้กับพารามิเตอร์ trafficModel และ ประเภทใดประเภทหนึ่งต่อไปนี้
- BEST_GUESS (ค่าเริ่มต้น) เพื่อขอให้ duration_in_traffic ที่ส่งคืนเป็นค่าประมาณเวลาเดินทางที่ดีที่สุดตามข้อมูลที่ทราบเกี่ยวกับทั้ง สภาพการจราจรในอดีตและการจราจรแบบเรียลไทม์ สภาพการจราจรแบบเรียลไทม์จะมีความสำคัญมากขึ้นเมื่อdeparture_timeใกล้กับเวลาปัจจุบัน การใช้ประเภทเริ่มต้น ของ BEST_GUESS จะให้การคาดการณ์ที่มีประโยชน์มากที่สุดสำหรับ Use Case ส่วนใหญ่
- PESSIMISTIC เพื่อขอให้โมเดลที่ส่งคืนduration_in_trafficคำนวณเวลา โดยอิงตามสภาพการจราจรที่ผ่านมาในวันที่การจราจรติดขัด ประเภทนี้จะให้ระยะเวลาโดยประมาณที่นานกว่า เวลาเดินทางจริงในวันส่วนใหญ่ ในบางวันที่สภาพอากาศแย่เป็นพิเศษ ค่าใช้จ่ายอาจยังคงเกินประมาณการนี้
- OPTIMISTIC เพื่อขอให้โมเดล duration_in_traffic ที่ส่งคืนมาคำนวณเวลาโดยอิงตามสภาพการจราจรในอดีตในวันที่การจราจรดี ประเภทนี้จะให้ระยะเวลาโดยประมาณซึ่งสั้นกว่า เวลาเดินทางจริงในวันส่วนใหญ่ ในวันที่สภาพอากาศดีเป็นพิเศษบางวัน อาจยังคงเร็วกว่าค่าประมาณนี้
เช่น
```
"trafficModel": "OPTIMISTIC"
```
หมายเหตุ: BEST_GUESSการคาดคะเนเวลาเดินทางอาจสั้นกว่า OPTIMISTIC หรือยาวกว่า PESSIMISTIC เนื่องจากวิธีที่ BEST_GUESSผสานรวมข้อมูลการจราจรแบบเรียลไทม์
ระบุฟิลด์ 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"