ทำความเข้าใจการตรวจสอบเส้นทาง

หลังจากสร้างเส้นทางแล้ว Roads Selection API จะดำเนินการตรวจสอบ การตรวจสอบนี้ช่วยให้มั่นใจได้ว่าเส้นทางนั้นเหมาะสำหรับการเก็บรวบรวมและอัปเดตข้อมูล ภายในข้อมูลเชิงลึกด้านการจัดการถนน โดยปกติแล้วกระบวนการนี้จะใช้เวลาไม่กี่นาที

คุณสามารถตรวจสอบสถานะการตรวจสอบเส้นทางผ่านฟิลด์ state ในการตอบกลับของ API คุณตรวจสอบได้โดยใช้ปลายทาง get ตามที่อธิบายไว้ในรับเส้นทางที่เลือก หรือโดยการตรวจสอบตาราง routes_status ใน BigQuery

สถานะเส้นทาง

ฟิลด์ state ในทรัพยากร SelectedRoute จะระบุสถานะการตรวจสอบและการดำเนินการปัจจุบัน ฟิลด์ state อาจมีค่าต่อไปนี้

• STATE_UNSPECIFIED: ไม่ได้ตั้งค่าสถานะการตรวจสอบเส้นทางนี้
• STATE_VALIDATING: กำลังตรวจสอบเส้นทาง
• STATE_RUNNING: เส้นทางผ่านการตรวจสอบเรียบร้อยแล้วและตอนนี้ ใช้งานได้แล้ว API กําลังรวบรวมข้อมูลและส่งข้อมูลอัปเดตเป็นระยะๆ สําหรับเส้นทางนี้ไปยัง BigQuery, Pub/Sub หรือทั้ง 2 อย่าง
• STATE_DELETING: มีการทำเครื่องหมายเส้นทางเพื่อลบและกำลัง นำออกจากระบบ
• STATE_INVALID: เส้นทางไม่ผ่านการตรวจสอบตามเกณฑ์ที่เฉพาะเจาะจง เมื่อเส้นทางอยู่ในสถานะ STATE_INVALID การตอบกลับจะมีฟิลด์ validationError พร้อมรายละเอียดเกี่ยวกับสาเหตุที่การตรวจสอบไม่สำเร็จ

ข้อผิดพลาดเกี่ยวกับการตรวจสอบความถูกต้อง

เมื่อ state ของทรัพยากร SelectedRoute เป็น STATE_INVALID การตอบกลับของ API จะมีฟิลด์ validationError ฟิลด์นี้ระบุ เหตุผลที่เฉพาะเจาะจงสำหรับการตรวจสอบไม่สำเร็จ

ฟิลด์ validationError อาจมีค่าต่อไปนี้

• VALIDATION_ERROR_UNSPECIFIED: ไม่ได้ตั้งค่าข้อผิดพลาดในการตรวจสอบเส้นทางนี้
• VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: เส้นทางอยู่นอกเขตอำนาจที่ได้รับอนุญาตของโปรเจ็กต์
• VALIDATION_ERROR_LOW_ROAD_USAGE: เส้นทางนี้มีการใช้งานถนนน้อย หมายความว่าสามารถรวบรวมข้อมูลการจราจรได้ไม่เพียงพอสำหรับการวิเคราะห์ที่มีความหมาย เส้นทางที่จัดว่าไม่ถูกต้องเนื่องจากมีการใช้งานถนนต่ำอาจกลับมาถูกต้องอีกครั้งหากปริมาณการจราจรเพิ่มขึ้นสูงกว่าเกณฑ์ที่กำหนดไว้ล่วงหน้า ดูข้อมูลเพิ่มเติมในเส้นทางที่ใช้ถนนที่มีการจราจรน้อย

เส้นทางที่มีการใช้ถนนน้อย

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

สิ่งที่จะเกิดขึ้นสำหรับเส้นทางที่มีการใช้ถนนต่ำมีดังนี้

• การเผยแพร่ข้อมูลไปยัง BigQuery จะยังคงดำเนินต่อไป: แม้ว่าเส้นทางจะได้รับการจัดประเภทเป็น STATE_INVALID เนื่องจากมีการใช้งานถนนต่ำ แต่ API จะยังคงประมวลผลและ เผยแพร่ข้อมูลที่มีอยู่สำหรับเส้นทางนั้นไปยัง BigQuery
• การอัปเดต Pub/Sub จะหยุดลง: การอัปเดตแบบเรียลไทม์เป็นระยะๆ ไปยัง Pub/Sub จะหยุดลงหากstateของเส้นทางเปลี่ยนเป็นSTATE_INVALID
• การประเมินรายไตรมาส: API จะประเมินเส้นทางที่ใช้งานอยู่ทั้งหมดสำหรับปริมาณการเข้าชมทุกไตรมาส
  • หากตรวจพบการเข้าชมต่ำในระหว่างการประเมิน API จะออกคำเตือนในแหล่งข้อมูล SelectedRoute
  • หากการเข้าชมต่ำยังคงเกิดขึ้นเป็นเวลา 4 ไตรมาสติดต่อกัน state ของเส้นทางจะเปลี่ยนเป็น STATE_INVALID และการอัปเดต Pub/Sub จะหยุดลง
• การตรวจสอบความถูกต้องอีกครั้งเป็นไปได้: แม้ว่าเส้นทางจะเป็น STATE_INVALID เส้นทางนั้นก็ยังคงต้องมีการประเมินปริมาณการรับส่งข้อมูลอย่างต่อเนื่อง การประเมินในภายหลังอาจ จัดประเภทเส้นทางใหม่เป็นเส้นทางที่ถูกต้อง (STATE_RUNNING) หากปริมาณการเข้าชม เพิ่มขึ้นสูงกว่าเกณฑ์ที่กำหนดไว้ล่วงหน้า
• สถานะการตรวจสอบ: คุณตรวจสอบสถานะการตรวจสอบเส้นทางได้ผ่าน ปลายทาง get ตามที่อธิบายไว้ในรับเส้นทางที่เลือก หรือโดย ตรวจสอบตาราง routes_status ใน BigQuery

การแก้ปัญหาเส้นทางที่ไม่ถูกต้อง

หากเส้นทาง state STATE_INVALID ให้ทำตามหลักเกณฑ์การแก้ปัญหาถัดไป โดยอิงตามvalidationErrorที่คุณได้รับ

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

• VALIDATION_ERROR_LOW_ROAD_USAGE: ข้อผิดพลาดนี้หมายความว่าเส้นทางที่เลือก ไม่มีข้อมูลการใช้ถนนเพียงพอสำหรับการวิเคราะห์และการอัปเดตที่มีความหมาย หากต้องการแก้ไขปัญหานี้ ให้ลบเส้นทางที่มีอยู่แล้วสร้างเส้นทางใหม่ โดยเลือกพื้นที่ที่มีการใช้ถนนสูงกว่าหรือมี "ความหนาแน่น" สำหรับการเก็บรวบรวมข้อมูล โปรดทราบว่าหากเส้นทางมีข้อผิดพลาดนี้ สถานะของเส้นทางอาจ เปลี่ยนกลับเป็น STATE_RUNNING หากการเข้าชมเพิ่มขึ้นเมื่อเวลาผ่านไปตามที่อธิบายไว้ใน เส้นทางที่มีการใช้งานถนนต่ำ