노선 버스 위치 정보 목록 조회
상세기능 번호
2
상세기능 유형
조회
상세기능명
getBusPosByRtidList
상세기능 설명
노선ID로 차량들의 위치정보를 조회한다
Call Back URL
https://i48ojxo10p.apigw.ntruss.com/public-bus-location/v1/bus-pos-by-rtidlist
최대 메시지 사이즈
3MB
평균 응답 시간
100 ms
초당 최대 트랜잭션
30 tps
노선 버스 위치 정보 목록 조회 API
GET https://4vh6qtie3c.apigw.ntruss.com/public-bus-location/v1/bus-pos-by-rtidlist
Query Parameters
busRouteId*
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
각 항목 리스트
sectOrd
구간순번
10
Y
1
구간순번
fullSectDist
정류소간 거리
10
Y
0.471
정류소간 거리
sectDist
구간옵셋거리 (Km)
10
Y
0
구간옵셋거리 (Km)
rtDist
노선옵셋거리 (Km)
10
Y
46.2
노선옵셋거리 (Km)
stopFlag
정류소도착여부
1
Y
0
정류소도착여부 (0:운행중, 1:도착)
sectionId
구간ID
9
Y
111600950
구간ID
dataTm
제공시간
14
Y
20190109160221
제공시간
gpsX
맵매칭X좌표 (WGS84)
32
Y
126.910807
맵매칭X좌표 (WGS84)
gpsY
맵매칭Y좌표 (WGS84)
32
Y
37.614178
맵매칭Y좌표 (WGS84)
vehId
버스 ID
9
Y
111033115
버스 ID
plainNo
차량번호
128
Y
서울74사2576
차량번호
busType
차량유형
1
Y
0
차량유형 (0:일반버스, 1:저상버스, 2:굴절버스)
lastStTm
종점도착소요시간
10
Y
12353
종점도착소요시간
nextStTm
다음정류소도착소요시간
10
Y
362
다음정류소도착소요시간
isrunyn
해당차량 운행여부 (0: 운행종료, 1: 운행)
1
Y
1
해당차량 운행여부 (0: 운행종료, 1: 운행)
trnstnid
회차지 정류소ID
9
Y
119000076
회차지 정류소ID
islastyn
막차여부
1
Y
0
막차여부(0 : 막차아님, 1: 막차)
isFullFlag
만차여부
1
Y
0
만차여부(0 : 만차아님, 1: 만차)
posX
맵매칭X좌표 (GRS80)
32
Y
192126.1048274704
맵매칭X좌표 (GRS80)
posY
맵매칭Y좌표 (GRS80)
32
Y
457184.85381605756
맵매칭Y좌표 (GRS80)
lastStnId
최종정류소 고유 ID
9
Y
111000055
최종정류소 고유 ID
congetion
혼잡도
1
Y
3
혼잡도(0 : 없음, 3 : 여유, 4 : 보통, 5 : 혼잡, 6 : 매우혼잡)
nextStId
다음정류소아이디
9
Y
111000136
다음정류소아이디
요청 및 응답 예시
https://i48ojxo10p.apigw.ntruss.com/public-bus-location/v1/bus-pos-by-rtidlist?busRouteId=100100118
오류 코드
0
정상적으로 처리되었습니다
1
시스템 오류가 발생하였습니다
2
잘못된 쿼리 요청입니다. 쿼리 변수가 정확한지 확인하세요.
3
정류소를 찾을 수 없습니다
4
노선을 찾을 수 없습니다.
5
잘못된 위치로 요청을 하였습니다. 위/경도 좌표가 정확한지 확인하세요
6
실시간 정보를 읽을 수 없습니다. 잠시 후 다시 시도하세요
7
경로 검색 결과가 존재하지 않습니다.
8
운행 종료되었습니다.
Was this helpful?