概要
Google マップの GTFS フィードの提供元でない場合は、統合は停留所のみです。この統合では、さまざまな鉄道駅やバス停をどのように識別するかを把握する必要があります。
一般的なフィード仕様
統合を開始すると、統合ごとに一意の識別子が作成されます(例: ch_google_test
(国コード、パートナー名、統合)または eu_google
(地域コード、パートナー名))。
パートナーは、グローバルまたは統合ごとに適用される CSV 形式のテキスト ファイルを含む ZIP ファイルを提供できます。
例 1:
- ch_google_test_stops.txt
- ch_google_test_markets.txt
例 2:
- stops.txt(すべての統合に適用)
- eu_google_integration1_markets.txt
- eu_google_integration2_markets.txt
停止フィードの仕様(必須)
停止ファイルには、次の列が含まれている必要があります。
フィールド名 | タイプ(GTFS を参照) | 説明 |
---|---|---|
stop_id |
ID(必須) | 停車地または駅を一意に識別する識別子。大きな駅の場合は、1 つのエントリのみを含める必要があります。これは、Partner Server API の呼び出し時と、チケット販売のディープリンクで使用されます。 |
stop_name |
テキスト(必須) | 停留所マッピング、キャッシュの充填、価格精度データのデバッグ用の名前。 |
stop_lat |
緯度(必須) | 停留所の緯度。 |
stop_lon |
経度(必須) | 停留所の経度。 |
自動取り込みプロセスを使用するため、パートナーは、含まれる情報が変更されたときに更新された ZIP ファイルを継続的に提供できます。たとえば、パートナーは停留所のリストを拡張することで、提供される広告枠を拡大できます。ただし、GTFS と同様に、stop_id は安定している必要があります。
マーケットセット フィードの仕様(省略可)
マッピングされた停留所を使用して、この統合のマーケットセット(人気の発着地ペアを含むリスト)を生成します。そこから、市場セット フィードを提供することで、この市場セットを減らすことができます。
マーケットセットは許可リストとして機能します。マーケットセットが指定されていない場合、統合ですべてのマーケットが有効になります。マーケットセットが指定されている場合、リストにないマーケットは無効になります。
マーケットセット ファイルには、次の列を含める必要があります。
フィールド名 | タイプ(GTFS を参照) | 説明 |
---|---|---|
origin_stop_id |
ID(必須) | マーケットのオリジン stop_id 。 |
destination_stop_id |
ID(必須) | マーケットの宛先 stop_id 。 |
パートナー設定
停留所のみの統合を使用する場合は、パートナーの構成セクションに記載されているように、静的パートナーの構成に追加の情報が必要です。
チケット販売のディープリンク
ディープリンクの形式とパラメータは、チケット販売リンクで定義されています。
Partner API パラメータ
Partner API(GetBulkTripOptionsRequest)の SegmentKeys パラメータは、ディープリンク仕様に基づいています。SegmentKeys では、from_ticketing_stop_time_id
、to_ticketing_stop_time_id
、service_date
、boarding_time
、arrival_time
のみを使用し、ticketing_trip_id
は空のままにします。複数の SegmentKey(セグメントごとに 1 つ)を指定して、すべての乗り換えを含むルートを完全に指定します。