ルートを作成すると、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リソース内で警告を発行します。 - トラフィックの少ない状態が 4 四半期連続で続くと、ルートの
stateがSTATE_INVALIDに変更され、Pub/Sub の更新が停止します。
- 評価中にトラフィックの減少が検出されると、API は
- 再検証が可能: ルートが
STATE_INVALIDであっても、継続的なトラフィック評価の対象となります。後続の評価で、トラフィック量が事前に決定されたしきい値を超えると、ルートが有効（STATE_RUNNING）として再分類されることがあります。 - モニタリング ステータス: 選択したルートを取得するで説明されているように、
getエンドポイントを使用して、ルートの検証ステータスをモニタリングできます。また、BigQuery のroutes_statusテーブルを調べることもできます。
無効なルートのトラブルシューティング
ルート state が STATE_INVALID の場合は、受け取った validationError に基づいて、次のトラブルシューティング ガイドラインに沿って対応します。
VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: このエラーは、定義されたルートがプロジェクトで承認された地理的範囲を超えていることを示します。この問題を解決するには、既存のルートを削除してルートを再作成し、すべてのポイント（出発地、目的地、中間地点）が承認済みプロジェクトの管轄内にあることを確認します。VALIDATION_ERROR_LOW_ROAD_USAGE: このエラーは、選択したルートに有意義な分析と更新を行うための十分な道路使用データがないことを意味します。この問題を解決するには、既存のルートを削除し、データ収集のために道路の利用率または「混雑度」が高いエリアを選択して、ルートを再作成します。ルートにこのエラーがある場合、ルートの使用率が低いで説明されているように、トラフィックが時間の経過とともに増加すると、ルートのステータスが STATE_RUNNING に戻ることがあります。