페이지 트리

버전 비교

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.


...


Section


Column
width80%
작성 날짜 : 2025.07.30


Column
width20%

작성자 :  황송희  / 검수자 :  이승우



GeoMap 컴포넌트의 권역별 데이터 조회

...

방식 안내 및 사용 가이드입니다.toc

패널

...

borderColor

...

panel
#f7f7f7
borderStylesolid
title📌 목차


패널
borderColor#303031
borderWidth0
borderStylesolid
title권역별 데이터 표시 기능

GeoMap 컴포넌트는 배경 지도

위에 혹은

위 또는 배경 지도 없이, 권역별 지리 데이터를

다양하게 표시할

다양한 방식으로 시각화할 수 있습니다.

예시:

책갈피
권역별 데이터 표시 기능
권역별 데이터 표시 기능

🗺️예시

1) 기본 지도

URL: https://rnd.bimatrix.co.kr/aud7/extention/portal/SimpleSSO_Con.jsp?reportCode=REPD8B00FD132AD4E9288E0957F7497185B

Image Modified

2) 세계 지도

URL: https://rnd.bimatrix.co.kr/aud7/extention/portal/SimpleSSO_Con.jsp?reportCode=REP05B9036D8BD048DFBE65C3D32CBA8AEC

Image Modified

3) Drill To Detail 샘플

Image Removed

기능 사용 방법은 가이드에 안내되어 있습니다.

패널

URL: https://rnd.bimatrix.co.kr/aud7/extention/portal/SimpleSSO_Con.jsp?reportCode=REP07FF9E92977D4DCF88E3B8936B5E01CE

Image Added


발췌


패널
borderWidth0
title참조 테이블

참조 테이블

GeoMap 컴포넌트는

권역별 지리 데이터 표시 기능을 제공하기 위해 레파지토리의 아래 테이블을 참조합니다.
  • 대용량의 데이터가 필요하기 때문에, 권역별 지리 데이터 표시 기능을 사용하기 위해서는 우선 데이터를 적재하셔야 합니다. 신규 설치라 하더라도 테이블은 존재하나 데이터는 존재하지 않습니다.
  • 아래 테이블에 데이터를 적재하는 방법은 가이드를 참고 바랍니다. 가이드: 
  • 정보

    제품의 레파지토리 테이블을 참조하여 권역별 지리 데이터를 시각화합니다.
    책갈피
    참조 테이블
    참조 테이블

    도움말
    title테이블 목록
    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


    등록일 2024
    • 권역별 지리 데이터 표시 기능을 사용하기 위해서는 지리 정보가 포함된 참조 테이블과 그 하위 데이터가 모두 필요합니다.
    • 데이터 적재 방법: GeoMap 컴포넌트 어드민 사용 가이드



    패널
    borderWidth0
    title캐시 파일

    캐시 파일

    권역별 지리 데이터를

    조회하는

    조회할 경우,

     

    대용량 데이터 처리를 고려하여 실행되는 쿼리문을 기준으로

    개별로 캐시파일을 생성합니다. 동일한

    개별 캐시 파일이 생성됩니다. 동일한 쿼리문이 재실행될 경우, 데이터를

    조회하지 않고 해당 캐시파일을 참조하여 지도

    재조회하지 않고 생성된 캐시 파일을 참조하여 지리 데이터를 컴포넌트

    view에

    View에 표시합니다.캐시파일이 생성되는 경로는 REPORT_PATH\

    책갈피
    캐시 파일
    캐시 파일

    📁 캐시 파일 생성 경로: REPORT_PATH/GEO_JSON 폴더 하위입니다. 하위

    tip

    Image Added


    경고
    title해당 경로의 폴더가 없거나 하위에 파일이 없는 경우

    사용하고 있는 UserComponent 보고서의 ServerScript 해당 경로에 해당 폴더가 없거나, 하위에 캐시 파일이 존재하지 않는 경우는 다음과 같은 사유일 수 있습니다.

    • 제품 하위 버전을 사용하는 경우
    • 제품을 커스텀하여 캐시 파일 생성 경로를 변경한 경우

    [GeoMap] Source 보고서 내의 Server Script > MAP_SERVICE 스크립트를 확인하시면 스크립트 내에 해당 로직이 구현되어 있습니다. 아래를 참고하시면 생성 경로를 확인하실 수 있습니다.

    하위 버전 혹은 커스텀되어 있는 경우 경로가 다를 수 있습니다.Image Added

    따라서 데이터가 수정되었다 하더라도, 수정되었더라도 실행되는 쿼리문이 동일한 경우 수정된 데이터가 표시되지 않고 해당 캐시파일을 바라보기 때문에 캐시파일을 삭제해 주셔야합니다.삭제 방법: admin 가이드의 삭제 버튼 활용 혹은 수동으로 서버에서 , 변경 사항이 반영되지 않고 이전 데이터가 계속 표시될 수 있습니다. 캐시 파일 삭제 후 동작을 재확인해주시길 바랍니다.


    패널
    borderWidth0
    title기타 FAQ

    책갈피
    기타 FAQ

    성남시와 구가

    기타 FAQ

    1. 시군구 레벨에서 특정 시가 구 레벨과 같이 표시됩니다.
    2. 임의의 지역을 표시하고 싶지 않습니다.
    3. ex) 포항시와 포항시 하위의 구를 나누고 싶습니다.
      펼치기
      title답변

      시군구 레벨(MAP_GEO_2) 에서 시와 구 레벨이 구분되지 않는 문제의 원인은 아래와 같습니다.

      현재 GeoMap 에서 사용 중인 행정구역 코드 체계는 통계청의 행정구역 코드를 기준으로 하고 있으며, 이를 MAP_GEO_DOMESTIC_CODE 테이블에서 확인할 수 있습니다.

      해당 데이터는 MAP_GEO_2 테이블에서 확인할 수 있습니다.

      Image Added

       

      예를 들어 포항시의 경우에 (포항시 / 포항시 남구 / 포항시 북구) 라는 세 개의 행정구역이 모두 같은 레벨에 포함되어 있어 중첩 표시되는 현상이 발생하고 있습니다.

      이 문제를 해결하려면, 어떤 특정 구역(예를 들어 포항시만 표시하겠다) 만 표시하고 싶다면 포항시 남구와 포항시 북구 데이터를 제외하도록 쿼리를 수정하시면 됩니다. 

      포항 지역을 예시로 들었지만, 동일한 현상이 발생하는 다른 지역에도 동일하게 적용됩니다.

       

      ⁕ 시와 구 데이터를 동시에 제공하는 이유

      시와 구 데이터를 동시에 제공하는 이유는, 사용자가 상황에 맞게 유연하게 사용할 수 있도록 하기 위함입니다.

      예를 들어, 포항시 전체 데이터를 보고 싶을 때는 각 구 데이터를 선택적으로 포함할 수 있습니다.

      이를 이용하여 다양한 상황에 맞게 데이터를 활용할 수 있습니다.


    4. 데이터를 수정했는데도 이전의 데이터가 계속 표시됩니다.
      펼치기
      title답변

      #캐시파일 안내 설명을 확인 부탁드립니다.