728x90
국토교통부 TAGO 고속버스정보 API는 공공데이터포털에서 제공하는 전국 고속버스 노선·배차·차량·요금 정보를 조회하는 REST 방식의 오픈 API입니다.data+1
개요
- 제공 기관: 국토교통부, 국가대중교통정보센터(TAGO) 연계.kotsa+1
- 주요 기능:
- 출·도착지(터미널 코드) 기준 운행 시간표 조회
- 노선 ID, 버스 등급(우등, 프리미엄 등) 정보 제공
- 요금 및 배차 정보 제공.data.edmgr+1
- 데이터 형식: JSON 및 XML 지원, REST URL 호출 방식.[data.go]
사용 준비 절차
- 공공데이터포털 회원 가입 및 로그인.[data.go]
- “국토교통부_(TAGO)_고속버스정보” 데이터셋으로 이동 후 오픈API “활용신청” 클릭.[data.go]
- 승인 후 발급된 인증키(serviceKey)를 API 호출 시 파라미터로 사용.[data.go]
핵심 엔드포인트 개념
공공데이터포털 상세 페이지의 “오픈API 상세”에서 실제 URL 패턴과 샘플이 제공됩니다. 일반적으로 다음과 같은 항목을 쿼리로 사용합니다.[data.go]
- serviceKey: 발급받은 인증키 (필수).[data.go]
- depTerminalId: 출발 터미널 ID (예: 서울경부).[data.go]
- arrTerminalId: 도착 터미널 ID.[data.go]
- depPlandTime: 출발 일자 YYYYMMDD 형식.[data.go]
- busGradeId: 버스 등급 (옵션).[data.go]
- numOfRows, pageNo: 페이징 처리.[data.go]
응답에는 노선ID(routeId), 출발·도착 시간, 버스 등급명(gradeNm), 출발지/도착지 이름 등 필드가 포함됩니다.[data.go]
관련 API들
TAGO 계열에는 고속버스 정보 외에도 다음과 같은 연계 API가 있습니다.data+2
또, TAGO 13종 API 일부는 중지·대체 공지가 있었으므로, 실제 개발 시 공공데이터포털 공지사항에서 최신 제공 여부와 대체 서비스 여부를 확인하는 것이 좋습니다.[data.go]
예시 활용 방향
- 웹에서 “출발지/도착지/날짜”를 입력받아 TAGO API로 고속버스 시간표·요금 조회 기능 구현.data.edmgr+1
- 실시간 도착정보 API와 결합해 “예정 출발편 + 실시간 도착예정”을 함께 보여주는 검색 서비스 구축.k-bus-tago.vercel+1
728x90