Service
서울을 제외한 전국 도시 버스 정류소의 실시간 도착 정보와 도시별 정류소 목록, 이름, 번호, 위치로 찾는 정류소 검색, 정류소 경유 노선, 노선별 경유 정류소와 첫차·막차·배차간격, 실시간 버스 위치를 국가대중교통정보센터 공공데이터로 제공합니다.
80.45%30일 가동률평균 응답1542ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-bus-arrival/approaching-buses | Shows the buses of one route that are heading to one stop in a South Korean city outside Seoul, with where each bus is now. Use when someone follows one route to one stop and wants the positions of the buses about to reach it. Do NOT use for arrival times (use stop-arrivals with route_id) or for Seoul. Returns the stop name and buses with route number, route type and coordinates; a bus is listed only while this stop is its next one, so the list is often empty. | |
| POST | /v1/korea-bus-arrival/cities | Lists every South Korean city whose bus stops publish real-time arrivals here, with the city code each arrival request needs. Use when you need a city_code for stop-arrivals or want to check whether a city is covered. Do NOT use for Seoul, which is not in this list. Returns cities with city_code and city_name. | |
| POST | /v1/korea-bus-arrival/route-bus-locations | Shows where every bus of one route is right now in a South Korean city outside Seoul, with the stop each bus was last reported at. Use when someone asks where the buses of a route are. Do NOT use for arrival times at a stop (use stop-arrivals) or for Seoul. Returns buses with vehicle number, the current stop's id, name and sequence, and coordinates when reported; an empty list means no bus of the route is running now. | |
| POST | /v1/korea-bus-arrival/route-details | Shows one bus route in a South Korean city outside Seoul: its number, type, end stops, first and last bus time and the minutes between buses on weekdays, Saturdays and Sundays. Use when someone asks when a route starts or stops running or how often it comes. Do NOT use for real-time arrivals (use stop-arrivals) or for Seoul. Returns the route with first_bus_time, last_bus_time and three interval fields in minutes; an unknown route_id is a NO_DATA error. | |
| POST |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| /v1/korea-bus-arrival/route-stops |
| Lists every stop of one bus route in a South Korean city outside Seoul, in route order, with the direction each stop belongs to. Use when someone asks where a route goes or which stops it passes. Do NOT use for the routes of one stop (use stop-routes) or for Seoul. Returns stops with stop_id, stop_name, stop_number, sequence, direction (up or down) and coordinates. |
| POST | /v1/korea-bus-arrival/search-routes | Lists the bus routes of one South Korean city outside Seoul, optionally narrowed by part of the route number, with each route's end stops and first and last bus time. Use when someone names a route number and you need its route_id for route-details, route-stops, route-bus-locations or stop-arrivals, or wants every route of a city. Do NOT use for Seoul routes or for the routes of one stop (use stop-routes). Returns routes with route_id, route_number, route type, end stops and first and last bus times, one page at a time with total_count and has_more. |
| POST | /v1/korea-bus-arrival/search-stops | Lists the bus stops of one South Korean city outside Seoul, optionally narrowed by part of the stop name, by the stop number printed at the stop, or both. Use when you know a stop's name or number but need its stop_id for stop-arrivals or stop-routes, or want to page through every stop of a city. Do NOT use for Seoul stops or to find stops around a location (use search-stops-nearby). Returns stops with stop_id, stop_name, stop_number and coordinates, one page at a time with total_count and has_more. |
| POST | /v1/korea-bus-arrival/search-stops-nearby | Lists the bus stops within about 500 metres of a point in South Korea outside Seoul, nearest first, from every city around it. Use when someone gives a place or coordinates and wants the closest stops. Do NOT use to search by stop name (use search-stops) or for Seoul. Returns stops with stop_id, stop_name, stop_number, the city_code to use with stop-arrivals, coordinates and distance_meters; an empty list means no stop within the radius. |
| POST | /v1/korea-bus-arrival/stop-arrivals | Shows the next bus of every route serving one bus stop, soonest first, in a South Korean city outside Seoul. Use when someone asks when the next bus comes at a stop they can identify by city code and stop id, optionally for one route. Do NOT use for Seoul stops or for timetables. Returns stop_name and arrivals with route number, route type, low-floor flag, stops to go, seconds to go and estimated arrival time; an empty list means no bus is on its way right now, which also happens for an unknown stop id. |
| POST | /v1/korea-bus-arrival/stop-routes | Lists every bus route that serves one bus stop in a South Korean city outside Seoul, in route number order. Use when someone asks which buses stop at a stop, or needs a route_id to narrow stop-arrivals. Do NOT use for real-time arrivals (use stop-arrivals) or for Seoul. Returns routes with route_id, route_number, route type and the route's first and last stop; an empty list also means an unknown stop id. |