ServiceBlog

노선 버스 위치 정보 목록 조회

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

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

상세기능 번호

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

Name
Type
Description

busRouteId*

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

각 항목 리스트

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?