このガイドでは、Google マップや Google 検索などのさまざまな Google サービスで、ユーザーにシームレスな交通機関検索エクスペリエンスを提供するために、Google と統合する方法について説明します。統合の主な仕様は次のとおりです。
- 静的データを提供するには、次の 2 つの方法があります。
- GTFS ベースの統合: 時刻表データのプロバイダである場合に、乗車券販売の拡張機能を含む GTFS フィードを提供します。GTFS ベースの統合には、いくつかの追加の要件があります。
- 停止のみの統合: Google が別のソースからすでにスケジュール データを取得している場合に、停留所のリストのみを提供します。
- 動的データを提供するためのパートナー API 仕様:
- パートナー構成: ブランディングや連絡先情報などのパートナー情報を提供します。
- パートナー サーバー: パートナー サーバー API をサポートするサーバーを実装します。
Travel Transport との統合手順
Google の転送機能をサポートするエンドツーエンド システムを構築してテストするために必要な手順の概要は次のとおりです。統合には次の 3 つの主な手順があります。
- 参加要件を確認する。
- Google に静的データのフィードを提供します。
- Travel Transport API をサポートし、料金や空室状況など、頻繁に変更されるデータの動的クエリを可能にします。API は、ステップ 1 の静的データフィードから提供された識別子（
ticketing_stop_idなど）を使用して、停留所を識別します。
1. 参加要件
Google の交通機関の機能ユニットには、旅程と予約オプションが料金とともに表示されます。特典をリストに表示するには、品質の高いリンクと一致する最終価格が必要です。詳しくは、参加要件をご覧ください。
2. 静的データのフィードを提供する
静的データを提供するには 2 つの方法があり、それぞれ特定の状況で適用できます。どのオプションを使用するかを判断する主な基準は、予約機能を提供したい交通機関の接続のスケジュール データの提供者であるかどうかです。Google がすでに時刻表データを保有しているかどうかを確認する最も簡単な方法は、Google マップで特定の事業者の接続を検索してみることです。
| 機能 | GTFS ベースの統合 | 停止のみの統合 |
|---|---|---|
| ユースケース | すでに GTFS でスケジュールと乗車券販売情報を提供している。 | Google は、別のソースからすでにオペレーターのスケジュール データを取得しています。 |
| 必要なデータ | GTFS ID。 | 停留所 ID とその地理座標のリスト。 |
| 作業量 | 低 | 中 |
オプション 1 は、事業者の GTFS フィードのプロバイダである場合に適用されます。この場合、Google に時刻表情報を提供するために、GTFS フィードも設定しておく必要があります。次に、GTFS ベースの統合セクションの手順に沿って操作します。
オプション 2 は、Google が別のソースからすでにオペレーターのスケジュール データを受け取っている場合に適用されます。この場合、完全なスケジュール情報は必要ありませんが、Travel Transport API で使用できる停留所 ID のリストは必要です（下記を参照）。停車地のリストを指定するには、停車地のみの統合セクションの手順に沿って操作します。
3. Travel Transport API のサポート
交通機関の料金単位で料金を表示する予約パートナーとして掲載されるには、Google がパートナーから最新の料金と空席状況の情報を取得できる必要があります。これを有効にするには、パートナーは Partner Server API を実装するサービスを提供する必要があります。
3.1. パートナー サーバー API の実装
パートナー サーバー API の実装方法について詳しくは、API リファレンスとパートナー サーバー ガイドをご覧ください。この API を使用すると、Google はパートナー様から最新の価格と在庫状況の情報を取得できます。Google はこの API を呼び出して、次のことを行います。
- 価格を迅速に返すためのキャッシュを生成します。
- ユーザーが特定の日付のルートを検索したときに、価格のない旅行プランがキャッシュに表示された場合は、最新の料金を取得します。
パートナーが Google に価格を表示させたい場合は、パートナー サーバー API を実装する必要があります。
3.2. API の検証とテスト
API の実装がほぼ完了し、実装するサービスが稼働したら、サーバー情報とともに transport-help@google.com にご連絡ください。実装の検証を開始します。
今後、API 実装を検証するための自動化されたツールを提供する予定ですが、まだ利用できません。