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 và cập nhật dữ liệu 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 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 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à trạng thái 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 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 đường 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áiSTATE_INVALID, phản hồi sẽ bao gồm một trườngvalidationErrorcó thông tin chi tiết về lý do khiến quá trình xác thực không thành công.
Lỗi xác thực
Khi state của tài nguyên SelectedRoute là STATE_INVALID, phản hồi API sẽ bao gồm 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 phạm vi quyền hạn được phép của dự án.VALIDATION_ERROR_LOW_ROAD_USAGE: Tuyến đường có ít người sử dụng, tức 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 có ít người sử dụng đường 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 được xác định trước. Tìm hiểu thêm trong phần Tuyến đường có ít đường.
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 biểu tượ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 bạn có thể dự kiến đối với những tuyến đường có ít người sử dụng:
- Việc xuất bản dữ liệu sang BigQuery vẫn tiếp tục: Ngay cả khi một tuyến đường được phân loại là
STATE_INVALIDdo có ít người sử dụng đường, 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 đó sang BigQuery. - Pub/Sub ngừng cập nhật: Các bản cập nhật định kỳ theo thời gian thực cho Pub/Sub sẽ ngừng nếu
statecủa tuyến đường thay đổi thànhSTATE_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 vẫn tiếp diễn trong 4 quý liên tiếp, thì
statecủa tuyến đường sẽ thay đổi thànhSTATE_INVALIDvà Pub/Sub sẽ ngừng cập nhật.
- 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
- 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 trải qua quá trình đánh giá lưu lượng truy cập liên tục. Các quy trình đá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. - 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 một tuyến đường thông qua điểm cuối
get, như mô tả trong phần Lấy các tuyến đường đã chọn hoặc bằng cách kiểm tra bảngroutes_statustrong BigQuery.
Khắc phục sự cố về các tuyến đường không hợp lệ
Nếu tuyến đường state 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 quá khu vực địa lý được 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ó rồi tạo lại tuyến đường, đả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 sử dụng đường để phân tích và cập nhật có ý nghĩa. Để 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, chọn một khu vực có mức sử dụng đường cao hơn hoặc "mức độ bận rộn" để 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, 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 theo thời gian như mô tả trong phần Tuyến đường có mức sử dụng đường thấp.