국토지리정보원 오픈API 활용법! 내 웹사이트에 지도 삽입하는 방법

[제목] 국토지리정보원 오픈API 활용법! 내 웹사이트에 지도 삽입하는 방법 [메타 설명] NGII(국토지리정보원) 오픈API를 활용해 내 웹사이트에 지도 삽입하는 방법을 단계별로 소개합니다. API 신청, 키 발급, 지도 호출 코드 예제까지 자세히 확인하세요. ---

국토지리정보원 오픈API란?

국토지리정보원(NGII, National Geographic Information Institute)은 국가의 공간정보를 관리하는 중앙기관입니다. NGII는 누구나 지도와 공간정보를 활용할 수 있도록 다양한 오픈API 서비스를 무료로 제공합니다. 이 API를 이용하면 웹사이트나 앱에서 직접 고품질 지도를 불러오고, 위치 기반 기능을 쉽게 구현할 수 있습니다.

오픈API 활용 시 기대할 수 있는 기능

정사영상 지도 삽입
좌표 변환 (TM ↔ WGS84)
국가지점번호 조회
도엽 및 고도 정보 검색
지도 타일 서비스 이용

API 활용을 위한 사전 준비

NGII 홈페이지 회원가입 및 로그인
API 이용 신청 및 인증키 발급
인증키를 활용한 개발 연동

1단계: 회원가입 및 로그인

국토지리정보원 오픈API는 NGII 공식 홈페이지에서 제공됩니다. 회원가입은 개인이나 기업 모두 가능하며, 로그인 후 API 신청이 가능합니다.

2단계: API 이용 신청

"공간정보 오픈API 이용" 메뉴에서 원하는 서비스를 선택하고, 사용 목적을 간단히 입력하면 인증키가 발급됩니다. 이 키는 이후 모든 API 요청에 필수로 포함됩니다.

지도 삽입을 위한 기본 예제

웹사이트에 지도를 삽입하려면 OpenLayers, Leaflet.js 등의 오픈소스 라이브러리를 활용하면 편리합니다. 아래는 Leaflet을 사용하여 국토지리정보원의 지도 타일을 불러오는 예제입니다.

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>NGII 지도 예제</title>
  <link rel="stylesheet" href="https://unpkg.com/leaflet@1.9.3/dist/leaflet.css"/>
  <script src="https://unpkg.com/leaflet@1.9.3/dist/leaflet.js"></script>
  <style>#map { height: 600px; }</style>
</head>
<body>
  <div id="map"></div>

  <script>
    var map = L.map('map').setView([37.5665, 126.9780], 12);

    L.tileLayer('https://api.vworld.kr/req/wmts/1.0.0/Base/default/{z}/{y}/{x}.png?key=YOUR_API_KEY', {
      maxZoom: 19,
      attribution: 'NGII 제공 지도'
    }).addTo(map);

    L.marker([37.5665, 126.9780]).addTo(map)
      .bindPopup('서울 시청')
      .openPopup();
  </script>
</body>
</html>

주의: 위 코드의 YOUR_API_KEY 부분에 실제 발급받은 키를 입력해야 정상 동작합니다.

좌표 변환 API 활용 예시

웹 기반 지도 서비스는 보통 WGS84 좌표계를 사용하지만, 국토지리정보원은 TM좌표계 기반 자료도 제공하므로 변환이 필요할 수 있습니다.

예시 API 호출 (TM → WGS84 변환)

GET https://www.ngii.go.kr/kor/api/tmToWgs.do?x=960000.0&y=1945000.0&key=YOUR_API_KEY

응답 결과:

{ "x":126.9784, "y":37.5666 }

이렇게 변환된 위도, 경도를 Leaflet 또는 OpenLayers에 적용하여 마커를 정확한 위치에 표시할 수 있습니다.

활용 예시 및 사례

공공기관 위치안내 웹사이트 구축
관광지도 제작 및 위치기반 콘텐츠 연동
드론 경로 시각화 및 고도정보 분석
부동산 위치 정보 시스템

주의사항 및 라이선스 정보

API는 공공, 연구, 교육 등 비영리 목적 사용 시 무료입니다.
상업적 사용 시 사전 협의가 필요할 수 있습니다.
출처는 반드시 표기해야 하며, 국토지리정보원에서 제공한 자료임을 명시해야 합니다.

맺음말

국토지리정보원 오픈API는 고정밀 지도 데이터를 누구나 활용할 수 있도록 개방하고 있습니다. 웹사이트나 모바일 앱에 직접 연동하면 정확하고 공신력 있는 위치 기반 서비스를 구현할 수 있습니다.

복잡할 것 같지만, 몇 줄의 코드로 충분히 시작할 수 있습니다. 오늘부터 직접 지도를 불러오고, 사용자에게 더 나은 위치 서비스를 제공해보세요.

저작자표시 비영리 변경금지 (새창열림)

라이프와 건강 정보