停止のみの統合

概要

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_idto_ticketing_stop_time_idservice_dateboarding_timearrival_time のみを使用し、ticketing_trip_id は空のままにします。複数の SegmentKey(セグメントごとに 1 つ)を指定して、すべての乗り換えを含むルートを完全に指定します。