교통 약자 전용-특정 정류소 버스 위치 정보 목록 조회

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

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

상세기능 번호	4	상세기능 유형	조회
상세기능명	getLowBusPosByRouteStList
상세기능 설명	노선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/low-bus-pos-by-route-stlist

Query Parameters

Name	Type	Description
busRouteId*	number	노선 ID(9자리 숫자)
endOrd*	String	종료 정류소 순번
startOrd*	String	시작 정류소 순번

Headers

Name	Type	Description
Authorization*	string	사용자ID;secret key

200: OK 응답 반환 완료

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	구간순번
sectDist	구간옵셋거리(Km)	10	Y	0	구간옵셋거리(Km)
stopFlag	정류소도착여부	1	Y	0	정류소도착여부 (0:운행중, 1:도착)
sectionId	구간 ID	1	Y	111702375	구간 ID
dataTm	제공시간	14	Y	20190109162833	제공시간
tmX	맵매칭X좌표 (WGS84)	32	Y	126.910807	맵매칭X좌표 (WGS84)
tmY	맵매칭Y좌표 (WGS84)	32	Y	37.614178	맵매칭Y좌표 (WGS84)
vehId	버스 ID	9	Y	111033401	버스 ID
plainNo	차량번호	128	Y	서울74사2523	차량번호
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: 만차)

요청 및 응답 예시

URI

https://i48ojxo10p.apigw.ntruss.com/public-bus-location/v1/low-bus-pos-by-route-stlist?busRouteId=100100118&startOrd=1&endOrd=15

Response

{
  "ServiceResult": {
      "comMsgHeader": "",
      "msgHeader": {
           "headerCd": 0,
           "headerMsg": "정상적으로 처리되었습니다.",
           "itemCount": 0
      },
      "msgBody": {
           "itemList": [
              {
                  "stopFlag": 0,
                  "tmY": 37.614271,
                  "isFullFlag": 0,
                  "lastStnId": 111000299,
                  "plainNo": "서울75사2646",
                  "sectDist": 0,
                  "sectionId": 111700219,
                  "posX": 192252.08905671147,
                  "posY": 457195.0559744411,
                  "sectOrd": 1,
                  "dataTm": 20230319133547,
                  "vehId": 111033668,
                  "congetion": 0,
                  "busType": 1,
                  "tmX": 126.912234
              },
              {
                  "stopFlag": 1,
                  "tmY": 37.602749,
                  "isFullFlag": 0,
                  "lastStnId": 111000120,
                  "plainNo": "서울75사2645",
                  "sectDist": 45,
                  "sectionId": 111700298,
                  "posX": 192559.65371202372,
                  "posY": 455916.09345654724,
                  "sectOrd": 13,
                  "dataTm": 20230319133706,
                  "vehId": 111033526,
                  "congetion": 0,
                  "busType": 1,
                  "tmX": 126.915731
              }
          ]
      }
  }
}

오류 코드

오류코드	오류
0	정상적으로 처리되었습니다
1	시스템 오류가 발생하였습니다
2	잘못된 쿼리 요청입니다. 쿼리 변수가 정확한지 확인하세요.
3	정류소를 찾을 수 없습니다
4	노선을 찾을 수 없습니다.
5	잘못된 위치로 요청을 하였습니다. 위/경도 좌표가 정확한지 확인하세요
6	실시간 정보를 읽을 수 없습니다. 잠시 후 다시 시도하세요
7	경로 검색 결과가 존재하지 않습니다.
8	운행 종료되었습니다.