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’ 생성 시 키를 발급 받을 수 있습니다.

상세기능 번호

4

상세기능 유형

조회

상세기능명

getStaionsByRouteList

상세기능 설명

노선별 경유 정류소 조회 서비스 노선ID에 해당하는 경유 정류소 목록을 조회한다

Call Back URL

https://i48ojxo10p.apigw.ntruss.com/public-busroute/v1/stations-by-route-list

최대 메시지 사이즈

3MB

평균 응답 시간

100 ms

초당 최대 트랜잭션

30 tps

노선 별 경유 정류소 목록 조회 API

GET https://4vh6qtie3c.apigw.ntruss.com/public-busroute/v1/stations-by-route-list

Query Parameters

Name
Type
Description

busRouteId*

string

노선 시스템 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

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

결과 메시지

msgBody

본문 내용

Y

본문 내용

itemList

각 항목 리스트

Y

각 항목 리스트

itemCount

항목 개수

1

Y

0

항목 개수

busRouteAbrv

노선 약칭

128

Y

721

노선명 (안내용 – 마을버스 제외)

busRouteId

노선 ID

9

Y

100100112

노선 ID

busRouteNm

노선명

128

Y

721

노선명 (DB관리용)

seq

순번

10

Y

1

순번

section

구간 ID

9

Y

0

구간 ID

station

정류소 고유 ID

9

Y

112000202

정류소 고유 ID

stationNm

정류소 이름

128

Y

서부운수기점

정류소 이름

gpsX

X좌표 (WGS 84)

32

Y

126.9107578536

X좌표 (WGS 84)

gpsY

Y좌표 (WGS 84)

32

Y

37.5813365733

Y좌표 (WGS 84)

direction

진행방향

128

Y

건대입구역

진행방향

fullSectDist

정류소간 거리

10

Y

0

정류소간 거리

stationNo

정류소 번호

5

Y

13285

정류소 번호

routeType

노선 유형

1

Y

0

노선 유형 (1:공항, 2:마을, 3:간선, 4:지선, 5:순환, 6:광역, 7:인천, 8:경기, 9:폐지, 0:공용)

beginTm

첫차 시간

5

Y

04:20

첫차 시간

lastTm

막차 시간

5

Y

22:40

막차 시간

trnstnid

회차지 정류소ID

9

Y

104000110

회차지 정류소ID

posX

좌표X (GRS80)

32

Y

192118.3026547447

좌표X (GRS80)

posY

좌표Y (GRS80)

32

Y

453540.21388582746

좌표Y (GRS80)

sectSpd

구간속도

10

Y

0

구간속도

arsId

정류소 고유번호

5

Y

13285

정류소 고유번호

transYn

회차지 여부

1

Y

Y

회차지 여부 (Y:회차, N:회차지아님)

요청 및 응답 예시

https://i48ojxo10p.apigw.ntruss.com/public-busroute/v1/stations-by-route-list?busRouteId=100100112

{
  "ServiceResult": {
      "comMsgHeader": "",
      "msgHeader": {
           "headerCd": 0,
           "headerMsg": "정상적으로 처리되었습니다.",
           "itemCount": 0
      },
      "msgBody": {
           "itemList": [
              {
                  "busRouteAbrv": 721,
                  "stationNm": "서부운수기점",
                  "stationNo": 13285,
                  "fullSectDist": 0,
                  "section": 0,
                  "sectSpd": 0,
                  "posX": 192074.09952394388,
                  "arsId": 13285,
                  "posY": 453573.04151196405,
                  "busRouteNm": 721,
                  "trnstnid": 104000110,
                  "lastTm": "22:40",
                  "station": 112000202,
                  "transYn": "N",
                  "beginTm": "04:20",
                  "routeType": 3,
                  "gpsX": 126.910257,
                  "seq": 1,
                  "busRouteId": 100100112,
                  "direction": "건대입구역",
                  "gpsY": 37.581632
              },
              {
                  "busRouteAbrv": 721,
                  "stationNm": "북가좌2동주민센터",
                  "stationNo": 13175,
                  "fullSectDist": 249,
                  "section": 112603658,
                  "sectSpd": 76,
                  "posX": 192180.2836974701,
                  "arsId": 13175,
                  "posY": 453425.08133000834,
                  "busRouteNm": 721,
                  "trnstnid": 104000110,
                  "lastTm": "22:40",
                  "station": 112000092,
                  "transYn": "N",
                  "beginTm": "04:19",
                  "routeType": 3,
                  "gpsX": 126.9114608746,
                  "seq": 2,
                  "busRouteId": 100100112,
                  "direction": "건대입구역",
                  "gpsY": 37.5802996548
              }
          ]
      }
  }
}

오류코드

오류코드
오류

0

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

1

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

2

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

3

정류소를 찾을 수 없습니다

4

노선을 찾을 수 없습니다.

5

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

6

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

7

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

8

운행 종료되었습니다.

Was this helpful?