서울교통공사_최단경로이동정보

서울교통공사 최단경로이동정보 API는 지하철 출발역과 도착역을 입력하면 최단 경로를 산출해주는 API입니다. 최소 시간, 최단 거리, 최소 환승 3가지 유형의 최단 경로를 탐색하며, 각 구간별 정차역, 역간 이동시간 및 이동 거리, 환승 여부 등의 정보를 제공합니다. 특정 경유역목록 또는 환승제외역목록 검색조건도 제공합니다. 검색조건 시의 날짜 및 시간은 경로를 계산할 기준일시를 의미하며, 이는 적합한 열차시간표를 제공하는데 사용되므로, 기준일시에 따라 다른 시간표가 적용될 수 있습니다. 최단경로에 사용되는 데이터는 수시로 갱신됩니다. '역값구분' 파라미터를 통해 역 정보 파라미터를 역명 또는 역코드로 조회할 수 있습니다.

body header 검색유형 결과메세지 결과코드 경유역 배열 급행여부 단위: 미터 (m) 단위: 원 단위: 초 (s) 대기시간 도착 호선명 도착역 관련 정보 무정차여부 상행/하행/내선/외선 구분 소요시간 역구간거리 역명 열차도착시각 열차시간표포함여부 열차출발시각 제외 환승역 배열 종착역명 종착역코드 지선명 최단경로 역명 배열 출발 호선명 출발역 관련 정보 출발역 기준 열차번호 해당 지하철 역명 해당 지하철 역번호 해당 지하철 역코드 호선명 환승여부 환승역 배열 환승횟수

주소는 예시입니다 — 이 API의 실제 호출 주소는 공공데이터포털이 로그인 뒤에만 공개해서 자동으로 가져올 수 없습니다. 파라미터 이름은 확실하니, 주소만 원문 활용가이드에서 확인해 채우십시오.

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '검색유형 duration(최소시간=값' \
  --data-urlencode 'default)=값' \
  --data-urlencode 'distance(최단거리)=값' \
  --data-urlencode 'transfer(최소환승)=값' \
  --data-urlencode '검색일시 (yyyy-MM-dd hh:mm:ss)=값' \
  --data-urlencode '결과 유형 (JSON/XML=값'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "검색유형 duration(최소시간": "값",
  "default)": "값",
  "distance(최단거리)": "값",
  "transfer(최소환승)": "값",
  "검색일시 (yyyy-MM-dd hh:mm:ss)": "값",
  "결과 유형 (JSON/XML": "값",
});

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": "발급받은_인증키",
    "검색유형 duration(최소시간": "값",
    "default)": "값",
    "distance(최단거리)": "값",
    "transfer(최소환승)": "값",
    "검색일시 (yyyy-MM-dd hh:mm:ss)": "값",
    "결과 유형 (JSON/XML": "값",
}

r = requests.get("https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}", params=params, timeout=15)
r.raise_for_status()
print(r.json())