QGIS 실전 플러그인 개발

GIS

QGIS 실전 플러그인 개발 - (1) Vworld 검색 API 인증키 발급

유병혁 2024. 12. 8. 09:23

안녕하세요? 이번 글은 "QGIS 실전 플러그인 개발" 시리즈의 첫 번째로, "Vworld 검색 API 인증키 발급"에 대해 다룹니다. 학습에 앞서, QGIS 플러그인의 표준 구조를 이해할 수 있는 "첫 번째 QGIS 플러그인 만들기" 시리즈를 먼저 읽어보시길 추천드립니다.

"첫 번째 QGIS 플러그인 만들기" 시리즈 글 소개

안녕하세요? "첫 번째 QGIS 플러그인 만들기" 시리즈 글을 작성했습니다. 이 시리즈는 Spatial Thoughts의 우자발 간디(Ujaval Gandhi) 님의 "Building Your First QGIS Plugin (Full Workshop)" 내용을 재정리

foss4g.tistory.com

지금부터 QGIS 플러그인을 개발해 보겠습니다. 이번 플러그인은 Vworld 검색 API를 사용해 검색어에 해당하는 좌표와 속성을 반환하고, 이를 QGIS 레이어로 추가하는 기능을 제공합니다.

예를 들어, "국립공원"을 검색하면 현재 QGIS 맵 캔버스의 범위(BBox) 내에서 국립공원과 연관된 지점의 좌표와 속성을 임시 레이어로 생성하고, 이를 QGIS에 자동으로 추가합니다.

지도 제작에 유용한 플러그인이 될 텐데요, 첫 단계로 Vworld 검색 API 사용을 위한 인증키 발급부터 차근차근 살펴보겠습니다.

Vworld 검색 API 인증키 발급

먼저 Vworld에 접속합니다. Vworld는 다양한 국가공간정보를 누구나 쉽게 조회·활용할 수 있는 2D·3D 지도서비스를 제공합니다.

브이월드

국가가 보유하고 있는 공개 가능한 공간정보를 모든 국민이 자유롭게 활용할 수 있도록 다양한 방법을 제공합니다.

www.vworld.kr

상단 메뉴에서 "오픈 API > 인증키 발급"을 클릭합니다.

"이용약관에 동의합니다"를 클릭합니다.

인증키 발급을 위한 서비스명, 서비스분류 등 다양한 정보가 필요합니다. 여기서는 다음과 같이 입력해 보겠습니다. 서비스명은 "GeoQuery for QGIS"라고 정의했습니다.

서비스명: GeoQuery for QGIS
서비스분류: 교육
서비스유형: 기타(QGIS, ArcGIS 등)
서비스설명:
- 개요: Vworld 검색 API를 이용해 장소와 주소에 해당하는 x, y 좌표를 반환하고, 이를 QGIS에 레이어로 추가하는 서비스입니다.
- 서비스 대상: QGIS 사용자
- 목적: 검색어 입력으로 실시간 좌표를 얻고 QGIS에 자동 추가하여 지도 제작 효율성 향상
활용API: 검색 API
사용기관: 공공 국립공원공단
활용사례공개: 공개동의

정보를 입력한 후 "발급" 버튼을 클릭합니다.

6개월 후 만료되는 일일 제한이 없는 개발 키가 즉시 발급됩니다. 각자 해당 웹사이트에서 반드시 인증키를 발급받으시기 바랍니다.

3A99F800-2E60-3397-9F0E-2746BC4169F6

Vworld 검색 API 2.0 레퍼런스

인증키를 발급받았으니, 이제 Vworld 검색 API 2.0 레퍼런스 문서를 학습해 보겠습니다. 이 API는 검색엔진 기반의 주소(구 주소, 도로명주소) 검색과 국가 관심 지점(명칭/장소) 검색 기능을 제공합니다. 이번에는 "장소(PLACE) 검색" 기능을 활용하여 개발을 진행해 보겠습니다.

브이월드

국가가 보유하고 있는 공개 가능한 공간정보를 모든 국민이 자유롭게 활용할 수 있도록 다양한 방법을 제공합니다.

www.vworld.kr