요청 URL
http://apis.data.go.kr/6410000/busarrivalservice/getBusArrivalList
요청 Parameter
파라미터 표. 버스 도착정보 목록조회 파라미터 변수명, 타입, 설명에 대한 안내입니다.
변수명 |
타입 |
설명 |
serviceKey |
String(필수) |
발급받은 키값 |
stationId |
String(필수) |
정류소아이디 |
샘플 URL
수일중학교 정류장의 버스도착정보를 검색할 경우:
- http://openapi.gbis.go.kr/ws/rest/busarrivalservice/station?serviceKey=1234567890&stationId=200000078
요청결과 출력
요청결과 출력 표. 요청결과 출력 변수명, 타입, 설명에 대한 안내입니다.
변수명 |
타입 |
설명 |
busArrivalList |
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 서비스 준비 중입니다 |