API PLEX Developer Guide
ServiceBlog
한국어
한국어
  • API PLEX 개발자 가이드
  • Release Note
    • Release Note
  • Service
    • Biz Message
      • SMS
      • LMS
      • MMS
      • MMS 이미지 업로드
      • 메시지 발송 결과(WebHook)
    • RCS
      • SMS
      • LMS
      • MMS
      • 캐러셀
      • 템플릿
      • 이미지 업로드 API
      • 메시지 발송 결과 (WebHook)
      • 참조코드 및 값 분류
        • RCS 결과 코드
        • 메시지 발송 응답 코드
        • GATEWAY 오류코드
        • message base ID
    • Kakao Message
      • 알림톡
      • 친구톡
      • 이미지 업로드 API
      • Failback
      • 메시지 발송 결과 (WebHook)
    • Naver Message
      • 네이버 톡톡
      • 네이버 톡톡 (광고성)
    • Global Message
      • GMS
        • GMS (v2)
        • GMS (v1)
        • 메세지 발송 결과(WebHook)
        • 참조 코드
          • 메시지 상태 코드
          • 서비스 오류 코드
      • WhatsApp
      • Viber
    • Email
      • 이메일 스탠다드
      • 이메일 유효검사
    • Push
      • 앱푸시
        • 앱푸시 일괄발송
        • 앱푸시 단건발송
      • 웹푸시
        • 웹푸시 구독 신청
        • 웹푸시 일괄 발송
    • Additional Service
      • 080 수신거부
      • Fax
  • MarketPlace
    • Public API Market
      • 버스 노선 정보 조회 서비스
        • 노선 기본 정보 항목 조회
        • 노선 경로 목록 조회
        • 노선 번호 목록 조회
        • 노선 별 경유 정류소 목록 조회
      • 버스 위치 정보 조회 서비스
        • 특정 정류소 버스 위치 정보 조회
        • 노선 버스 위치 정보 목록 조회
        • 특정 차량 위치 정보 조회
        • 교통 약자 전용-특정 정류소 버스 위치 정보 목록 조회
        • 교통 약자 전용-노선 버스 위치 정보 목록 조회
      • 부동산 거래 신고된 아파트의 전월세 정보 조회
      • 지하철 특정 호선 역 간 거리 및 소요 시간 조회
      • 지하철 특정 호선 지하철역 정보 조회
      • 병원 정보 조회
      • 약국 정보 조회 서비스
        • 약국 목록 정보 조회
        • 약국 위치 정보 조회
        • 약국 별 기본정보 조회
        • 약국 FullData 내려받기
      • 미세먼지 경보 발령 현황 조회
    • AI Market
      • OpenAI
        • chatGPT 3.5 Turbo
Powered by GitBook
On this page
  • 특정 정류소 버스 위치 정보 목록 API
  • Response Body
  • 요청 및 응답 예시
  • 오류 코드

Was this helpful?

  1. MarketPlace
  2. Public API Market
  3. 버스 위치 정보 조회 서비스

특정 정류소 버스 위치 정보 조회

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

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

상세기능 번호

1

상세기능 유형

조회

상세기능명

getBusPosByRouteStList

상세기능 설명

노선ID와 구간정보로 차량들의 위치정보를 조회한다

Call Back URL

https://i48ojxo10p.apigw.ntruss.com/public-bus-location/v1/bus-pos-by-route-stlist

최대 메시지 사이즈

3MB

평균 응답 시간

100 ms

초당 최대 트랜잭션

30 tps

특정 정류소 버스 위치 정보 목록 API

GET https://4vh6qtie3c.apigw.ntruss.com/public-bus-location/v1/bus-pos-by-route-stlist

Query Parameters

Name
Type
Description

busRouteId*

number

노선 ID(9자리 숫자)

endOrd*

number

종료 정류소 순번

startOrd*

number

시작 정류소 순번

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

3

구간순번

sectDist

구간옵셋거리(Km)

10

Y

183

구간옵셋거리(Km)

stopFlag

정류소도착여부

1

Y

0

정류소도착여부 (0:운행중, 1:도착)

sectionId

구간 ID

9

Y

111700442

구간 ID

dataTm

제공시간

14

Y

20170810132951

제공시간

tmX

맵매칭X좌표 (WGS84)

32

Y

126.919766

맵매칭X좌표 (WGS84)

tmY

맵매칭Y좌표 (WGS84)

32

Y

37.623303

맵매칭Y좌표 (WGS84)

vehId

버스 ID

9

Y

111033352

버스 ID

plainNo

차량번호

128

Y

서울75사2644

차량번호

busType

차량유형

1

Y

0

차량유형 (0:일반버스, 1:저상버스, 2:굴절버스)

lastStnId

최종정류장ID

9

Y

111001109

최종정류장ID

posX

맵매칭X좌표 (GRS80)

32

Y

192917.86479917663

맵매칭X좌표 (GRS80)

posY

맵매칭Y좌표 (GRS80)

32

Y

458196.80905869836

맵매칭Y좌표 (GRS80)

routeId

노선 ID

9

Y

100100118

노선 ID

요청 및 응답 예시

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

{
  "ServiceResult": {
      "comMsgHeader": "",
      "msgHeader": {
           "headerCd": 0,
           "headerMsg": "정상적으로 처리되었습니다.",
           "itemCount": 0
      },
      "msgBody": {
           "itemList": {
              "stopFlag": 0,
              "tmY": 37.619556,
              "isFullFlag": 0,
              "lastStnId": 111001109,
              "plainNo": "서울75사2644",
              "sectDist": 524,
              "sectionId": 111700442,
              "posX": 193005.78227499002,
              "posY": 457780.9014937896,
              "sectOrd": 7,
              "dataTm": 20230319131142,
              "routeId": 100100118,
              "vehId": 111033352,
              "congetion": 0,
              "busType": 1,
              "tmX": 126.920766
          }
      }
  }
}

오류 코드

오류코드
오류

0

정상적으로 처리되었습니다

1

시스템 오류가 발생하였습니다

2

잘못된 쿼리 요청입니다. 쿼리 변수가 정확한지 확인하세요.

3

정류소를 찾을 수 없습니다

4

노선을 찾을 수 없습니다.

5

잘못된 위치로 요청을 하였습니다. 위/경도 좌표가 정확한지 확인하세요

6

실시간 정보를 읽을 수 없습니다. 잠시 후 다시 시도하세요

7

경로 검색 결과가 존재하지 않습니다.

8

운행 종료되었습니다.

Was this helpful?