瞭解路徑驗證

建立路徑後，Roads Selection API 會執行驗證程序。這項驗證作業可確保路線適合在 Roads Management Insights 中收集及更新資料。整個過程通常會在幾分鐘內完成。

您可以透過 API 回應中的 state 欄位，監控路線的驗證狀態。如要檢查這項資訊，請使用「get」端點，如「取得所選路線」一文所述，或檢查 BigQuery 中的 routes_status 資料表。

路徑狀態

SelectedRoute 資源中的 state 欄位會指出目前的驗證和運作狀態。state 欄位可包含下列值：

• STATE_UNSPECIFIED：這條路線的驗證狀態未設定。
• STATE_VALIDATING：正在驗證路線。
• STATE_RUNNING：路線已成功通過驗證，目前處於啟用狀態。API 會主動收集資料，並定期將這條路線的更新資訊傳送至 BigQuery、Pub/Sub 或兩者。
• 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：路線的道路使用率偏低，因此無法收集足夠的流量資料進行有意義的分析。如果道路使用率偏低，導致路徑遭歸類為無效，但流量增加至超過預先決定的門檻，路徑可能會再次有效。詳情請參閱「低路面使用率路線」。

道路使用率低的路線

如果 API 判斷流量資料不足，無法進行一致的分析，路線可能會標示 VALIDATION_ERROR_LOW_ROAD_USAGE。這可能發生在初始驗證或持續評估期間。

如果路線的道路使用率偏低，會發生以下情況：

• 資料持續發布至 BigQuery：即使路線因道路使用率偏低而分類為 STATE_INVALID，API 仍會繼續處理該路線的任何可用資料，並發布至 BigQuery。
• 停止 Pub/Sub 更新：如果路線的 state 變更為 STATE_INVALID，系統就會停止定期即時更新 Pub/Sub。
• 每季評估：API 會每季評估所有有效路徑的流量。
  • 如果在評估期間偵測到低流量，API 會在 SelectedRoute 資源中發出警告。
  • 如果連續四個季度流量偏低，路線的 state 會變更為 STATE_INVALID，且 Pub/Sub 更新會停止。
• 重新驗證：即使路線為 STATE_INVALID，仍會持續接受流量評估。如果路線的流量超過預先設定的門檻，後續評估可能會將路線重新分類為有效 (STATE_RUNNING)。
• 監控狀態：您可以透過 get 端點監控路線的驗證狀態，如「取得所選路線」一文所述，也可以檢查 BigQuery 中的 routes_status 資料表。

排解無效路徑問題

如果路線 state 為 STATE_INVALID，請根據 validationError 按照下一個疑難排解指南操作：

• VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION：這項錯誤表示定義的路徑超出專案授權的地理區域。如要修正這個問題，請刪除現有路線並重新建立路線，確保所有點 (起點、目的地和任何中途點) 都在授權專案的管轄範圍內。

• VALIDATION_ERROR_LOW_ROAD_USAGE：這項錯誤表示所選路線的道路使用資料不足，無法進行有意義的分析和更新。如要修正這個問題，請刪除現有路線並重新建立路線，然後選取道路使用率或「繁忙程度」較高的區域來收集資料。請注意，如果路線發生這項錯誤，隨著時間經過，如果流量增加，路線狀態可能會變回 STATE_RUNNING，詳情請參閱「低道路使用率路線」。