กําหนดระดับของข้อมูลการเข้าชม

ค่ากําหนดการเข้าชมที่คุณเลือกจะปรับสมดุลความถูกต้องของรายละเอียดเส้นทางกับประสิทธิภาพคําขอด้วยวิธีใดวิธีหนึ่งต่อไปนี้

• คำนึงถึงจำนวนการเข้าชม -- แสดงผลลัพธ์ที่แม่นยำที่สุด (เวลาในการตอบสนองนานขึ้น)

• ไม่สนใจการเข้าชม -- แสดงผลลัพธ์โดยเร็วที่สุด (เวลาในการตอบสนองต่ำสุด)

เมื่อส่งคำขอ ให้พิจารณาว่าควรแสดงผลลัพธ์ที่ถูกต้องที่สุดหรือแสดงผลลัพธ์โดยเร็วที่สุด Routes API มีตัวเลือกที่ช่วยให้คุณควบคุมคุณภาพของข้อมูลการตอบกลับเทียบกับเวลาในการตอบสนองได้

วิธีตั้งค่าระดับการเข้าชม

Routes API มี RoutingPreference (REST) และ RoutingPreference (gRPC) ซึ่งให้คุณระบุค่ากำหนดการกำหนดเส้นทางสำหรับการคำนวณเส้นทางได้

ค่าเริ่มต้นคือผลลัพธ์ที่ไม่ทราบว่ามีการเข้าชม คุณเลือกตัวเลือกการเข้าชมได้ด้วยการกำหนดเส้นทาง TRAFFIC_UNAWARE, TRAFFIC_AWARE และ TRAFFIC_AWARE_OPTIMAL ค่ากำหนดการกำหนดเส้นทางแต่ละรายการจะให้ผลลัพธ์ที่แตกต่างกันในด้านคุณภาพเส้นทาง เวลาถึงโดยประมาณ และเวลาในการตอบสนอง

ข้อควรระวัง: ระบบจะเรียกเก็บเงินสำหรับคำขอที่ใช้ TRAFFIC_AWARE และ TRAFFIC_AWARE_OPTIMAL ในอัตราที่สูงขึ้น ดูข้อมูลเพิ่มเติมเกี่ยวกับการเรียกเก็บเงิน

สภาพการจราจร

สภาพการจราจรจะระบุอัตราการไหลของรถ

• การจราจรปกติ: ไม่มีการจราจรติดขัด การจราจรไหลลื่นด้วยความเร็วปกติ

• การจราจรเบาบางถึงปานกลาง: การจราจรหนาแน่นขึ้น โดยมีความเร็วในการสัญจรลดลง

• การจราจรหนาแน่น: ติดขัดอย่างหนัก ความเร็วการจราจรลดลงอย่างมาก

ไม่ทราบการเข้าชม

TRAFFIC_UNAWARE คือการตั้งค่าเริ่มต้น ใช้ค่ากำหนดการกำหนดเส้นทางนี้เมื่อคุณต้องการคำตอบที่เร็วที่สุด และรายละเอียดการกำหนดเส้นทางโดยประมาณก็เพียงพอแล้ว

ระบบจะคำนวณเส้นทาง TRAFFIC_UNAWARE โดยไม่คำนึงถึงสภาพการจราจรปัจจุบัน ค่ากำหนดการกำหนดเส้นทางนี้จะช่วยให้คำขอได้รับการตอบกลับเร็วที่สุด (เวลาในการตอบสนองต่ำสุด)

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

คําตอบที่คุณจะเห็นมีดังนี้

• duration - มีเวลาถึงโดยประมาณของเส้นทาง

• staticDuration: เวลาถึงโดยประมาณของเส้นทางที่พิจารณาเฉพาะข้อมูลการจราจรที่ผ่านมา สำหรับ TRAFFIC_UNAWARE ค่านี้มีค่าเดียวกับ duration

รับรู้การจราจร

ใช้ค่ากำหนดการกำหนดเส้นทางนี้เมื่อคุณต้องการรายละเอียดการกำหนดเส้นทางที่แม่นยำกว่าTRAFFIC_UNAWARE แต่คุณไม่สนใจหากการตอบกลับมีความล่าช้าเพิ่มขึ้นเล็กน้อย

เมื่อคุณตั้งค่าTRAFFIC_AWAREค่ากำหนดเส้นทาง บริการจะคำนวณเส้นทางโดยพิจารณาสภาพการจราจรปัจจุบัน ด้วยเหตุนี้ เส้นทางและรายละเอียดเส้นทางจึงแสดงสภาพเส้นทางจริงได้แม่นยำยิ่งขึ้น เนื่องจากคุณภาพข้อมูลที่เพิ่มขึ้นนี้ทำให้เวลาในการตอบสนองช้าลง จึงมีการเพิ่มประสิทธิภาพเพื่อลดเวลาในการตอบสนอง

