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

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