전남광주통합특별시_소개로 상세경로

특정 소개로(대피경로)를 구성하는 단계별 경유지 좌표 정보를 조회할 수 있도록 제공하는 공공데이터 서비스입니다.소개로 상세경로는 하나의 대피경로를 실제로 지도 위에 그리거나 내비게이션으로 안내하기 위해 필요한 세부 좌표 데이터입니다. 소개로 API(evacuation-route)가 경로의 전체적인 개요(거리, 소요시간, 도착지 등)를 제공한다면, 본 서비스는 해당 경로를 구성하는 각 경유지의 명칭과 위도·경도 좌표를 순서대로 제공합니다. routeId를 기준으로 조회하며, 경유지는 detail_id 오름차순으로 정렬되어 대피 출발 지점부터 도착 지점까지의 순서가 보장됩니다. 이 서비스는 재난 대응 기관 및 관련 시스템에서 다음과 같은 목적으로 활용될 수 있습니다. 첫째, 소개로 API에서 조회한 경로의 routeId를 이용해 해당 경로의 상세 좌표 목록을 요청하면, 지도 위에 실제 대피경로 선을 그려 주민들에게 시각적으로 안내할 수 있습니다. 둘째, 각 경유지의 위도·경도 좌표를 순서대로 연결하면 GIS 시스템이나 지도 앱에서 폴리라인(Polyline) 형태로 대피경로를 렌더링할 수 있어, 현장 대응 인력 및 주민이 실제 이동해야 할 경로를 직관적으로 파악할 수 있습니다. 셋째, 경유지명(stepDesc)을 함께 제공하므로 주요 랜드마크나 교차로 등 경로상의 중요 지점을 텍스트로 안내하는 데 활용할 수 있어, 지도를 보기 어려운 상황에서도 단계별 경로 안내가 가능합니다.

body header item items 결과메시지 결과코드 경도 경로ID 단계설명 상세경로ID 시작 페이지 위도 전체 결과 수 페이지 인덱스 페이지 크기

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

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '경로ID=값' \
  --data-urlencode '시작 페이지=1' \
  --data-urlencode '인증키=값' \
  --data-urlencode '페이지 크기=1'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "경로ID": "값",
  "시작 페이지": "1",
  "인증키": "값",
  "페이지 크기": "1",
});

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": "발급받은_인증키",
    "경로ID": "값",
    "시작 페이지": "1",
    "인증키": "값",
    "페이지 크기": "1",
}

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