Tìm hiểu về quy trình xác thực tuyến đường

Sau khi bạn tạo một tuyến đường, Roads Selection API sẽ thực hiện quy trình xác thực. Quy trình xác thực này đảm bảo rằng tuyến đường phù hợp để thu thập dữ liệu và cập nhật trong Roads Management Insights. Quy trình này thường hoàn tất trong vòng vài phút.

Bạn có thể theo dõi trạng thái xác thực của các tuyến đường thông qua trường state trong phản hồi của API. Bạn có thể kiểm tra trạng thái này bằng cách sử dụng điểm cuối get, như mô tả trong phần Nhận các tuyến đường đã chọn, hoặc bằng cách kiểm tra bảng routes_status trong BigQuery.

Trạng thái tuyến đường

Trường state trong tài nguyên SelectedRoute cho biết trạng thái xác thực và hoạt động hiện tại của tài nguyên đó. Trường state có thể có các giá trị sau:

  • STATE_UNSPECIFIED: Trạng thái xác thực của tuyến đường này chưa được đặt.
  • STATE_VALIDATING: Tuyến đường đang được xác thực.
  • STATE_RUNNING: Tuyến đường đã xác thực thành công và hiện đang hoạt động. API đang tích cực thu thập dữ liệu và gửi thông tin cập nhật định kỳ cho tuyến đường này đến BigQuery, Pub/Sub hoặc cả hai.
  • STATE_DELETING: Tuyến đường đã được đánh dấu để xoá và đang bị xoá khỏi hệ thống.
  • STATE_INVALID: Tuyến đường không xác thực được dựa trên các tiêu chí cụ thể. Khi một tuyến đường ở trạng thái STATE_INVALID, phản hồi sẽ chứa trường validationError với thông tin chi tiết về lý do xác thực không thành công.

Lỗi xác thực

Khi SelectedRoute của tài nguyên state là STATE_INVALID, phản hồi của API sẽ chứa trường validationError. Trường này cung cấp một lý do cụ thể cho lỗi xác thực.

Trường validationError có thể có các giá trị sau:

  • VALIDATION_ERROR_UNSPECIFIED: Lỗi xác thực cho tuyến đường này chưa được đặt.
  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: Tuyến đường nằm ngoài khu vực tài phán được uỷ quyền của dự án.
  • VALIDATION_ERROR_LOW_ROAD_USAGE: Tuyến đường có mức sử dụng đường thấp, nghĩa là không thể thu thập đủ dữ liệu giao thông để phân tích có ý nghĩa. Một tuyến đường được phân loại là không hợp lệ do mức sử dụng đường thấp có thể trở lại trạng thái hợp lệ nếu lưu lượng truy cập tăng lên trên một ngưỡng xác định trước. Tìm hiểu thêm trong phần Tuyến đường có mức sử dụng đường thấp.

Tuyến đường có mức sử dụng đường thấp

Các tuyến đường có thể được gắn cờ bằng VALIDATION_ERROR_LOW_ROAD_USAGE nếu API xác định không có đủ dữ liệu giao thông để phân tích nhất quán. Điều này có thể xảy ra trong quá trình xác thực ban đầu hoặc trong quá trình đánh giá liên tục.

Sau đây là những điều bạn cần biết về các tuyến đường có mức sử dụng đường thấp:

  • Tiếp tục công bố dữ liệu lên BigQuery: Ngay cả khi một tuyến đường được phân loại là STATE_INVALID do mức sử dụng đường thấp, API vẫn tiếp tục xử lý và công bố mọi dữ liệu có sẵn cho tuyến đường đó lên BigQuery.
  • Dừng cập nhật Pub/Sub: Thông tin cập nhật định kỳ theo thời gian thực cho Pub/Sub sẽ ngừng nếu của tuyến đường state thay đổi thành STATE_INVALID.
  • Đánh giá hằng quý: API thực hiện đánh giá hằng quý đối với tất cả các tuyến đường đang hoạt động về lưu lượng truy cập.
    • Nếu phát hiện thấy lưu lượng truy cập thấp trong quá trình đánh giá, API sẽ đưa ra cảnh báo trong tài nguyên SelectedRoute.
    • Nếu lưu lượng truy cập thấp kéo dài trong 4 quý liên tiếp, tuyến đường's state thay đổi thành STATE_INVALID, và thông tin cập nhật Pub/Sub sẽ ngừng.
  • Có thể xác thực lại: Ngay cả khi một tuyến đường ở trạng thái STATE_INVALID, tuyến đường đó vẫn phải chịu sự đánh giá liên tục về lưu lượng truy cập. Các lần đánh giá tiếp theo có thể phân loại lại tuyến đường là hợp lệ (STATE_RUNNING) nếu lưu lượng truy cập của tuyến đường đó tăng lên trên một ngưỡng xác định trước.
  • Giám sát trạng thái: Bạn có thể theo dõi trạng thái xác thực của một tuyến đường thông qua điểm cuối get, như mô tả trong phần Nhận các tuyến đường đã chọn, hoặc bằng cách kiểm tra bảng routes_status trong BigQuery.

Khắc phục sự cố các tuyến đường không hợp lệ

Nếu state của tuyến đường là STATE_INVALID, hãy làm theo các nguyên tắc khắc phục sự cố tiếp theo dựa trên validationError mà bạn nhận được:

  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: Lỗi này cho biết tuyến đường đã xác định mở rộng ra ngoài khu vực địa lý được uỷ quyền cho dự án của bạn. Để khắc phục lỗi này, hãy xoá tuyến đường hiện có và tạo lại tuyến đường, đảm bảo tất cả các điểm của tuyến đường (điểm khởi hành, điểm đến và mọi điểm trung gian) đều nằm trong phạm vi khu vực tài phán của dự án được uỷ quyền.

  • VALIDATION_ERROR_LOW_ROAD_USAGE: Lỗi này có nghĩa là tuyến đường đã chọn không có đủ dữ liệu sử dụng đường để phân tích và cập nhật có ý nghĩa. Để khắc phục lỗi này, hãy xoá tuyến đường hiện có và tạo lại tuyến đường, chọn một khu vực có mức sử dụng đường cao hơn hoặc "mức độ đông đúc" để thu thập dữ liệu. Xin lưu ý rằng nếu tuyến đường của bạn gặp lỗi này, thì trạng thái của tuyến đường có thể thay đổi trở lại thành STATE_RUNNING nếu lưu lượng truy cập tăng lên theo thời gian như mô tả trong Tuyến đường có mức sử dụng đường thấp.