ルートを作成すると、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リソース内で警告を発行します。 - トラフィックが 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 に戻ることがあります。