フィードの検証とレポートの概要

General Transit Feed Specification(GTFS)形式でデータを公開したら、その機能性と正確性を確保するため GTFS フィードを点検する必要があります。こうした点検は GTFS フィードの有効性を保つことはもちろん、乗客に有効なデータを提供する意味でも重要です。適切なデータ形式については、GTFS フィードの仕様ファイルをご覧ください。

新しいフィードをアップロードすると、乗換案内パートナー ダッシュボードで自動的にそのフィードが点検され、ユーザーによるフィードの運用やトラブルシューティング、最適化に役立つ検証レポートが作成されます。このレポートではフィードの概要以外に、警告エラーも確認できます。こうした警告やエラーの内容に基づいてフィードのトラブルシューティングを行ってください。

検証警告

検証警告はフィードの潜在的な問題を示す有益なメッセージですが、これが原因で Google マップのユーザーに乗換案内データが適切に表示されなくなることもあります。警告の内容は必ず調査して、フィードデータが正確で、正しくコーディングされていることを確認してください。問題が見つかった場合は、フィードを更新して再検証してください。

検証エラー

検証エラーは、フィードの正常な処理を妨げる重大なエラーであり、修正するまで処理を完了できません

検証の確認

警告やエラーは必ず調査して、送信したデータの正確性を保つようにしてください。データが不正確な場合は、フィードを更新して再送信してください。

以降のセクションでは、検証警告や検証エラーを紹介します。検証レポートではタイトルと説明のデータが使用されます。

フィード検証では、次のデータ領域を確認してエラーや警告に該当するかどうかを判定します。

  • 重複した識別子
  • 運賃
  • フィード
  • 定期運行
  • 欠落しているファイル、参照値、またはフィードの言語
  • 経路
  • 運行の日付と時刻
  • シェイプ
  • 駅や停留所
  • 時刻
  • 乗換
  • ルート

検証レポートでデータの問題が見つかった場合は、フィードを更新して再度アップロードしてください。限定公開プレビューで適切にテストし、エラーや容認できない警告が見つからなかったフィードをアップロードしたら、Google による品質保証(QA)審査をリクエストしてください。

データの正確性を確保するには、Google マップでデータを公開する前に検証エラーを修正する必要があります

検証警告は解決することを強くおすすめします。

フィードのテストには外部ツールも利用できますが、Google では乗換案内パートナー ダッシュボードのフィード検証レポートを使用することをおすすめしています。このレポートならオープンソースのフィード検証スクリプトより厳格で、Google の GTFS 拡張フィールドにも対応しています。

フィードの問題

GTFS フィードを点検し、エラーや警告を特定、対処してください。次の表に、データフィードで発生する問題を示します。

問題の種類 説明
フェッチエラー Google でフィードを取得できなくなる問題であり、たいていはデータフェッチの設定に問題があります。フィードのプレビューや検証レポートは、このエラーを修正しないと確認できません。 FTP の URL が不正確で、フィードを取得しようとすると 404 エラーが発生する。
検証エラー

重大な問題であり、フィードが適切に機能するように必ず修正する必要があります。

参照先の値が見つからない

trips.txt で参照している service_idcalendar.txt で設定されていない。
検証警告

フィードに関する潜在的な問題であり、確認が必要です。フィードでは運行の経路やスケジュールを正確に記載する必要があります。

例 1

フィードで示されている駅または停留所が海の中にある。

フィードを更新して、駅または停留所の正確な位置を指定してください。

例 2

駅または停留所の間の距離を考えると、運行スケジュールがきつすぎる。

スケジュールに問題がないか、情報を確認してください。問題ない場合、パートナー様の側では、それ以上の対応は必要ありません。

検証レポートを表示する

フィード検証レポートを表示するには:

  1. 乗換案内パートナー ダッシュボードにアクセスします
  2. フィード名横の[Static feed]をクリックします
  3. [Validation report] > [Open report] ボタンをクリックします

    Validation report button

  4. 乗換案内ソフトウェアにより、検証レポートが表示されます。

Google アカウントに乗換案内パートナー ダッシュボードへのアクセス権が付与されると、以降に生成された検証レポートにアクセスできるようになります。なお、すでに作成されているレポートは表示できません。

検証レポートの機能

検証レポートのナビゲーション バーには、次のレポートの機能にアクセスできるタブがあります。

  • フィードの概要
  • 駅 / 停留所
  • カレンダー
  • クエリ
フィードの概要

検証レポートの最初の [Overview] タブには、フィードに関する統計や経路と交通機関のリストなど、フィードの高度な要約が表示されます。

このタブには、検証エラーや警告も表示されます。

Validation report overview

データの正確性を確保するには、Google マップでデータを公開する前に検証エラーを修正する必要があります

検証警告は解決することを強くおすすめします。

駅 / 停留所

検証レポートの [Stops] タブには、フィードで示されている地図上の駅や停留所がすべて表示されます。このビューを使用して、駅や停留所の場所を確認してください。

Validation reports stops

カレンダー

[Calendars] タブには、フィード向けに作成された運行カレンダーの概要が表示されます。このビューでは、フィードで指定した運行日に誤りがないことを確認できます。週末や休日などの特別運行には特に注意を払ってください。

Validation report calendars

クエリ

[Queries] タブには、フィードで示されている駅や停留所の組み合わせを対象に、Google マップでランダムに生成された進行方向に関するクエリが表示されます。フィードのプレビューを作成したら、これらのクエリで乗換案内のルート検索の結果をテスト、確認してください。また、ルート検索の結果を独自にテストする際に、これらのクエリでテスト内容を強化することもできます。

validation report queries

この記事は役に立ちましたか?
改善できる点がありましたらお聞かせください。