- 결과 유형
- default:XML)
- 도착역명
- 외 6개
- 권종별 거리에 따른 운임
- 기준일자
- 기후동행카드승차여부
- 외 18개
설명
서울교통공사 실시간운임정보 API는 서울지하철을 이용하는 시민들에게 보다 정확하고 신속한 요금 정보를 제공하기 위해 구축된 공공 데이터 서비스입니다. 이 API는 사용자가 입력한 출발역과 도착역 정보를 기준으로, 해당 노선의 이동 거리 및 환승 여부 등을 종합적으로 분석하여, 기준일자에 따라 산정된 실시간 운임 정보를 제공합니다.주요 제공 항목에는 일반, 청소년, 어린이 등 연령별 승객 구분에 따른 카드 및 현금 요금, 이동 거리 기반의 거리운임, 그리고 ‘기후동행카드’ 이용 여부에 따른 승하차 정보 등이 포함되어 있습니다. 이를 통해 이용자는 보다 세분화된 요금 정보를 확인할 수 있으며, 다양한 상황에서 정확한 요금 계산이 가능합니다.해당 API는 실시간 열차 운임 계산 서비스, 대중교통 요금 안내 웹사이트 및 앱, 교통비 예측 시스템 등 다양한 서비스와 연계하여 활용될 수 있으며, 민간 서비스 개발자 및 공공기관에서도 적극적으로 응용이 가능합니다. 실시간운임정보는 Rest API 방식으로 제공되며, 데이터는 수시로 갱신되며 하루 단위로 정기 갱신되어 항상 최신 정보를 유지합니다.이와 같은 실시간 데이터 제공을 통해 서울교통공사는 시민의 교통 편의성을 높이는 것은 물론, 교통 데이터 기반의 혁신 서비스 창출을 지원하고 있습니다.
요청변수 13개
출력결과 27개
호출해 보기
주소는 예시입니다 — 이 API의 실제 호출 주소는 공공데이터포털이 로그인 뒤에만 공개해서 자동으로 가져올 수 없습니다. 파라미터 이름은 확실하니, 주소만 원문 활용가이드에서 확인해 채우십시오.
curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
--data-urlencode 'serviceKey=발급받은_인증키' \
--data-urlencode '결과 유형 (JSON/XML=값' \
--data-urlencode 'default:XML)=값' \
--data-urlencode '공공데이터포털에서 받은 인증키=값' \
--data-urlencode '도착역명(검색기준: 포함)=값' \
--data-urlencode '도착역코드(검색기준: 일치)=11110' \
--data-urlencode '응답으로 받고 싶은 컬럼 명을 선택하여 검색(구분자'=값'
const params = new URLSearchParams({
"serviceKey": "발급받은_인증키",
"결과 유형 (JSON/XML": "값",
"default:XML)": "값",
"공공데이터포털에서 받은 인증키": "값",
"도착역명(검색기준: 포함)": "값",
"도착역코드(검색기준: 일치)": "11110",
"응답으로 받고 싶은 컬럼 명을 선택하여 검색(구분자'": "값",
});
const res = await fetch(`https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);
import requests
params = {
"serviceKey": "발급받은_인증키",
"결과 유형 (JSON/XML": "값",
"default:XML)": "값",
"공공데이터포털에서 받은 인증키": "값",
"도착역명(검색기준: 포함)": "값",
"도착역코드(검색기준: 일치)": "11110",
"응답으로 받고 싶은 컬럼 명을 선택하여 검색(구분자'": "값",
}
r = requests.get("https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}", params=params, timeout=15)
r.raise_for_status()
print(r.json())
같은 값을 넣을 수 있는 API
이 API 에 넣는 값을 그대로 쓸 수 있습니다
-
서울교통공사 편의시설위치정보는 서울지하철 역사 내 주요 편의시설의 위치를 조회할 수 있는 API입니다. 엘리베이터, 에스컬레이터, 화장실, 수유실, ATM, 무인민원발급기 등 총 15종의 시설 위치를 유형별로 제공하며, 각 시설의 설치 위치, 운영 여부, 상세 설명 등의 항목을 포함합니다. 해당 정보는 역사 내 편의시설 접근성 향상, 안내 시스템 연계 등에 활용될 수 있으며, 수시로 갱신되는
-
서울교통공사 지하철 알림정보 API는 서울지하철 운행 중 발생하는 열차 지연과 각종 사고 및 역주변 시위 등 혼잡으로 인한 무정차 안내는 물론 열차 시간표 변경 등 다양한 이례 상황에 대한 공지사항 메시지를 제공하는 API입니다. 또타 앱서비스를 통해 안내되는 공지사항 컨텐츠 데이터를 기반으로 알림 제목, 알림 내용, 알림구분코드, 이례 상황 시작 일시, 종료 일시 등의 정보를 개방하며, 수
-
서울교통공사 교통약자이용정보 API는 서울지하철 역사 내 교통약자를 위한 주요 편의시설 및 지원 현황을 제공하는 API입니다. 엘리베이터, 장애인화장실, 휠체어리프트, 수어영상전화기, 휠체어급속충전기 등 총 9종의 정보에 대해 위치, 운영 여부, 설치 현황 등의 항목을 포함하며, 수시로 갱신되는 데이터를 Rest API 방식으로 제공합니다. 해당 정보는 교통약자의 이동 편의 향상 및 역사 내
-
서울교통공사 역사 내 공사현황 API는 서울지하철 역사 내에서 시행되는 공사 현황 정보를 제공하는 API입니다. 공사 코드, 공사 구분코드, 공사명 및 공사(작업)의 내용, 위치, 착공일과 준공일 등의 항목을 포함합니다. 공사 구분코드와 특정 일자 기준의 공사 일정 조회 검색조건을 제공합니다. 공사로 인한 시설 이용 제한 안내, 승강기 공지, 안전 모니터링 시스템 등에 연계해 활용될 수 있습
-
서울교통공사 문화관람체험정보 API는 서울교통공사에서 운영하는 시민 문화·체험 프로그램에 대한 정보를 제공하는 API입니다. 시민초청문화이벤트, 지하철 예술마당, 차량사업소 견학, 안전체험관 체험에 대한 명칭, 운영 일자, 시간, 장소, 접수 여부 등의 항목을 포함하며, 수시로 갱신되는 정보를 Rest API 방식으로 제공합니다. 신청 가능 일정 확인 또는 체험 프로그램 조회 등에 활용될 수
-
서울교통공사 역별승하차인원 API는 서울지하철의 각 역사별 승차 및 하차 인원 현황을 조회할 수 있는 API입니다. 이용일 기준으로 역별 유동 인구 데이터를 수집하며, 통행일자, 통행시간, 역명, 역코드, 역번호, 승하차 인원, 교통카드구분코드, 교통카드 사용자 구분코드 등의 항목이 포함되며, 수시로 갱신되는 정보를 Rest API 방식으로 제공합니다. 대중교통의 혼잡도를 예측하거나, 시간대