작성 날짜 : 2025.07.30
작성자 : 황송희 / 검수자 : 품질에서 작성
GeoMap 컴포넌트의 권역별 데이터 조회 방식과 이에 따른 수정 시 처리 방법에 대한 안내 가이드입니다.
권역별 데이터 표시 기능
권역별 데이터 표시 기능
GeoMap 컴포넌트는 배경 지도 위에 혹은 배경 지도 없이 권역별 지리 데이터를 다양하게 표시할 수 있습니다.
예시:
1) 기본 지도
2) 세계 지도
3) Drill To Detail 샘플
- 기능 사용 방법: [i-AUD] GeoMap 컴포넌트 (지도, 맵) 사용 가이드
- rnd 사이트 에서 "지도"로 검색하시면 이 외에도 다양한 샘플을 확인하실 수 있습니다.
참조 테이블
참조 테이블
GeoMap 컴포넌트는 제품의 레파지토리 테이블을 참조하여 권역별 지리 데이터를 표시합니다.
테이블 목록
필요 테이블 목록
테이블 명 테이블 설명 Row 개수 MAP_GEO_0 국가별 0레벨 전 세계 국가 데이터 263 MAP_GEO_1 국가별 1레벨 구역 데이터(시도) 17 MAP_GEO_2 국가별 2레벨 구역 데이터(시군구) 264 MAP_GEO_3 국가별 3레벨 구역 데이터(읍면동) 5,066 MAP_GEO_4 국가별 3레벨 구역 데이터(리) 15,161 MAP_GEO_DOMESTIC_CODE 대한민국 지리정보체계 코드 데이터(행정동 및 법정동) 21,676 MAP_GEO_COUNTRY_CODE 전 세계 지리정보체계 코드 데이터(ISO Alpha3, ISO Alpha2, ISO Numeric) 263 MAP_GEO_LANGUAGE 지역명 다국어 데이터 20,771
- 데이터 출처
- 세계 지리 데이터: GADM v4.1. (2022년도 7월)
- 국내 지리 데이터: 주소기반산업지원서비스 도로명주소 DB의 행정구역도 기반 (2025년도 1월)
- 국내 지리 코드표: 행정안전부>업무안내>주민등록,인감 최신일자(등록일 2024.12.23) 게시판
- 세계 지리 코드표: 공공데이터 포털 > 외교부_국가표준코드 (수정일 2024-07-17)
- 권역별 지리 데이터 표시 기능을 사용하기 위해서는 테이블과 그 하위 데이터 모두가 필요합니다.
- 데이터 적재 방법: GeoMap 컴포넌트 어드민 사용 가이드
캐시 파일
캐시 파일
권역별 지리 데이터를 조회하는 경우, 대용량 데이터 처리를 고려하여 실행되는 쿼리문을 기준으로 개별로 캐시파일을 생성합니다. 동일한 쿼리문이 재실행될 경우, 데이터를 조회하지 않고 해당 캐시파일을 참조하여 지리 데이터를 컴포넌트 view에 표시합니다.
캐시 파일 생성 경로: REPORT_PATH/GEO_JSON 하위
해당 경로의 폴더가 없거나 하위에 파일이 없는 경우
하위 버전을 사용하는 경우 혹은 제품을 커스텀한 경우 생성 경로가 다를 수 있습니다.
[GeoMap] Source 보고서 내의 Server Script > MAP_SERVICE 스크립트 내에 해당 로직이 구현되어 있습니다. 아래를 참고하시면 생성 경로를 확인하실 수 있습니다.
따라서 데이터가 수정되었더라도, 실행되는 쿼리문이 동일한 경우 GeoMap 컴포넌트는 해당 캐시파일을 참조하고 있기 때문에 이전 권역별 지리 데이터가 계속 표시됩니다. 캐시 파일 삭제 후 동작을 재확인해주시길 바랍니다.
- 캐시 파일 삭제 방법: GeoMap 컴포넌트 어드민 사용 가이드 혹은 수동으로 서버에서 삭제
기타 FAQ
기타 FAQ
시군구 레벨에서 특정 시가 구 레벨과 같이 표시됩니다. ex) 포항시와 포항시 하위의 구를 나누고 싶습니다.
임의의 지역을 표시하고 싶지 않습니다. ex) 경북, 인천지역의 섬을 제외하고 싶습니다.
데이터를 수정했는데도 이전의 데이터가 계속 표시됩니다.