คําตอบที่คุณจะเห็นมีดังนี้

• duration: เวลาถึงโดยประมาณที่พิจารณาข้อมูลการจราจรแบบเรียลไทม์

• staticDuration เวลาถึงโดยประมาณของเส้นทางที่พิจารณาเฉพาะข้อมูลการจราจรที่ผ่านมา

เพิ่มประสิทธิภาพโดยคำนึงถึงการเข้าชม

ใช้ค่ากำหนดการกำหนดเส้นทางนี้เมื่อคุณต้องการผลลัพธ์ที่มีคุณภาพสูงสุดโดยไม่คำนึงถึงระยะเวลาในการตอบกลับ ค่ากำหนดการกำหนดเส้นทางนี้มีความล่าช้านานที่สุดในการส่งคำตอบ (เวลาในการตอบสนองสูงสุด)

เมื่อคุณตั้งค่าTRAFFIC_AWARE_OPTIMALค่ากำหนดการกำหนดเส้นทาง บริการจะคำนวณเส้นทางโดยพิจารณาสภาพการจราจรปัจจุบัน แต่ไม่ใช้การเพิ่มประสิทธิภาพ ในโหมดนี้ เซิร์ฟเวอร์จะค้นหาเครือข่ายถนนอย่างละเอียดมากขึ้นเพื่อหาเส้นทางที่ดีที่สุด

ค่ากำหนดเส้นทาง TRAFFIC_AWARE_OPTIMAL เทียบเท่ากับโหมดที่ใช้โดย maps.google.com และแอป Google Maps บนอุปกรณ์เคลื่อนที่

เมื่อใช้ตัวเลือกนี้กับ Compute Route Matrix จำนวนองค์ประกอบในคําขอ (จํานวนต้นทาง × จํานวนปลายทาง) ต้องไม่เกิน

1. ดูข้อมูลเพิ่มเติมเกี่ยวกับขีดจํากัดของเมทริกซ์เส้นทางใน Compute ได้ที่คํานวณเมทริกซ์เส้นทาง

คําตอบที่คุณจะเห็นมีดังนี้

• duration: เวลาถึงโดยประมาณของเส้นทางโดยพิจารณาจากข้อมูลการจราจรแบบเรียลไทม์

• staticDuration: เวลาถึงโดยประมาณของเส้นทางที่พิจารณาเฉพาะข้อมูลการจราจรที่ผ่านมา

ตั้งเวลาออกเดินทาง (ไม่บังคับ)

ใช้พร็อพเพอร์ตี้นี้เฉพาะกับคำขอที่คำนึงถึงการจราจรซึ่งเวลาออกเดินทางต้องอยู่ในอนาคต หากคุณไม่ได้ตั้งค่าพร็อพเพอร์ตี้ departureTime ระบบจะใช้เวลาที่คุณส่งคำขอเป็นค่าเริ่มต้น

ใช้พร็อพเพอร์ตี้ departureTime ร่วมกับตัวเลือก TRAFFIC_AWARE และ TRAFFIC_AWARE_OPTIMAL เมื่อคุณต้องการปรับวิธีบริการคาดการณ์การจราจรเมื่อเลือกเส้นทาง

• TRAFFIC_UNAWARE: ไม่แนะนำเนื่องจากการเลือกเส้นทางและเวลาเดินทางจะอิงตามเครือข่ายถนนและสภาพการจราจรโดยเฉลี่ยที่ไม่ขึ้นอยู่กับเวลา

• TRAFFIC_AWARE และ TRAFFIC_AWARE_OPTIMAL: แนะนำสำหรับการออกเดินทางที่จะเกิดขึ้นในอนาคตอันใกล้ เนื่องจากค่ากำหนดเหล่านี้จะพิจารณาสภาพการจราจรปัจจุบัน การเข้าชมแบบเรียลไทม์จะยิ่งมีความสําคัญและมีความเกี่ยวข้องมากขึ้นเมื่อ departureTime อยู่ใกล้กับ "ตอนนี้" ยิ่งคุณตั้งเวลาออกเดินทางล่วงหน้านานเท่าใด ระบบก็จะพิจารณาสภาพการจราจรที่ผ่านมามากขึ้นในการเลือกเส้นทาง

ตัวอย่าง: วิธีเลือกการกำหนดเส้นทางที่คำนึงถึงสภาพการจราจร

โค้ด JSON ต่อไปนี้แสดงวิธีตั้งค่าTRAFFIC_AWARE_OPTIMALตัวเลือกการกำหนดเส้นทางในเนื้อหาเอนทิตีข้อความคำขอ

{
  "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 ช่วยให้คุณขอข้อมูลเกี่ยวกับสภาพการจราจรได้ตลอดเส้นประกอบที่คำนึงถึงการจราจร ดูข้อมูลเพิ่มเติมได้ที่ขอเส้นประกอบ