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

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

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

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

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

วิธีตั้งค่าระดับการรับส่งข้อมูล

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

ค่าเริ่มต้นคือผลลัพธ์ที่ไม่คำนึงถึงการรับส่งข้อมูล คุณเลือกตัวเลือกการจราจรด้วยค่ากำหนดการกำหนดเส้นทาง TRAFFIC_UNAWARE, 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 ระบบจะจำกัดจำนวนองค์ประกอบในคำขอ (จำนวนต้นทาง × จำนวนปลายทาง) ดูข้อมูลเพิ่มเติมเกี่ยวกับการจำกัดของ Compute Route Matrix ได้ที่หัวข้อ คำนวณเมทริกซ์เส้นทาง

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

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