특정 차량 위치 정보 조회
상세기능 번호
3
상세기능 유형
조회
상세기능명
getBusPosByVehIdItem
상세기능 설명
차량ID로 위치정보를 조회한다
Call Back URL
https://i48ojxo10p.apigw.ntruss.com/public-bus-location/v1/bus-pos-by-vehIditem
최대 메시지 사이즈
3MB
평균 응답 시간
100 ms
초당 최대 트랜잭션
30 tps
특정 차량 위치 정보 항목 API
GET https://4vh6qtie3c.apigw.ntruss.com/public-bus-location/v1/bus-pos-by-vehIditem
Query Parameters
vehId*
number
버스 ID(9자리 숫자)
Headers
Authorization*
string
사용자ID;secret key
Response Body
ServiceResult
조회 결과
Y
조회 결과
comMsgHeader
공통메시지 헤더
128
N
특이사항
공통메시지 헤더
headerCd
헤더 코드
1
Y
0
결과 코드
headerMsg
헤더 메시지
128
Y
정상적으로 처리되었습니다.
결과 메시지
itemCount
항목 개수
1
Y
0
항목 개수
msgBody
본문 내용
Y
본문 내용
itemList
각 항목 리스트
Y
각 항목 리스트
vehId
버스ID
9
Y
111033115
버스ID
stId
정류소 고유 ID
9
Y
111000055
정류소 고유 ID
stOrd
정류소순번
10
Y
1
정류소순번
stopFlag
정류소도착여부
1
Y
0
정류소도착여부 (0:운행중, 1:도착)
dataTm
제공시간
14
Y
20190109160221
제공시간
tmX
맵매칭X좌표 (WGS84)
32
Y
126.910807
맵매칭X좌표 (WGS84)
tmY
맵매칭Y좌표 (WGS84)
32
Y
37.614178
맵매칭Y좌표 (WGS84)
plainNo
차량번호
128
Y
서울74사2576
차량번호
busType
차량유형
1
Y
0
차량유형 (0:일반버스, 1:저상버스, 2:굴절버스)
lastStnId
최종정류소 고유 ID
9
Y
111000055
최종정류소 고유 ID
posX
맵매칭X좌표 (GRS80)
32
Y
192126.1048274704
맵매칭X좌표 (GRS80)
posY
맵매칭Y좌표 (GRS80)
32
Y
457184.85381605756
맵매칭Y좌표 (GRS80)
congetion
혼잡도
1
Y
0
혼잡도(0 : 없음, 3 : 여유, 4 : 보통, 5 : 혼잡, 6 : 매우혼잡)
isFullFlag
만차여부
1
Y
0
만차여부(0 : 만차아님, 1: 만차)
요청 및 응답 예시
https://i48ojxo10p.apigw.ntruss.com/public-bus-location/v1/bus-pos-by-vehIditem?vehId=111033115
오류 코드
0
정상적으로 처리되었습니다
1
시스템 오류가 발생하였습니다
2
잘못된 쿼리 요청입니다. 쿼리 변수가 정확한지 확인하세요.
3
정류소를 찾을 수 없습니다
4
노선을 찾을 수 없습니다.
5
잘못된 위치로 요청을 하였습니다. 위/경도 좌표가 정확한지 확인하세요
6
실시간 정보를 읽을 수 없습니다. 잠시 후 다시 시도하세요
7
경로 검색 결과가 존재하지 않습니다.
8
운행 종료되었습니다.
Was this helpful?