用語集

この用語集では、Transport Partner Integration のドキュメントで使用されている主な用語を定義しています。

予約トークン: チケット発行のディープリンクで渡すことができる、パートナーが生成したオプションの文字列。Google の検索結果とパートナーの予約ページの料金と旅行プランの一貫性を維持するのに役立ちます。

正規 JSON マッピング: proto メッセージを JSON オブジェクトに変換するためにプロトコル バッファで定義された特定のルールセット。この統合では、リクエストとレスポンスが正しくフォーマットされるように、特定のオプションでこのマッピングを使用する必要があります。

GTFS(General Transit Feed Specification): 公共交通機関が乗客に時刻表、ルート、運賃の情報を提供するために使用する標準データ形式。この統合では、Google に静的データを提供する 2 つの方法の 1 つです。

GTFS ベースの統合: GTFS フィードで独自のスケジュール データを Google に提供するパートナー向けの統合方法。これは、Google がオペレーターのスケジュールをまだ把握していない場合に使用されます。

known_itineraries: パートナーが Google から既知の旅程のリストを受け取ってレスポンスを最適化できるようにする、パートナー構成のオプション。

マーケット セット:(ストップのみの統合の場合)パートナーが提供するオプションのフィード。価格を提供する出発地と目的地のペア(マーケット)の特定のリストを定義します。指定されている場合、これは許可リストとして機能します。

パートナー API / パートナー サーバー API: パートナーがリアルタイムの料金や空室状況などの動的データを Google に提供するために実装する必要がある API のセット。

料金の品質テスト: Google のクローラーがパートナーのウェブサイトの旅行プランをサンプリングし、ユーザーに表示される料金がパートナー API を通じて提供される料金と一致していることを確認する継続的なプロセス。

QPS(Queries Per Second): Google がパートナー API サーバーにリクエスト(1 つのクエリは 1 つのリクエスト)を送信する平均レート。このレートは、トラフィックがわずかに増減する期間によって変動する可能性があります。

SegmentKey: パートナー API で使用されるオブジェクト。出発地、目的地、サービスの日時など、旅程の 1 つの区間を一意に識別するために使用されます。

service_date: 交通機関の運行日(YYYYMMDD 形式)。他の識別子と組み合わせて、一意のルート インスタンスを指定するために使用されます。

停止のみの統合: スケジュール データのソースではないパートナー向けの統合方法。これは、Google が別のソースからすでにオペレーターのスケジュールを受け取っている場合に使用されます。パートナーは、停留所 ID のリストを提供するだけで済みます。

ticketing_stop_id: 停留所または駅のパートナー固有の識別子。この ID は静的データフィード(GTFS または Stop-only)で提供され、パートナー API とチケット購入用ディープリンクで使用されます。

ticketing_trip_id:(GTFS ベースの統合の場合)パートナーの GTFS フィードの trips.txt ファイルで提供される、特定のルートのパートナー固有の識別子。GTFS ベースの統合のみ。

チケット予約用ディープリンク: Google の検索結果からパートナーのウェブサイトにユーザーを誘導し、特定の旅程を予約するための URL。URL には、選択した旅行に関するエンコードされた詳細情報が含まれます。

TripOptionsErrorType: パートナー API で返される可能性のある特定のエラータイプ。リクエストが失敗した理由に関する詳細情報を提供します。

UNSPECIFIED 列挙型の値: Protocol Buffers を使用する場合、列挙型の定義で必須の最初の値(数値 0)です。これはデフォルト値として機能し、リクエストで受信した場合は通常エラーとして扱われます。