フェリー予約API
旅行会社・OTA向けフェリーAPI：運航便、車両、チケット
フェリーAPIを使えば、自社サイトで港間の実際の運航便を表示し、同じ訪問の中でチケットまで販売できます。このページでは、フェリーAPIが返す情報、フェリー予約で氏名と日付以外も必要になる理由、チケット発行とチェックインの仕組み、そしてPHPTRAVELSがフェリー連携を自社ドメイン上の予約エンジンに変える方法を解説します。
- 時刻表と空席状況
- 車両・客室・ペット
- eチケットとチェックイン
- 島めぐり
概要
フェリーAPIが表すのは商品の一覧ではなく、港のネットワークです
航空には空港コード、ホテルには住所があります。フェリーにあるのは港、港同士を結ぶ航路、そして日ごとに各航路を運航する運航会社です。フェリーAPIはまずそのネットワークを提供し、次にその上の運航便を提供します。
航路の例
- ピレウス本土の港区間1・複数の運航会社
- ナクソス島の拠点区間2・季節運航
- サントリーニ島
01港
旅行者が出発地・到着地として検索する停留地で、港名と国が含まれます。1つの都市に複数のターミナルがある場合もあるため、APIは正確な港を返します。
02航路
2つの港を結ぶ路線です。検索フォームには、接続済みの運航会社が実際に運航している組み合わせだけが表示されるため、存在しない航路を検索されることはありません。
03運航便
各航路の日付ごとの出発便で、船名、時刻、船内に残る空きが含まれます。分単位で変わる部分です。
裏側では、フェリーモジュールがネットワークを一か所で管理します。接続した運航会社の航路と自分で登録した航路が並び、港を共有する航路は連結されて長い旅程になります。仕組みはフェリーのページをご覧ください。
時刻表と空席状況
2回の呼び出しで出発案内板が埋まります
フェリー検索で実際に問われるのは2点です。この航路・日付にどの便があるか、そしてこの人数と車両に空きがあるか。サプライヤーはこの2つを別々に返すため、料金を表示する前に両方が必要です。
| 出発 | 行き先 | 船舶 | 所要時間 | 空席状況 |
|---|---|---|---|---|
| 07:00 | ナクソス | 高速船 | 3時間35分 | 販売中座席のみ、車両不可 |
| 07:25 | ナクソス | ロパックス船 | 5時間40分 | 販売中座席と車両スペース |
| 07:30 | ミコノス | ロパックス船 | 5時間15分 | 残りわずか座席と車両スペース |
| 13:00 | パロス | カタマラン | 3時間10分 | 販売中座席のみ、車両不可 |
| 17:30 | サントリーニ | ロパックス船 | 7時間50分 | 残りわずか客室残りわずか |
| 21:00 | イラクリオン | クルーズフェリー | 9時間00分 | 満席次の便をご案内 |
参考データ（簡略化）
- 時刻表
どの便が運航するか
航路、日付、時間帯を入力すると、出発・到着、船舶、所要時間が返ります。時刻表は季節で変わるため、リアルタイムで取得するか頻繁に更新し、手入力はしません。
- 空席状況
船内に空きはあるか
デッキ席、座席、客室、車両レーンはそれぞれ別の定員です。座席は空いていても車両スペースがない便もあるため、正確な人数と車両で確認します。
- 料金
このグループの支払額
運賃は乗客の区分、船内のクラス、車両のサイズで決まります。最後の客室が埋まっている可能性があるため、支払い直前に再度料金を確認します。
フェリーが他と違う点
フェリー予約では、人、車両、そして寝る場所を扱います
航空会社に必要なのは氏名と日付です。フェリー運航会社は、年齢区分ごとの乗客、車両デッキに載せるもの、全員の座席や寝る場所、動物の同伴有無も把握する必要があります。どの回答も料金と残りスペースを左右します。
01乗客区分
- 大人2
- 子供1
- 幼児0
- シニア0
運航会社は大人、子供、幼児、シニアで料金が異なり、年齢区分も各社が独自に定めています。島民料金や学生料金を設ける航路もあります。APIは、その航路が受け付ける区分を返します。
02車両
- 全長
- 5 mまで
- 全高
- 2 m未満
車両スペースは種類とサイズごとに販売されます。全長はレーンの使用量を決め、全高はキャンピングカーやバンなど背の高い車両が別のデッキを必要とする場合があるため重要です。寸法が違うと港で追加料金が発生することがあります。
03船内
- デッキ自由席
- 指定席番号付き
- 客室ベッド数、客室単位
デッキ席、指定席、客室はそれぞれ別クラスで、定員も別です。座席は乗客ごと、客室は通常1室ごとの料金で、夜行便では特に重要です。
04ペット
犬1匹、ケージに入れて同伴
ルールは運航会社と船舶で異なり、ケージ、ペット可の客室、あるいは不可の場合もあります。ペットは独自の料金と限られた定員を持つ追加項目のため、チケットと一緒に予約します。
参考フォーム（簡略化）
予約の後
発券とチェックイン
フェリーの販売は支払いで終わりではありません。旅行者は乗船する必要があり、予定は変わり、海の状況にも左右されます。ここからはフェリーAPIとプラットフォームが一緒に担う部分です。
eチケット
多くの運航会社は、スマートフォンまたは紙で提示できるスキャン用コード付きのeチケットを発行します。プラットフォームは請求書とともにメールで送り、お客様のアカウントにも保管します。
港での乗船
航路によっては、運航会社の港の窓口で予約番号を乗船券に引き換える必要があります。どちらに該当し、どこへ行くべきかは予約確認書でご案内します。
チェックイン期限
車両は徒歩の乗客より早くチェックインするのが一般的で、国際航路ではパスポートが必要です。オンライン販売は航路のチェックイン期限で終了します。
変更
日付、時刻、乗客、車両の変更は運賃の条件に従い、手数料や差額が発生する場合があります。変更後はチケットが再発行されます。
悪天候による欠航
運航会社は天候や海況により運航便を欠航または遅延させます。影響を受けた旅行者への連絡、次の便への振替や払い戻しの方法を、運航会社の規約に沿って計画しておきましょう。
キャンセルと払い戻し
運賃ごとに払い戻しルールがあります。購入内容がわかるよう支払い前に表示し、払い戻しは元の支払い方法で処理します。
運航会社は各社の条件を公開しており、プラットフォームは運航便ごとに表示します。運航会社と旅行会社向けの対応はフェリー予約ソフトウェアとの比較もご覧ください。
PHPTRAVELSに導入済み
ご自身のアカウントで有効にできるフェリーコネクター
以下のフェリーサプライヤーは、PHPTRAVELSのフェリーモジュールにすでに接続されています。サプライヤーと契約し、管理画面で認証情報を入力すれば、運航便が検索結果に表示されます。一覧は連携ディレクトリからリアルタイムで取得しています。
案内板を埋める他の方法
- アロットメント：運航会社が割り当てる座席・客室・車両スペースで、なくなると販売を停止します。
- 自社航路：自社で運航または契約する航路で、独自の時刻表と運賃を設定できます。
- 他のフェリー運航会社のAPI：ドキュメントのあるAPIであれば追加でき、ソースコードもお客様のものです。カスタムAPI連携をご覧ください。
島めぐり
複数区間でも、旅程は1つ、支払いも1回
島の旅が1回の航行で終わることはまれです。飛行機で到着し、港へ移動し、ある島へ渡って次の島へ向かいます。これらの区間をまとめられることが、予約プラットフォームにフェリーAPIを組み込む利点です。
- 接続チェック各区間は前の区間の到着後、設定した最小間隔を空けて開始できるため、不可能な乗り継ぎを含む旅程は作成されません。
- 1回のチェックアウト各区間の運航会社やソースが異なっても、お客様の支払いは1回で、区間ごとにチケットが発行されます。
- 情報の引き継ぎ乗客と車両の情報は区間をまたいで引き継がれるため、同じ内容を二度入力する必要はありません。
航空券API連携で航空区間を、空港送迎テクノロジーで港までの送迎を追加できます。すべて、他の旅行APIと並んで1つのプラットフォーム上で動きます。
- アテネへ飛ぶ接続した航空券サプライヤーによる航空区間。
- 空港からピレウスへ空港からフェリーターミナルまでの送迎。
- ピレウス → ナクソス最初の航行。車と大人2名が乗船。
- ナクソスで3泊2つの航行の間のホテル滞在。
- ナクソス → サントリーニ2回目の航行。運航会社が異なる場合もあります。
フェリーAPIを自社サイトで活用しませんか
ライブデモで運航便を検索してフェリーを予約し、販売予定の航路と運航会社をお知らせください。
独自アプリを開発しますか？REST APIとWebhookはEnterpriseプランに含まれます。料金を比較するか、開発者向けドキュメントをご覧ください。
フェリーAPIとは、フェリー運航会社またはフェリー予約プラットフォームが提供するWebサービス群で、旅行サイトが港・航路・時刻表を取得し、乗客と車両の空席を確認し、予約を作成し、チケットをリアルタイムで受け取れるようにするものです。
フェリー予約では、種類とサイズで料金が決まる車両、デッキ席・座席・客室といった船内クラス、そしてペットが加わります。空席はそれぞれ別に数えられ、チェックイン期限も徒歩の乗客と車両で異なります。
はい。その便で運航会社が車両を運ぶ場合に可能です。予約では車両の種類と寸法を送信し、運賃には車両デッキのスペースが含まれます。
はい。船に客室がある場合に可能です。客室は別クラスで定員も別に管理され、通常は乗客ごとではなく1室ごとの料金です。
このページに表示されるフェリーサプライヤーは、連携ディレクトリからリアルタイムで取得しています。PHPTRAVELSはKikoto Ferriesの公式テクノロジーパートナーで、他の運航会社はカスタム連携で追加できます。
いいえ。各フェリーサプライヤーとご自身で契約し、管理画面に認証情報を入力します。PHPTRAVELSは予約プラットフォームと導入済みコネクターを提供します。
はい。お客様は区間を順に追加し、各区間は前の到着時刻と照合され、旅程全体を1回のチェックアウトで支払い、区間ごとのチケットを受け取ります。
はい。自社で運航または契約する航路、運航会社のアロットメント、APIの運航便が同じ検索結果に表示され、それぞれ独自の運賃とマークアップが適用されます。
はい。B2B代理店はエージェントポータルで、独自のマークアップまたは手数料により予約し、ウォレット残高から支払います。一般公開サイトと同じインストール環境で動作します。