ルートの検証について

ルートを作成すると、Roads Selection API によって検証プロセスが実行されます。この検証により、ルートが Roads Management Insights 内でのデータの収集と更新に適していることが保証されます。通常、このプロセスは数分で完了します。

ルートの検証ステータスは、API レスポンスの state フィールドでモニタリングできます。これを確認するには、get エンドポイントを使用するか、選択したルートを取得で説明されているように、BigQuery の routes_status テーブルを調べます。

ルートの状態

state フィールドは、SelectedRoute リソースの現在の検証ステータスと運用ステータスを示します。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 の更新が停止します。
再検証が可能: ルートが STATE_INVALID であっても、継続的なトラフィック評価の対象となります。トラフィック量が事前に設定されたしきい値を超えると、後続の評価でルートが有効（STATE_RUNNING）として再分類されることがあります。
ステータスのモニタリング: ルートの検証ステータスは、 get エンドポイントを使用するか、選択したルートを取得で説明されているように、 BigQuery の routes_status テーブルを調べることでモニタリングできます。

ルートの state が STATE_INVALID の場合は、受け取った validationError に基づいて、次のトラブルシューティングガイドラインに沿って操作してください。

VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: このエラーは、定義されたルートがプロジェクトに承認された地理的範囲を超えていることを示します。この問題を解決するには、既存のルートを削除してルートを再作成し、すべてのポイント（出発地、目的地、中間地点）が承認されたプロジェクトの管轄内にあることを確認します。
VALIDATION_ERROR_LOW_ROAD_USAGE: このエラーは、選択したルートに有意義な分析と更新を行うための十分な道路使用量データがないことを意味します。この問題を解決するには、既存のルートを削除してルートを再作成し、道路使用量が多いエリアまたは「混雑状況」が高いエリアを選択してデータを収集します。ルートにこのエラーが表示された場合、ルートのステータスが道路使用量が少ないルートで説明されているように、トラフィックが時間とともに増加すると、STATE_RUNNING に戻ることがあります。