교육부 국사편찬위원회_우리역사넷_역사지리 메타정보

이 공공데이터는 국사편찬위원회의 "우리역사넷"이 제공하는 역사 지리 정보를 집대성한 데이터베이스로, 시간의 흐름에 따라 변화해 온 한국의 행정구역과 지리 정보를 체계적으로 정리한 자료입니다. 이 데이터는 단순히 현재의 지리 정보가 아니라, 과거 특정 시점의 땅의 이름과 경계가 어떠했는지를 과학적으로 구현하여, 역사를 공간(Space)이라는 차원에서 이해할 수 있도록 돕는 핵심 자료입니다. 데이터의 주된 내용은 조선 시대의 지리서인 『세종실록지리지』 등의 문헌 자료부터, 근대 이후의 행정구역 개편 기록까지 광범위하게 포함하고 있습니다. 특히 1914년 일제강점기에 대대적으로 시행된 "조선전도부군면리동이정표"와 같은 중요한 행정구역 변천 기록을 포함하고 있어, 지역의 명칭과 경계가 어떻게 바뀌었는지 정확하게 파악할 수 있습니다. 이 자료는 마치 "역사 속 우리나라의 땅 모양이 담긴 타임머신 지도"와 같아서, 학생들이 특정 역사적 사건이 발생한 장소의 당시 행정구역이나 환경을 시각적으로 이해하는 데 큰 도움을 줍니다. 또한, 향토사 연구자나 지역 문화 콘텐츠 개발자들은 특정 지역의 역사적 뿌리와 변화 과정을 심층적으로 분석하는 데 이 데이터를 활용할 수 있습니다. 이 데이터는 한국사의 중요한 사건들을 지리적 맥락 속에서 입체적으로 학습하고 연구할 수 있는 기반을 제공함으로써, 역사 교육의 질을 높이고 대중의 역사 이해도를 심화시키는 데 기여하는 귀중한 공공자료입니다.

내용 레벨링크 레벨아이디 연결아이디 표제지명 한자표제지명

확인된 엔드포인트 — 공개된 OpenAPI 스펙에서 가져온 실제 호출 주소입니다. 인증키만 바꾸면 그대로 돌아갑니다.

실행은 공공데이터포털에서 — 인증키 발급(활용신청)과 응답 미리보기는 포털의 해당 데이터 지면에서 하실 수 있습니다. 이 지면은 어떤 값을 넣고 무엇이 나오는지를 정리해 보여드립니다.

curl -G 'https://api.odcloud.kr/api/15155540/v1/uddi:fc2017f4-d249-402c-be24-f1d1a0728807' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode 'page=1' \
  --data-urlencode 'perPage=1' \
  --data-urlencode 'returnType=json'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "page": "1",
  "perPage": "1",
  "returnType": "json",
});

const res = await fetch(`https://api.odcloud.kr/api/15155540/v1/uddi:fc2017f4-d249-402c-be24-f1d1a0728807?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

import requests

params = {
    "serviceKey": "발급받은_인증키",
    "page": "1",
    "perPage": "1",
    "returnType": "json",
}

r = requests.get("https://api.odcloud.kr/api/15155540/v1/uddi:fc2017f4-d249-402c-be24-f1d1a0728807", params=params, timeout=15)
r.raise_for_status()
print(r.json())