General Transit Feed Specification(GTFS)形式でデータを公開したら、その機能性と正確性を確保するため GTFS フィードを検証する必要があります。こうした検証は GTFS フィードの有効性を保つことはもちろん、乗客に有効なデータを提供する意味でも重要です。
フィードの検証
新しいバージョンのフィードをアップロードするとフィードが自動的に検証され、フィードに関する操作のトラブルシューティングと最適化に役立ちます。エラーまたは警告が表示された場合は、送信したデータが正しいことを確認してください。問題を修正したら、フィードを再送信して再度検証を受けてください。
フィードの検証では、データに次のような問題がないかどうかが確認されます。
- 重複した識別子
- 運賃
- フィード
- 定期運行
- 欠落しているファイル、参照値、またはフィードの言語
- 経路
- 運行の日付と時刻
- シェイプ
- 駅や停留所
- 時刻
- 乗換
- ルート
乗換案内パートナー ダッシュボードでデータの問題が見つかった場合は、フィードを更新してから再度アップロードしてください。限定公開プレビューで適切にテストし、エラーや容認できない警告が見つからなかったフィードをアップロードしたら、Google による品質保証(QA)審査をリクエストしてください。
検証エラー
検証エラーは、フィードの正常な処理を妨げる重大なエラーであり、修正するまで処理を完了できません。
Google マップにデータを公開する前に、検証エラーを修正する必要があります。
検証警告
検証警告はフィードの潜在的な問題を示す有益なメッセージですが、これが原因で Google マップのユーザーに乗換案内データが適切に表示されなくなることもあります。警告の内容は必ず調査して、フィードのデータが正確で、正しくコーディングされていることを確認してください。問題が見つかった場合は、フィードを更新して再検証してください。
フィードに関する問題の種類
GTFS フィードを検証し、エラーや警告を特定、対処してください。次の表に、データフィードで発生する問題を示します。
問題の種類 | 説明 | 例 |
---|---|---|
フェッチエラー | Google でフィードを取得できなくなる問題であり、たいていはデータフェッチの設定に問題があります。フィードのプレビューや検証レポートは、このエラーを修正しないと確認できません。 | FTP の URL が不正確で、フィードを取得しようとすると 404 エラーが発生する。 |
検証エラー |
重大な問題であり、フィードが適切に機能するように必ず修正する必要があります。 |
参照先の値が見つからない trips.txt で参照している service_id が calendar.txt で設定されていない。 |
検証警告 |
フィードに関する潜在的な問題であり、確認が必要です。フィードでは運行の経路やスケジュールを正確に記載する必要があります。 |
例 1 フィードで示されている駅または停留所が海の中にある。 フィードを更新して、駅または停留所の正確な位置を指定してください。 例 2 駅または停留所の間の距離を考えると、運行スケジュールがきつすぎる。 スケジュールに問題がないか、情報を確認してください。問題ない場合、パートナー様の側では、それ以上の対応は必要ありません。 |
静的フィードの検証レポートを確認する
検証レポートには静的フィードの検証に関するエラーと警告が表示され、GTFS フィードのトラブルシューティングに役立ちます。
静的フィードの検証レポートを確認する手順は以下のとおりです。
- 乗換案内パートナー ダッシュボードで [データ] タブを開き、レポートを表示する静的フィードの名前をクリックします。
- フィードの詳細ページで、[転送] セクションの行を展開し、[検証レポート] をクリックします。
Google アカウントに乗換案内パートナー ダッシュボードへのアクセス権が付与されると、以降に生成された検証レポートにアクセスできるようになります。なお、すでに作成されているレポートは表示できません。
検証レポートの機能
検証レポートのナビゲーション バーには、次のレポートの機能にアクセスできるタブがあります。
- フィードの概要
- 駅 / 停留所
- カレンダー
- クエリ
検証レポートの最初の [Overview] タブには、フィードに関する統計や経路と交通機関のリストなど、フィードの高度な要約が表示されます。
このタブには、検証エラーや警告も表示されます。
データの正確性を確保するには、Google マップでデータを公開する前に検証エラーを修正する必要があります。
検証警告は解決することを強くおすすめします。
検証レポートの [Stops] タブには、フィードで示されている地図上の駅や停留所がすべて表示されます。このビューを使用して、駅や停留所の場所を確認してください。
[Calendars] タブには、フィード向けに作成された運行カレンダーの概要が表示されます。このビューでは、フィードで指定した運行日に誤りがないことを確認できます。週末や休日などの特別運行には特に注意を払ってください。
[Queries] タブには、フィードで示されている駅や停留所の組み合わせを対象に、Google マップでランダムに生成された進行方向に関するクエリが表示されます。フィードのプレビューを作成したら、これらのクエリで乗換案内のルート検索の結果をテスト、確認してください。また、ルート検索の結果を独自にテストする際に、これらのクエリでテスト内容を強化することもできます。