ค่ากำหนดการจราจรที่คุณเลือกจะสร้างความสมดุลระหว่างความแม่นยำของรายละเอียดเส้นทางกับประสิทธิภาพของคำขอ เมื่อส่งคำขอ คุณควรพิจารณาว่าควรแสดงผลลัพธ์ที่ถูกต้องที่สุดเท่าที่จะเป็นไปได้ หรือแสดงผลลัพธ์ให้เร็วที่สุด Routes API มีตัวเลือกที่ช่วยให้คุณควบคุมคุณภาพของข้อมูลการตอบกลับเทียบกับเวลาในการตอบสนองได้
ตั้งค่าระดับข้อมูลการเข้าชม
Routes API มี RoutingPreference (REST) และ RoutingPreference (gRPC) ซึ่งให้คุณระบุค่ากำหนดการกำหนดเส้นทางสำหรับการคำนวณเส้นทางได้ ค่ากําหนดเหล่านี้จะแตกต่างกันไปตามระดับที่พิจารณาสภาพการจราจรในการคำนวณเส้นทาง ค่ากำหนดการกำหนดเส้นทางแต่ละรายการจะให้ผลลัพธ์ที่แตกต่างกันในระดับหนึ่งในด้านคุณภาพเส้นทาง เวลาถึงโดยประมาณ และเวลาในการตอบสนอง
สภาพการจราจรจะระบุอัตราการไหลของการเข้าชม เช่น
- เมื่อไม่มีความแออัด ระบบจะถือว่าสภาพการจราจรเป็นปกติ และรถจะวิ่งด้วยความเร็วปกติแบบไม่ติดขัด
- เมื่อใกล้ถึงช่วงเร่งด่วน ความหนาแน่นของการจราจรจะเพิ่มขึ้น ซึ่งทำให้การจราจรช้าลง ทำให้เกิดสภาพการจราจรเบาบางถึงปานกลาง
- เมื่อรถติดขัด อัตราการเข้าชมจะหยุดชะงัก ทำให้เกิดความแออัด
ไม่ทราบการจราจร
เมื่อคุณตั้งค่าTRAFFIC_UNAWARE
ค่ากำหนดการกำหนดเส้นทาง ระบบจะคำนวณเส้นทางโดยไม่คำนึงถึงสภาพการจราจรปัจจุบัน ค่ากำหนดการกำหนดเส้นทางนี้ช่วยลดเวลาในการตอบสนองต่ำสุด (การตอบกลับจะแสดงเร็วที่สุด)
TRAFFIC_UNAWARE
คือการตั้งค่าเริ่มต้น
ในการตอบกลับ
เวลาถึงโดยประมาณอยู่ในพร็อพเพอร์ตี้คำตอบ
duration
พร็อพเพอร์ตี้คำตอบ
duration
และstaticDuration
มีค่าเดียวกัน
ใช้ค่ากำหนดการกำหนดเส้นทางนี้เมื่อคุณต้องการให้ระบบแสดงคำตอบที่เร็วที่สุด และรายละเอียดการกำหนดเส้นทางโดยประมาณก็เพียงพอแล้ว
รับรู้การจราจร
เมื่อคุณตั้งค่าTRAFFIC_AWARE
ค่ากำหนดการกำหนดเส้นทาง ระบบจะคำนวณเส้นทางโดยคำนึงถึงสภาพการจราจรปัจจุบัน ด้วยเหตุนี้ เส้นทางและรายละเอียดเส้นทางจึงแสดงสภาพเส้นทางจริงได้แม่นยำยิ่งขึ้น เนื่องจากคุณภาพข้อมูลที่เพิ่มขึ้นนี้ทำให้เวลาในการตอบสนองช้าลง จึงมีการเพิ่มประสิทธิภาพเพื่อลดเวลาในการตอบสนอง
ในการตอบกลับ
ETA ที่ต้องพิจารณาการเข้าชมแบบเรียลไทม์อยู่ในพร็อพเพอร์ตี้การตอบสนอง
duration
พร็อพเพอร์ตี้การตอบสนอง
staticDuration
ประกอบด้วยระยะเวลาในการเดินทางผ่านเส้นทางโดยไม่พิจารณาสภาพการจราจร
ใช้การตั้งค่าการกำหนดเส้นทางนี้เมื่อคุณต้องการรายละเอียดการกำหนดเส้นทางที่แม่นยำมากกว่า TRAFFIC_UNAWARE
และคุณยังไม่สนใจหากระบบแสดงผลคำตอบโดยมีเวลาในการตอบสนองที่เพิ่มขึ้นปานกลาง
เพิ่มประสิทธิภาพโดยคำนึงถึงการเข้าชม
เมื่อตั้งค่าการกำหนดเส้นทางของ TRAFFIC_AWARE_OPTIMAL
ระบบจะคำนวณเส้นทางโดยพิจารณาจากสภาพการจราจรปัจจุบัน แต่จะไม่มีการเพิ่มประสิทธิภาพด้านประสิทธิภาพ ในโหมดนี้ เซิร์ฟเวอร์จะค้นหาเครือข่ายถนนอย่างละเอียดมากขึ้นเพื่อหาเส้นทางที่ดีที่สุด
ค่ากำหนดเส้นทาง TRAFFIC_AWARE_OPTIMAL
เทียบเท่ากับโหมดที่ใช้โดย maps.google.com และแอป Google Maps บนอุปกรณ์เคลื่อนที่
เมื่อใช้ตัวเลือกนี้กับ Compute Route Matrix จำนวนองค์ประกอบในคำขอ (จำนวนต้นทาง × จำนวนปลายทาง) ต้องไม่เกิน 100 ดูข้อมูลเพิ่มเติมเกี่ยวกับขีดจํากัดของเมทริกซ์เส้นทางใน Compute ได้ที่คํานวณเมทริกซ์เส้นทาง
ในการตอบกลับ:
ETA ที่ต้องพิจารณาการเข้าชมแบบเรียลไทม์อยู่ในพร็อพเพอร์ตี้การตอบสนอง
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 ช่วยให้คุณขอข้อมูลเกี่ยวกับสภาพการจราจรได้ตลอดเส้นประกอบที่คำนึงถึงการจราจร ดูข้อมูลเพิ่มเติมได้ที่ขอเส้นประกอบ