개발가이드

  • Open-API 제공 목록
  • 레퍼런스
    • 노선정보조회 서비스
      • 노선기본정보항목조회
      • 노선번호목록조회
      • 노선경로목록조회
      • 노선별경유정류소목록조회
    • 정류소정보조회 서비스
      • 명칭별정류소목록조회
      • 명칭별교통약자전용정류소목록조회
      • 고유번호별정류소항목조회
      • 고유번호별교통약자전용정류소목록조회
      • 정류소별경유노선목록조회
      • 정류소별노선첫차/막차예정시간목록조회
      • 좌표기반근접정류소목록조회
    • 버스위치정보조회 서비스
      • 노선버스위치정보목록조회
      • 노선별특정정류소접근버스위치정보목록조회
      • 특정차량위치정보항목조회
      • 교통약자전용노선버스위치정보목록조회
      • 교통약자전용노선별특정정류소접근버스위치정보목록조회
    • 버스도착정보조회 서비스
      • 경유노선전체정류소별도착예정정보목록조회
      • 정류소노선별도착예정정보목록조회
      • 정류소별교통약자용도착예정정보목록조회
      • 정류소노선별교통약자용도착예정정보목록조회
  • 에러코드
Home 개발가이드 레퍼런스

레퍼런스

지하철 정보조회 서비스 : 지하철 도착정보 조회

지하철 도착정보 조회 서비스를 검색할 경우, 해당 역사에 대한 선택한 호선의 도착정보를 검색할 수 있는 API 입니다. 변수명은 대소문자를 구분하니 주의하시기 바랍니다. (3월 서비스 예정)

요청 URL (Request Url)

http://ws.bus.go.kr/api/rest/subwayInfo
(EX : http://ws.bus.go.kr/api/rest/subwayInfo/getArvlByStatn?subwayId=xxxx&statnId=xxxx)

요청 변수 (Request Parameter)

요청변수
변수명 타입 설명
serviceKey string (필수) 발급받은 키 값
subwayId string (필수) 호선 ID
statnId string (필수) 역사ID

인코딩 방식 (Encoding Type)

UTF-8

Output

XML

출력 결과 필드 (Response Field. Well formed xml)

출력 결과 필드 (Response Field. Well formed xml)
변수명 타입 설명
      subwayId string 지하철호선 ID
      trainLine string 방면번호
      trainLineNm string 방면명
      updnLine string 상/하행 (상행, 하행)
      subwayHeading string 지하철 진행방향 (오른쪽: 상행, 왼쪽: 하행)
      statnSn string 역사순번
      statnId string 지하철역사 ID
      statnNm string 지하철역사 명
      trnsitCo string 환승노선 수
      firstTrainSttus string 첫번째 도착 열차상태
(열차상태: 0:정상, 1:막차, 2:뒷차막차, 3:뒷뒷차막차, 7:첫차,
8:돌발, 9:연착, -1:출발대기, -2:운행종료, -3:시스템점검중,
-8:돌발(차량없음))
      firstArvlMsg string 첫번째 열차 도착 메세지
      firstArvlTm string 첫번째 열차 도착예정 시간 (분)
      firstArvlDt string 첫번째 열차 도착예정 시간 (YYYYMMDDHH24HISS)
      firstStatnId string 첫번재 열차 도착예정 역사ID
      firstStatnNm string 첫번재 열차 도착예정 역사명
      firstTrainLine string 첫번재 열차 도착예정 방면번호
      firstStatnSn string 첫번재 열차 도착예정 역사순번
      firstTrainNo string 첫번재 열차 도착예정 열차번호
      firstDelayTime string 첫번재 열차 도착예정 연착시간
      firstAcdntCn string 첫번재 열차 도착예정 돌발내용
      secondTrainSttus string 두번째 도착 열차상태
(열차상태: 0:정상, 1:막차, 2:뒷차막차, 3:뒷뒷차막차, 7:첫차,
8:돌발, 9:연착, -1:출발대기, -2:운행종료, -3:시스템점검중,
-8:돌발(차량없음))
      secondArvlMsg string 두번재 열차 도착 메세지
      secondArvlTm string 두번째 열차 도착예정 시간 (분)
      secondArvlDt string 두번째 열차 도착예정 시간 (YYYYMMDDHH24MISS)
      secondStatnId string 두번째 열차 도착예정 역사 ID
      secondStatnNm string 두번째 열차 도착예정 역사명
      secondTrainLine string 두번째 열차 도착예정 방면번호
      secondStatnSn string 두번째 열차 도착예정 역사순번
      secondTrainNo string 두번째 도착예정 열차 열차번호
      secondDelayTime string 두번째 도착 예정 차량의 연착시간
      secondAcdntCn string 두번째 도착 예정 차량의 돌발내용
      subwayList string 지하철 리스트