ค่ากำหนดการจราจรที่คุณเลือกจะปรับสมดุลความแม่นยำของรายละเอียดเส้นทางกับประสิทธิภาพคำขอ เมื่อส่งคำขอ คุณควรพิจารณาว่าควรแสดงผลลัพธ์ที่ถูกต้องที่สุดเท่าที่จะเป็นไปได้ หรือแสดงผลลัพธ์ให้เร็วที่สุด Routes API มีตัวเลือกที่ช่วยให้คุณควบคุมคุณภาพของข้อมูลการตอบกลับเทียบกับเวลาในการตอบสนองได้
ตั้งค่าระดับข้อมูลการเข้าชม
Routes API มี RoutingPreference (REST) และ RoutingPreference (gRPC) ซึ่งให้คุณระบุค่ากำหนดการกำหนดเส้นทางสำหรับการคำนวณเส้นทางได้ ค่ากําหนดเหล่านี้จะแตกต่างกันไปตามระดับที่พิจารณาสภาพการจราจรในการคำนวณเส้นทาง ค่ากำหนดการกำหนดเส้นทางแต่ละรายการจะให้ผลลัพธ์ที่แตกต่างกันในระดับหนึ่งในด้านคุณภาพเส้นทาง เวลาถึงโดยประมาณโดยประมาณ และเวลาในการตอบสนอง
สภาพการจราจรจะระบุอัตราการไหลของรถ เช่น
- เมื่อไม่มีความแออัด ระบบจะถือว่าสภาพการจราจรเป็นปกติ และรถจะวิ่งด้วยความเร็วปกติแบบไม่ติดขัด
- เมื่อใกล้ถึงช่วงเร่งด่วน ความหนาแน่นของการจราจรจะเพิ่มขึ้น ซึ่งทำให้การจราจรช้าลง ทำให้เกิดสภาพการจราจรเบาบางถึงปานกลาง
- เมื่อมีรถติดขัด อัตราการไหลจะหยุดชะงัก ทำให้เกิดความแออัด
ไม่ทราบการเข้าชม
เมื่อคุณตั้งค่าTRAFFIC_UNAWARE
ค่ากำหนดการกำหนดเส้นทาง ระบบจะคำนวณเส้นทางโดยไม่คำนึงถึงสภาพการจราจรปัจจุบัน ค่ากำหนดการกำหนดเส้นทางนี้ช่วยลดเวลาในการตอบสนองต่ำสุด (ระบบจะแสดงคำตอบเร็วที่สุด)
TRAFFIC_UNAWARE
คือการตั้งค่าเริ่มต้น
ในการตอบกลับ
เวลาถึงโดยประมาณอยู่ในพร็อพเพอร์ตี้การตอบกลับ
duration
พร็อพเพอร์ตี้คำตอบ
duration
และstaticDuration
มีค่าเดียวกัน
ใช้ค่ากำหนดการกำหนดเส้นทางนี้เมื่อคุณต้องการให้ระบบแสดงคำตอบที่เร็วที่สุด และรายละเอียดการกำหนดเส้นทางโดยประมาณก็เพียงพอแล้ว
รับรู้การจราจร
เมื่อคุณตั้งค่าTRAFFIC_AWARE
ค่ากำหนดการกำหนดเส้นทาง ระบบจะคำนวณเส้นทางโดยคำนึงถึงสภาพการจราจรปัจจุบัน ด้วยเหตุนี้ เส้นทางและรายละเอียดเส้นทางจึงแสดงสภาพเส้นทางจริงได้แม่นยำยิ่งขึ้น เนื่องจากคุณภาพข้อมูลที่เพิ่มขึ้นนี้ทำให้เวลาในการตอบสนองช้าลง จึงมีการเพิ่มประสิทธิภาพเพื่อลดเวลาในการตอบสนอง
ในการตอบกลับ
เวลาถึงโดยประมาณที่คำนึงถึงสภาพการจราจรแบบเรียลไทม์จะอยู่ในพร็อพเพอร์ตี้คำตอบ
duration
พร็อพเพอร์ตี้การตอบกลับ
staticDuration
มีระยะเวลาการเดินทางผ่านเส้นทางโดยไม่คำนึงถึงสภาพการจราจร
ใช้ค่ากำหนดการกำหนดเส้นทางนี้เมื่อคุณต้องการรายละเอียดการกำหนดเส้นทางที่แม่นยำกว่าTRAFFIC_UNAWARE
แต่คุณไม่สนใจหากการตอบกลับมีความล่าช้าเพิ่มขึ้นเล็กน้อย
เพิ่มประสิทธิภาพโดยคำนึงถึงการเข้าชม
เมื่อคุณตั้งค่าTRAFFIC_AWARE_OPTIMAL
ค่ากำหนดการกำหนดเส้นทาง ระบบจะคำนวณเส้นทางโดยพิจารณาสภาพการจราจรปัจจุบัน แต่ไม่ใช้การเพิ่มประสิทธิภาพ ในโหมดนี้ เซิร์ฟเวอร์จะค้นหาเครือข่ายถนนอย่างละเอียดมากขึ้นเพื่อหาเส้นทางที่ดีที่สุด
ค่ากำหนดเส้นทาง TRAFFIC_AWARE_OPTIMAL
เทียบเท่ากับโหมดที่ใช้โดย maps.google.com และแอป Google Maps บนอุปกรณ์เคลื่อนที่
เมื่อใช้ตัวเลือกนี้กับ Compute Route Matrix จํานวนองค์ประกอบในคําขอ (จํานวนต้นทาง × จํานวนปลายทาง) ต้องไม่เกิน 100 ดูข้อมูลเพิ่มเติมเกี่ยวกับขีดจํากัดของเมทริกซ์เส้นทางใน Compute ได้ที่คํานวณเมทริกซ์เส้นทาง
ในการตอบกลับ
เวลาถึงโดยประมาณที่คำนึงถึงสภาพการจราจรแบบเรียลไทม์จะอยู่ในพร็อพเพอร์ตี้คำตอบ
duration
พร็อพเพอร์ตี้การตอบกลับ
staticDuration
มีระยะเวลาการเดินทางผ่านเส้นทางโดยไม่คำนึงถึงสภาพการจราจร
ค่ากำหนดการกำหนดเส้นทางนี้จะมีความล่าช้าในการตอบกลับสูงสุด (กล่าวคือ คำตอบจะแสดงขึ้นโดยมีความล่าช้านานที่สุด) ใช้ค่ากำหนดการกำหนดเส้นทางนี้เมื่อคุณต้องการผลลัพธ์ที่มีคุณภาพสูงสุดโดยไม่คำนึงถึงระยะเวลาในการตอบกลับ
ผลของการตั้งค่าเวลาออกเดินทาง
คุณใช้พร็อพเพอร์ตี้ departureTime
เพื่อตั้งค่าเวลาออกเดินทางของการเดินทางได้ (ไม่บังคับ) หากคุณไม่ได้ตั้งค่าพร็อพเพอร์ตี้ departureTime
ค่าเริ่มต้นจะเป็นเวลาที่ส่งคำขอ
สำหรับ
TRAFFIC_UNAWARE
คุณจะตั้งค่าdepartureTime
ไม่ได้ เนื่องจากการเลือกเส้นทางและระยะเวลาจะอิงตามเครือข่ายถนนและสภาพการจราจรโดยเฉลี่ยที่ไม่ขึ้นอยู่กับเวลาสําหรับ
TRAFFIC_AWARE
และTRAFFIC_AWARE_OPTIMAL
ซึ่งพิจารณาสภาพการเข้าชมแบบเรียลไทม์ การเข้าชมแบบเรียลไทม์จะยิ่งสําคัญมากขึ้นเมื่อdepartureTime
อยู่ใกล้กับปัจจุบันมากขึ้น ยิ่งคุณตั้งค่าเวลาออกเดินทางในอนาคตนานเท่าใด ระบบก็จะพิจารณาสภาพการเข้าชมที่ผ่านมามากขึ้นเท่านั้น
ตัวอย่างการตั้งค่ากำหนดเส้นทาง
โค้ด JSON ต่อไปนี้แสดงวิธีตั้งค่ากำหนดเส้นทางในเนื้อหาเอนทิตีข้อความคำขอ
{ "origin":{ "location":{ "latLng":{ "latitude":37.419734, "longitude":-122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude":37.417670, "longitude":-122.079595 } } }, "travelMode":"DRIVE", "routingPreference":"TRAFFIC_AWARE_OPTIMAL" }
กำหนดค่าการจราจรบนเส้นประกอบ
Routes API ช่วยให้คุณขอข้อมูลเกี่ยวกับสภาพการจราจรได้ตลอดเส้นประกอบที่คำนึงถึงการจราจร ดูข้อมูลเพิ่มเติมได้ที่ขอเส้นประกอบ