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

หลังจากสร้างเส้นทางแล้ว 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 พร้อมรายละเอียดเกี่ยวกับสาเหตุที่การตรวจสอบความถูกต้องล้มเหลว

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

เมื่อ SelectedRoute ของทรัพยากร state เป็น 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 จะแสดงa คำเตือนภายในทรัพยากร 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 หากการเข้าชมเพิ่มขึ้นเมื่อเวลาผ่านไปตามที่อธิบายไว้ใน เส้นทางที่มีการใช้ถนนต่ำ