요청 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 서비스 준비 중입니다 |