概要
Google マップの GTFS フィードのプロバイダでない場合、統合は停留所のみとなります。この統合では、さまざまな電車やバスの停留所をどのように識別しているかを把握する必要があります。
フィードの一般的な仕様
統合を開始すると、統合ごとに一意の識別子が作成されます（例: ch_google_test（国コード、パートナー名、統合）、eu_google（地域コード、パートナー名））。
パートナーは、統合ごとに適用される CSV 形式のテキスト ファイルを含むファイルを提供します。各 CSV ファイルには、対応するフィード仕様テーブルで指定された「フィールド名」と一致する列名を含むヘッダー行が必要です。
パートナーが新しいバージョンのストップ ファイルとマーケット ファイルをアップロードできるように、オンボーディング プロセス中に、ファイルの種類ごとに 1 つの SFTP Dropbox の詳細を共有します。
停止フィード仕様（必須）
ストップ ファイルには次の列が含まれている必要があります。
| フィールド名 | タイプ（GTFS を参照） | 説明 |
|---|---|---|
stop_id |
ID（必須） | 停車地または駅を識別する一意の識別子。大きな駅には 1 つのエントリのみを含める必要があります。これは、パートナー サーバー API の呼び出し時と、チケット発行のディープリンクで使用されます。 |
stop_name |
テキスト（必須） | デバッグの停止マッピング、キャッシュの入力、価格精度のデータに使用される、人が読める形式の名前。 |
stop_lat |
緯度（必須） | 停留所の緯度。 |
stop_lon |
経度（必須） | 停留所の経度。 |
パートナーが情報に変更があった場合に更新された zip ファイルを継続的に提供できる自動取り込みプロセスを使用します。たとえば、パートナーは停留所のリストを拡張することで、提供される在庫を拡大できます。ただし、GTFS と同様に、stop_id は安定している必要があります。
マーケット セット フィードの仕様（省略可）
マッピングされた停留所を使用して、この統合のマーケット セット（一般的な出発地と目的地のペアを含むリスト）を生成します。そこから、マーケット セット フィードを提供することで、このマーケット セットを削減できます。
マーケット セットは、キャッシュ入力サービスの許可リストとして機能します。デフォルトでは、マーケット セットが指定されていない場合、すべてのマーケットが有効になります。マーケット セットを指定すると、リストに含まれるマーケットのみがクエリされます。ユーザーがこの許可リストに含まれない市場をクエリした場合、システムはリクエストされた特定の市場と日付のライブクエリを送信しますが、積極的にキャッシュに保存しようとはしません。
マーケット セット ファイルには次の列が含まれている必要があります。
| フィールド名 | タイプ（GTFS を参照） | 説明 |
|---|---|---|
origin_stop_id |
ID（必須） | 市場のオリジン stop_id。 |
destination_stop_id |
ID（必須） | 市場の宛先 stop_id。 |
パートナー設定
停止のみの統合を使用する場合は、パートナー構成のセクションで説明されているように、静的パートナー構成に関する追加情報が必要です。
紹介リンクの仕様
予約リンク（Ticketing link とも呼ばれます）の形式とパラメータは、チケット販売リンクで定義されています。
パートナー API パラメータ
Partner API（GetBulkTripOptionsRequest）の SegmentKeys パラメータは、ディープリンク仕様に基づいています。ticketing_trip_id を空のままにして、from_ticketing_stop_time_id、to_ticketing_stop_time_id、service_date、boarding_time、arrival_time のみを含む SegmentKeys を使用します。複数の SegmentKey を指定して、セグメントごとに 1 つの SegmentKey を指定することで、すべての乗り換えを含むルートを完全に指定します。