전체 메뉴 닫기

공유서비스

오퍼레이션 명

요청 URL

http://openapi.gbis.go.kr/ws/rest/busarrivalservice

요청 Parameter
파라미터 표. 버스 도착정보 항목조회 파라미터 변수명, 타입, 설명에 대한 안내입니다.
변수명 타입 설명
serviceKey String(필수) 발급받은 키값
stationId String(필수) 정류소아이디
routeId String(필수) 노선아이디
staOrder String(필수) 정류소순번
샘플 URL

13번 일반형버스가 장안문 정류소에 언제 도착하는지 검색할 경우:
- http://openapi.gbis.go.kr/ws/rest/busarrivalservice?serviceKey=1234567890&stationId=200000177&routeId=200000037&staOrder=19

요청결과 출력
요청결과 출력 표. 요청결과 출력 변수명, 타입, 설명에 대한 안내입니다.
변수명 타입 설명
busArrivalItem String 버스도착정보항목
flag String 상태구분 (RUN:운행중, PASS:운행중, STOP:운행종료, WAIT:회차지대기)
locationNo1 String 첫번째차량 위치 정보
locationNo2 String 두번째차량 위치 정보
lowPlate1 String 첫번째차량 저상버스여부 (0:일반버스, 1:저상버스)
lowPlate2 String 두번째차량 저상버스여부 (0:일반버스, 1:저상버스)
plateNo1 String 첫번째차량 차량번호
plateNo2 String 두번째차량 차량번호
predictTime1 String 첫번째차량 버스도착예정시간 (몇분후 도착예정)
predictTime2 String 두번째차량 버스도착예정시간 (몇분후 도착예정)
remainSeatCnt1 String 첫번째차량 빈자리수 (-1:정보없음, 0~:빈자리 수)
remainSeatCnt2 String 두번째차량 빈자리수 (-1:정보없음, 0~:빈자리 수)
routeId String 노선ID
staOrder String 노선의 정류소 순번
stationId String 정류소ID

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

공통 응답 메시지
공통 응답 메시지 표. 공통 응답 메시지 변수명, 타입, 설명에 대한 안내입니다.
변수명 타입 설명
queryTime String 정보추출시간
resultCode String 결과코드
resultMessage String 결과메시지
에러코드 상세 리스트
실패 시 에러 출력 표. 에러코드 변수명, 에러메시지 대한 안내입니다.
에러코드 에러메시지
0 정상적으로 처리되었습니다.
1 시스템 에러가 발생하였습니다.
2 필수 요청 Parameter가 존재하지 않습니다.
3 필수 요청 Parameter가 잘못되었습니다.
4 결과가 존재하지 않습니다.
5 필수요청 Parameter(인증키)가 존재하지 않습니다.
6 등록되지 않은 키 입니다.
7 사용할 수 없는(등록은 되었으나, 일시적으로 사용 중지된)키입니다.
8 요청 제한을 초과하였습니다.
20 잘못된 위치로 요청하였습니다. 위경도 좌표값이 정확한지 확인하십시오.
21 노선번호는 1자리 이상 입력하세요.
22 정류소 명/번호는 1자리 이상 입력하세요.
23 버스도착정보가 존재하지 않습니다.
31 존재하지 않는 출발 정류소 아이디(ID)/번호입니다.
32 존재하지 않는 도착 정류소 아이디(ID)/번호입니다.
99 API 서비스 준비 중입니다