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

캐릭터 인코딩은 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

200: OK 응답 반환 완료

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:회차지아님)

요청 및 응답 예시

URI

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

Response

{
  "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	운행 종료되었습니다.