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

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

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

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

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

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

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

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

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

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

สภาพการจราจรจะแสดงลักษณะของอัตราการเคลื่อนตัวของการจราจร ดังนี้

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

  • การจราจรเบาบางถึงปานกลาง: การจราจรเริ่มติดขัด แต่รถยังเคลื่อนตัวได้ด้วยความเร็วที่ลดลง

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

ไม่ทราบการจราจร

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

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

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

คุณจะเห็นการตอบกลับต่อไปนี้

  • duration - มีเวลาถึงโดยประมาณสำหรับเส้นทาง

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

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

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

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

คุณจะเห็นการตอบกลับต่อไปนี้

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

  • staticDuration ETA สำหรับเส้นทางโดยพิจารณาเฉพาะข้อมูลการจราจรที่ผ่านมา

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

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

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

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

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

คุณจะเห็นการตอบกลับต่อไปนี้

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

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

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

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