ServiceBlog

특정 차량 위치 정보 조회

캐릭터 인코딩은 UTF-8 을 기본으로 합니다.

secret key는 ‘서비스콘솔’ – ‘Sub Account’ 생성 시 키를 발급 받을 수 있습니다.

상세기능 번호

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

Name
Type
Description

vehId*

number

버스 ID(9자리 숫자)

Headers

Name
Type
Description

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?