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. Quá 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. Quá 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 điều này bằng cách sử dụng điểm cuối get, như mô tả trong phần Lấy 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 đã vượt qua quy trình xác thực và hiện đang hoạt động. API này đ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 này đến BigQuery, Pub/Sub hoặc cả hai.
  • STATE_DELETING: Tuyến đường đã được đánh dấu để xoá và đang được 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ẽ bao gồm trường validationError kèm theo thông tin chi tiết về lý do không xác thực được.

Lỗi xác thực

Khi state của tài nguyên SelectedRoute là STATE_INVALID, phản hồi của API sẽ bao gồm trường validationError. Trường này cung cấp lý do cụ thể khiến quá trình xác thực không thành công.

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

  • VALIDATION_ERROR_UNSPECIFIED: Lỗi xác thực cho tuyến 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 lưu lượng truy cập để 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 hợp lệ nếu lưu lượng truy cập tăng lên trên một ngưỡng định trước. Tìm hiểu thêm trong bài viết Tuyến đường có mức sử dụng đường thấp.

Tuyến đường ít người đi

Các tuyến đường có thể được gắn cờ bằng VALIDATION_ERROR_LOW_ROAD_USAGE nếu API xác định rằng không có đủ dữ liệu lưu lượng truy cập để 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 cần lưu ý đối với các tuyến đường có mức sử dụng thấp:

  • Tiếp tục xuất bản 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à xuất bản mọi dữ liệu có sẵn cho tuyến đường đó lên BigQuery.
  • Ngừng cập nhật Pub/Sub: Các bản cập nhật định kỳ theo thời gian thực cho Pub/Sub sẽ ngừng nếu state của tuyến đường thay đổi thành STATE_INVALID.
  • Đánh giá hằng quý: API thực hiện đánh giá hằng quý về tất cả các tuyến đường đang hoạt động để xác định 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, thì state của tuyến sẽ chuyển thành STATE_INVALID và Pub/Sub sẽ ngừng cập nhật.
  • Có thể xác thực lại: Ngay cả khi một tuyến đường là STATE_INVALID, tuyến đường đó vẫn phải chịu sự đánh giá lưu lượng truy cập liên tục. 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 định trước.
  • Trạng thái giám sát: Bạn có thể giám sát trạng thái xác thực của tuyến đường thông qua điểm cuối get, như mô tả trong phần Lấy 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ố về tuyến đường không hợp lệ

Nếu tuyến state của bạn 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 vượt ra ngoài khu vực địa lý được cho phép cho dự án của bạn. Để khắc phục vấn đề này, hãy xoá tuyến đường hiện có và tạo lại tuyến đường đó, đồng thời đảm bảo tất cả các điểm (điểm xuất phát, điểm đến và mọi điểm trung gian) đều nằm trong phạm vi quyền hạ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 về mức sử dụng đường để phân tích và cập nhật một cách có ý nghĩa. Để khắc phục vấn đề này, hãy xoá tuyến đường hiện có rồi 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 của bạn gặp lỗi này, thì trạng thái của tuyến có thể thay đổi trở lại thành STATE_RUNNING nếu lưu lượng truy cập tăng theo thời gian như mô tả trong phần Tuyến có mức sử dụng đường thấp.