전체 메뉴 닫기

공유서비스

오퍼레이션 명

요청 URL

http://apis.data.go.kr/6410000/busarrivalservice/v2/getBusArrivalItemv2

요청 Parameter
파라미터 표. 버스 도착정보 항목조회 파라미터 변수명, 타입, 설명에 대한 안내입니다.
변수명 타입 설명
serviceKey 문자열 인증키(공공데이터포털 발급)
stationId 문자열 정류소아이디
routeId 문자열 노선아이디
staOrder 문자열 정류소순번
format 문자열 응답 포맷(json/xml)
샘플 URL

stationId 가 200000177 인 정류소에 routeId 가 200000037 인 노선이 언제 도착하는지 검색할 경우:
- https://apis.data.go.kr/6410000/busarrivalservice/v2/getBusArrivalItemv2?format=json&serviceKey=공공데이터포털에서 발급받은 서비스키&stationId=200000177&routeId=200000037&staOrder=19
- 하나의 정류소에 상행, 하행 모두 정차하는 노선이 있으므로 , 요청변수로 정류소 순번(staOrder)이 필요함

공통 응답 메시지
공통 응답 메시지 표. 공통 응답 메시지 변수명, 타입, 설명에 대한 안내입니다.
변수명 타입 설명
queryTime 문자열 정보요청시간
resultCode 정수 결과코드
resultMessage 문자열 결과메시지
요청결과 출력
요청결과 출력 표. 요청결과 출력 변수명, 타입, 설명에 대한 안내입니다.
변수명 타입 설명
busArrivalItem 문자열 버스도착정보항목
crowded1 정수 첫번째차량 차내혼잡도 (1:여유, 2:보통, 3:혼잡, 4:매우혼잡) 차내혼잡도 제공노선유형 (13:일반형시내버스, 15:따복형시내버스, 23:일반형농어촌버스)
crowded2 정수 두번째차량 차내혼잡도 (1:여유, 2:보통, 3:혼잡, 4:매우혼잡) 차내혼잡도 제공노선유형 (13:일반형시내버스, 15:따복형시내버스, 23:일반형농어촌버스)
flag 문자열 상태구분(RUN:운행중 PASS:운행중 STOP:운행종료 WAIT:회차지대기)
locationNo1 정수 첫번째차량 위치 정보 (몇번째전 정류소)
locationNo2 정수 두번째차량 위치 정보 (몇번째전 정류소)
lowPlate1 정수 첫번째차량 특수차량여부 (0: 일반버스, 1: 저상버스, 2: 2층버스, 5: 전세버스, 6: 예약버스, 7: 트롤리)
lowPlate2 정수 두번째차량 특수차량여부 (0: 일반버스, 1: 저상버스, 2: 2층버스, 5: 전세버스, 6: 예약버스, 7: 트롤리)
plateNo1 문자열 첫번째차량 차량번호
plateNo2 문자열 두번째차량 차량번호
predictTime1 정수 첫번째차량 도착예상시간 (몇 분후 도착예정. 분단위)
predictTime2 정수 두번째차량 도착예상시간 (몇 분후 도착예정. 분단위)
remainSeatCnt1 정수 첫번째 차량 차내빈자리수 (-1:정보없음, 0~:빈자리 수) 차내빈자리수 제공노선유형 (11: 직행좌석형시내버스, 12:좌석형시내버스, 14: 광역급행형시내버스, 16: 경기순환버스, 17: 준공영제직행좌석시내버스, 21: 직행좌석형농어촌버스, 22: 좌석형농어촌버스)
remainSeatCnt2 정수 두번째 차량 차내빈자리수 (-1:정보없음, 0~:빈자리 수) 차내빈자리수 제공노선유형 (11: 직행좌석형시내버스, 12:좌석형시내버스, 14: 광역급행형시내버스, 16: 경기순환버스, 17: 준공영제직행좌석시내버스, 21: 직행좌석형농어촌버스, 22: 좌석형농어촌버스)
routeDestId 정수 진행방향 마지막 정류소아이디
routeDestName 문자열 진행방향 마지막 정류소명
routeId 정수 노선아이디
routeName 문자열 노선명
routeTypeCd 정수 노선유형코드 (11: 직행좌석형시내버스, 12:좌석형시내버스, 13:일반형시내버스, 14: 광역급행형시내버스, 15: 따복형시내버스, 16: 경기순환버스, 21: 직행좌석형농어촌버스, 22: 좌석형농어촌버스, 23:일반형농어촌버스, 30: 마을버스, 41: 고속형시외버스, 42: 좌석형시외버스, 43: 일반형시외버스, 51: 리무진공항버스, 52: 좌석형공항버스, 53: 일반형공항버스)
staOrder 정수 정류소순번 (요청변수 정류소가 노선의 몇번째 정류소인지 나타냄)
stationId 정수 정류소아이디 (요청변수 정류소 아이디)
stationNm1 문자열 첫번째차량 위치 정류소명
stationNm2 문자열 두번째차량 위치 정류소명
taglessCd1 정수 첫번째 차량 태그리스 서비스 제공여부 (0:일반차량, 1:태그리스차량)
taglessCd2 정수 두번째 차량 태그리스 서비스 제공여부 (0:일반차량, 1:태그리스차량)
turnSeq 정수 노선의 회차점 순번
vehId1 정수 첫번째 차량 차량아이디
vehId2 정수 두번째 차량 차량아이디
predictTimeSec1 정수 첫번째차량 도착예상시간 (몇 초후 도착예정. 초단위)
predictTimeSec2 정수 두번째차량 도착예상시간 (몇 초후 도착예정. 초단위)

※ 빈자리 수 정보는 2015. 05. 01 (금) 오전 10시 부터 제공됩니다.

에러코드 리스트
실패 시 에러 출력 표. 에러코드 변수명, 에러메시지 대한 안내입니다.
에러코드 에러메시지
0 정상적으로 처리되었습니다.
1 시스템 에러가 발생하였습니다.
2 필수 요청 Parameter가 존재하지 않습니다.
4 결과가 존재하지 않습니다.