요청 URL
http://apis.data.go.kr/6410000/buslocationservice/getBusLocationList
요청 Parameter
파라미터 표. 버스 위치정보 목록조회 파라미터 변수명, 타입, 설명에 대한 안내입니다.
| 변수명 |
타입 |
설명 |
| serviceKey |
String(필수) |
발급받은 키값 |
| routeId |
String(필수) |
노선아이디 |
샘플 URL
7770번 직행좌석형버스의 위치정보를 검색할 경우:
- http://openapi.gbis.go.kr/ws/rest/buslocationservice?serviceKey=1234567890&routeId=233000031
요청결과 출력
요청결과 출력 표. 요청결과 출력 변수명, 타입, 설명에 대한 안내입니다.
| 변수명 |
타입 |
설명 |
| busLocationList |
String |
버스위치정보목록 |
| endBus |
String |
막차여부 (0:해당사항없음, 1:막차) |
| lowPlate |
String |
저상버스여부 (0:일반버스, 1:저상버스) |
| plateNo |
String |
차량번호 |
| plateType |
String |
차종 (0:정보없음, 1:소형승합차, 2:중형승합차, 3:대형승합차, 4:2층버스) |
| remainSeatCnt |
String |
차량 빈자리수 (-1:정보없음, 0~:빈자리 수) |
| routeId |
String |
노선ID |
| stationId |
String |
정류소ID |
| stationSeq |
String |
정류소 순서 |
공통 응답 메시지
공통 응답 메시지 표. 공통 응답 메시지 변수명, 타입, 설명에 대한 안내입니다.
| 변수명 |
타입 |
설명 |
| 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 서비스 준비 중입니다 |