지상 교통 API
여행사를 위한 교통 API: 픽업, 철도, 페리를 도어 투 도어로
여행은 비행기가 착륙한다고 끝나지 않습니다. 교통 API를 사용하면 도착장에서 호텔 문 앞까지 이어지는 공항 픽업, 기차, 버스, 페리를 웹사이트에서 판매할 수 있습니다. 이 페이지에서는 지상 교통 API 유형별로 필요한 정보와 차이점, 그리고 PHPTRAVELS가 모든 구간을 하나의 여행으로 판매하는 방식을 설명합니다.
- 공항 픽업
- 철도, 버스, 페리
- 항공편 연동 픽업
- 하나의 여행, 한 번의 결제
도어 투 도어
여섯 구간, API에 던지는 여섯 가지 질문
한 명의 여행자를 착륙부터 체크인까지 따라가 봅니다. 각 구간은 공급사가 다른 별개의 상품이며, 가격을 내기 전에 각 공급사 API가 요구하는 정보도 서로 다릅니다.
01
항공편 도착
여정의 기준점입니다. 편명, 공항, 터미널, 도착 시각이 이후 모든 구간의 바탕이 됩니다.
02
공항 픽업
API 필요 정보
탑승 공항 또는 주소, 하차 주소, 날짜와 시간, 승객 수, 수하물, 편명.
03
기차
API 필요 정보
출발역과 도착역, 날짜, 출발 시간대, 승객 연령, 보유한 철도 패스.
04
버스
API 필요 정보
출발·도착 도시 또는 정류장, 여행 날짜, 승객 수. 이어서 좌석 배치도에서 승차 지점과 좌석을 선택합니다.
05
페리
API 필요 정보
출발항과 도착항, 출항 날짜, 승객 유형, 그리고 차량이 있으면 종류와 길이, 또는 객실.
06
호텔 문 앞
호텔 주소와 체크인 날짜가 연결을 마무리하며 마지막 구간의 하차 지점이 됩니다.
대부분의 여행사는 이미 항공권과 객실을 판매합니다. 그 사이 구간은 여행자가 다른 곳에서 예약하는 부분이며, 연결에 실패하면 손실이 가장 큰 구간입니다. 교통 API로 이 틈을 메우면 픽업, 기차, 버스, 선박 예약과 결제, 서류 발급까지 직접 처리할 수 있습니다.
모든 교통수단을 아우르는 단일 지상 교통 API는 없습니다. 픽업 업체, 철도 회사, 버스 운영사, 페리 운영사가 각자 자체 API를 제공합니다. 여행자에게는 하나의 여정이지만, 내부적으로는 여러 공급사를 플랫폼이 함께 검색하고 가격을 산정하고 확정해야 합니다. 픽업 부분은 공항 픽업 기술 페이지에서 자세히 다룹니다.
교통수단 비교
픽업, 철도, 버스, 페리 API 한눈에 비교
검색 입력값, 가격 산정 단위, 여행자가 받는 서류는 교통수단마다 다릅니다. 연동할 때 중요한 차이점은 다음과 같습니다.
| 전용 픽업 | 합승 픽업 | 철도 | 버스 | 페리 | |
|---|---|---|---|---|---|
| 검색 입력값 | 탑승·하차 지점, 날짜, 시간, 승객 수, 수하물 | 공항, 목적지 구역 또는 호텔, 날짜, 시간, 승객 수 | 역, 날짜, 시간대, 승객 연령, 철도 패스 | 도시 또는 정류장, 날짜, 승객 수 | 항구, 날짜, 승객 유형, 차량, 객실 |
| 가격 산정 단위 | 인원과 관계없이 경로 또는 거리별 차량 한 대 | 여러 호텔을 도는 셔틀의 좌석당 | 운임 유형과 등급별 좌석당, 구간별 또는 통과 운임 | 좌석당, 정류장 조합·좌석 유형·침대칸에 따라 다른 경우가 많음 | 승객과 등급별, 차량은 종류와 길이별 또는 객실별 |
| 티켓 또는 바우처 | 만남 장소, 기사 연락처, 대기 시간이 적힌 바우처 | 셔틀 픽업 시간대와 정류장이 적힌 바우처 | QR 코드가 있는 전자 티켓, 구간별 객차와 좌석 | PNR, 좌석, 승차 지점이 적힌 모바일 티켓 | 운항편, 좌석 또는 객실, 차량이 적힌 탑승권 |
| 변경 | 시간·주소 변경은 보통 픽업 전 마감 시각까지 가능 | 마감 시각은 비슷하나 픽업 시간 조정은 더 제한적 | 운임에 따라 결정: 세이버, 세미 플렉스, 플렉스 조건 | 출발 몇 시간 전인지에 따른 환불 단계, 운영사별 상이 | 운영사의 운임 규정과 운항편의 체크인 마감에 따라 결정 |
| 흔한 함정 | 항공편 지연, 도착장에서 기사가 여행자를 찾지 못함 | 다른 항공편을 기다리는 시간, 여러 하차 지점으로 길어지는 이동 | 너무 빠듯해서 놓치는 환승, 필수인 좌석 예약 | 잘못된 승차 지점, 보류 없이 두 번 판매된 좌석 | 날씨로 인한 결항, 잘못된 길이로 예약된 차량 |
PHPTRAVELS에는 교통수단별 전용 모듈이 있습니다. 픽업은 렌터카·픽업, 국제 여정과 패스는 철도, 국내 철도망은 기차, 장거리 버스 좌석은 버스, 항로는 페리입니다.
항공편 연동 픽업
픽업 예약에서 가장 중요한 항목은 편명입니다
예정된 착륙 시각에 맞춰 예약한 공항 픽업은 항공편이 지연되는 순간 어긋납니다. 픽업 API가 편명을 요구하는 이유는 실제 도착에 맞춰 픽업 시간을 조정하기 위해서입니다.
편명과 도착 시각
예약 시 입력받거나 같은 여행에서 판매한 항공편에서 가져오므로 여행자가 두 번 입력할 필요가 없습니다.
착륙에 맞춰 바뀌는 픽업
편명으로 확인한 도착 시각에 따라 픽업이 정해지므로, 지연되어도 기사를 놓치거나 대기 요금이 붙지 않습니다.
무료 대기 시간
대기 시간은 예약 시각이 아닌 실제 착륙 시각부터 계산합니다. 규정이 바우처에 인쇄되어 여행자도 확인할 수 있습니다.
미팅 앤 그리팅
이름 팻말, 만남 장소, 기사 전화번호가 바우처와 기사의 작업 지시서에 기재됩니다.
픽업은 항공권 API와 함께 판매할 때 가장 잘 팔립니다. 항공편이 이미 예약에 들어 있어서 여행자가 보기 전에 픽업 양식의 절반이 채워져 있기 때문입니다.
- 09:20픽업 예약편명과 도착 예정 시각이 픽업과 함께 저장됨.
- 12:40항공편 지연해당 편명의 새 도착 시각을 수신함.
- 12:41픽업 시간 변경새 시각에 맞춰 기사 배차, 여행자의 조치 불필요.
- 15:18항공편 착륙실제 착륙 시각부터 무료 대기 시간 시작.
- 15:34미팅 앤 그리팅기사가 이름 팻말을 들고 도착장에서 대기.
- 16:22호텔 하차이동 완료, 관리자 화면에서 예약 종료.
예시 시각이며 단순화한 것입니다
PHPTRAVELS에 준비됨
교통수단별로 묶은 지상 교통 공급사
아래 픽업, 철도, 페리 공급사는 이미 PHPTRAVELS에 연결되어 있습니다. 각 공급사와 계약하고 관리자 화면에 자체 인증 정보를 입력하면 바로 운영할 수 있습니다. 목록은 실시간 연동 디렉터리에서 가져옵니다.
철도1
HKINT
버스 및 현지 운영사
자체 버스와 노선을 등록하거나, 제휴 운영사가 직접 운행을 관리하게 하거나, 맞춤형 API 연동으로 운영사 시스템에 연결할 수 있습니다.
모든 교통수단에서 자체 재고도 판매할 수 있습니다. 보유 차량과 고정 노선 요금, 철도 할당 좌석, 자체 항로와 버스 등입니다. 전체 여행 XML API 공급사 목록도 확인해 보세요.
하나의 여행으로 판매
뒤에는 여러 공급사, 앞에는 하나의 예약
여행자는 다섯 회사에서 다섯 개의 확인서를 받고 싶어 하지 않습니다. 예약 플랫폼은 모든 구간을 하나의 일정, 한 번의 결제, 한 세트의 서류로 묶으면서도 각 공급사에는 개별 예약을 전달합니다.
- 항공편 · 도착확정됨
- 전용 픽업 · 공항에서 역까지확정됨
- 기차 · 2등석, 좌석 지정확정됨
- 페리 · 데크석, 승용차 1대확정됨
- 호텔 · 3박확정됨
- 한 번의 결제로 완료
- 바우처, 티켓, 청구서를 이메일 한 통으로
- 01
구간별 검색
항공편, 픽업, 기차, 버스, 페리를 같은 사이트와 같은 결제 화면에서 다룹니다.
- 02
연결 확인
페리는 이전 구간이 도착한 뒤에 출발해야 하며, 철도 환승은 역마다 설정한 시간을 지킵니다.
- 03
결제는 한 번
여행자는 자사 결제 게이트웨이로 한 번만 결제하고, 에이전트는 B2B 에이전트 지갑에서 결제합니다.
- 04
공급사별 예약
각 구간은 해당 공급사에서 확정되며 고유한 예약번호, 조건, 바우처 또는 티켓을 가집니다.
- 05
하나의 여행으로 관리
모든 구간의 변경, 취소, 수익을 하나의 관리자 화면에서 추적하고 구간마다 마크업을 설정할 수 있습니다.
자체 앱이나 파트너 채널을 구축하시나요? Enterprise 요금제에서는 PHPTRAVELS REST API와 웹훅이 연결된 모든 공급사의 예약을 하나의 형식으로 제공합니다. 요금제는 가격에서 비교하거나 개발자 문서를 읽어 보세요.
교통 API는 지상 교통 공급사가 제공하는 웹 서비스 모음으로, 여행 웹사이트가 픽업, 기차, 버스 좌석, 페리 운항편을 실시간으로 검색하고 가격을 산정하고 예약하며 여행자용 바우처나 티켓을 받을 수 있게 해 줍니다.
공항 픽업 API는 공항과 주소, 호텔 또는 구역 사이의 전용·합승 픽업 옵션을 차량당 또는 좌석당 가격으로 반환합니다. 예약하면 기사, 만남 장소, 바우처가 포함된 픽업이 생성됩니다.
아니요. 픽업, 철도, 버스, 페리는 보통 서로 다른 공급사가 판매하며 각자 API를 가지고 있습니다. 예약 플랫폼이 여러 API를 연결해 각 구간을 하나의 여행으로 보여 줍니다.
편명이 예약에 포함되어 있으면 픽업이 실제 도착 시각에 맞춰 조정되고 무료 대기 시간도 실제 착륙부터 시작됩니다. 정확한 정책은 픽업 공급사에 따라 다르므로 바우처에 표시해 두세요.
전용 픽업은 차량 단위로 가격이 정해지며 한 팀을 목적지까지 바로 데려다 줍니다. 합승 픽업은 좌석 단위로 가격이 정해지고 여러 팀이 함께 타므로 더 저렴하지만 정차가 많아 더 오래 걸립니다.
현재 Mozio, KiwiTaxi 같은 픽업 공급사와 철도 공급사 HKINT, 페리 공급사 Kikoto Ferries가 연결되어 있으며, 그 외 공급사는 연동 디렉터리에 나와 있습니다. 이 페이지의 목록은 해당 디렉터리에서 실시간으로 불러옵니다.
아니요. 각 공급사와 직접 계약하고 관리자 화면에 자체 인증 정보를 입력하셔야 합니다. PHPTRAVELS는 예약 플랫폼과 준비된 커넥터를 제공합니다.
네. 각 모듈에서 공급사 API와 함께 자체 재고도 판매할 수 있습니다. 보유 차량과 고정 노선 요금, 버스와 좌석 배치, 철도 할당 좌석, 페리 항로 등입니다.
네. 에이전트는 B2B 포털에서 자신의 가격과 수수료로 모든 구간을 예약하고, 지갑 또는 신용 한도로 결제하며, 동일한 바우처와 티켓을 받습니다.