瞭解路徑驗證

建立路線後，Roads Selection API 會執行驗證程序。這項驗證可確保路線適合用於道路管理分析的資料收集和更新。這項程序通常會在幾分鐘內完成。

您可以透過 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，詳情請參閱「道路使用率低的路徑」。