---
sourceDocument: Xanadu 플랫폼 분석
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/now-intelligence

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu 플랫폼 분석

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# 지리적 맵 데이터 시각화를 위한 맵 소스

# 지리적 맵 데이터 시각화를 위한 맵 소스 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 5분

지리적 맵 데이터 시각화는 특수 맵 소스의 위치 테이블에 연결됩니다.

지오맵의 맵 소스는 맵 소스 계층으로 구성됩니다. 같은 테이블을 참조하는 모든 맵 소스가 같은 계층 구조에 있습니다. 맵 소스 계층 구조는 상위 소스와 최대 4개의 하위 소스 수준으로 구성됩니다. 상위 소스는 테이블의 테이블과 하위 소스 참조 필드만 참조합니다.

기본 설정에 따라 인스턴스에는 위치 \[cmn_location\] 테이블을 참조하는 지오맵의 맵 소스 계층 구조가 있습니다. 따라서 위치의 필드를 참조하는 Geomap에 Group by 필드를 포함할 수 있습니다. 그룹화 기준 필드는 데이터 소스 테이블의 최상위 수준에 있을 수도 있고 닷워킹을 수행할 수도 있습니다. 사용자 지정 위치 테이블을 참조하는 추가 맵 소스 계층을 생성할 수 있습니다.

## 데이터 시각화와 보고서에 대한 맵 소스의 차이점 {#geomap-map-source__section_znr_nhg_cyb}

의 코어 UI맵 보고서에 익숙하다면 지오맵의 맵 소스가 맵 보고서의 맵 소스와 다르다는 것을 눈치채셨을 것입니다. 그들은 다른지도 소스, 테이블, sys_report_map_source 및 viz_map_source에있을 수있을만큼 충분히 다릅니다. 가장 큰 차이점은 테이블을 참조하는 방식입니다.  
맵 보고서에서 맵 소스는 인시던트 \[incident\]와 같은 팩트 테이블을 참조합니다. 맵 소스에는 위치 테이블을 가리키는 참조 필드도 포함되어 있습니다. 하위 맵 소스 위치 테이블의 필드로 닷워킹합니다. 이 구조로 인해 맵의 데이터 소스로 사용하려는 모든 데이터 테이블에 대해 별도의 맵 소스 계층이 생성됩니다.그림 1. 맵 보고서에 대한 맵 소스   

지오맵의 맵 소스는 위치 테이블을 직접 가리킵니다. 팩트 테이블을 참조하지 않습니다. 팩트 테이블은 지리적 맵 데이터 시각화에만 지정됩니다. 이 구조 덕분에 표시되는 데이터에 관계없이 인스턴스의 모든 지오맵에 대해 하나의 맵 계층 구조를 재사용할 수 있습니다.그림 2. 지리적 맵 데이터 시각화를 위한 맵 소스

## 데이터 시각화 맵 소스 생성 {#ariaid-title2}

지오맵 데이터 시각화에서 사용자 지정 위치 테이블을 사용하려면 테이블로 연결되는 맵 소스를 정의합니다. 다양한 계층 수준에 더 많은 맵 소스를 추가합니다.

### 시작하기 전에

필요한 역할: report_admin, viz_admin, pa_admin

### 이 태스크 정보

### 프로시저

1. 브라우저 URL 필드에서 인스턴스 URL에 viz_map_source_list.do 를 추가합니다.  
   예를 들어 인스턴스가 https://instance.example.com 경우 https://instance.example.com/viz_map_source_list.do 를 입력합니다.
2. 참조하려는 위치 테이블이 맵 소스에서 이미 사용되고 있는지 확인합니다.  
   같은 테이블을 참조하는 맵 소스의 집합을 맵 소스 계층 구조라고 합니다.
3. 원하는 위치 테이블을 참조하는 맵 소스가 없는 경우, 해당 테이블에 대한 최상위 맵 소스를 생성합니다.
   1. 새로 만들기를 선택합니다.  
      빈 맵 소스 \[viz_map_source\] 기록이 열립니다.
   2. 다음 정보를 지정합니다.  
      {#customize-geomap-source__table_in1_1jf_cyb__entry__2}

      | 필드 | 설명 |
      |-|-|
      | 이름 | 맵 소스의 이름을 추가합니다. 테이블 내용을 암시하는 설명적인 이름을 사용합니다. 이 이름을 이 계층에서 작성하는 다른 모든 맵 소스의 이름의 일부로 포함합니다. |
      | 테이블 | 데이터 시각화 맵 소스에서 아직 사용되지 않는 위치 테이블을 선택합니다. 또한 선택한 테이블은 데이터 시각화 맵 소스에서 이미 사용 중인 테이블(예: cmn_location)을 참조해서는 안 됩니다. |
      [ ]

      {#customize-geomap-source__table_in1_1jf_cyb}
   3. 제출을 선택합니다.

   {#customize-geomap-source__substeps_bjp_t3f_cyb}  
   이제 새 맵 소스 계층 구조의 상위 맵 소스가 있습니다. 계층 구조에 더 많은 수준을 추가할 수 있습니다.
4. 테이블에 대한 맵 소스 계층이 있는 경우 만들려는 맵 소스보다 한 수준 높은 맵 소스를 엽니다.  
   주:  
   최상위 수준 아래에는 맵 소스 수준이 4개 이하여야 합니다.
5. 맵 소스 관련 목록에서 새로 만들기를 선택합니다.  
   새 맵 소스 \[viz_map_source\] 기록이 열리고 테이블 및 상위 필드가 읽기 전용입니다.
6. 다음 정보를 지정합니다.  
   {#customize-geomap-source__table_bnf_gxf_cyb__entry__2}

   | 필드 | 설명 |
   |-|-|
   | 이름 | 맵 소스의 이름을 입력합니다. 맵 소스 수준의 이름에 수준을 포함합니다. 일반적으로 동일한 계층 구조의 모든 맵 소스에 동일한 루트 이름을 지정합니다. 위치 매핑(수준 2) 및 위치 매핑(수준 3)과 같은 수준으로만 구분하십시오. |
   | 테이블(읽기 전용) | 동일한 테이블이 맵 소스 계층 전체에서 사용되며 최상위 맵 소스에 지정됩니다. |
   | 필드 | 표시 중인 맵보다 한 수준 더 세분화된 위치 데이터 필드를 선택합니다. 예를 들어 월드 맵에 표시되는 수준 1 맵 소스에 대한 데이터를 구성한다고 가정해 보겠습니다. 국가에 대한 데이터가 세계 지도에 표시되기 때문에 위치 국가를 선택합니다. 마찬가지로 독일 또는 미국 지도에 표시할 데이터를 구성하는 경우 위치 시/도를 선택합니다. 주: 도시는 맵 보고서로 드릴다운할 때 표시할 수 있는 가장 세분화된 위치 수준입니다. 예: 도시 내의 다양한 사이트 위치에 대해 보고하고 location.name 포함하도록 최하위 맵 소스 필드를 정의하려는 경우 맵 보고서는 여러 위치를 해당 도시 레이블로 표시합니다. 따라서 location.city 값이 동일한 여러 위치에 대해 보고하면 라벨은 같지만 집계 값이 다른 여러 맵 점이 표시되며 서로 다른 위치로 드릴다운됩니다. |
   | 수준 | 이 맵 소스의 계층 구조 수준을 선택하십시오. 상위 맵 소스의 수준보다 한 수준 낮은 수준을 선택해야 합니다. 최대 4개의 레벨을 가질 수 있습니다. 각 맵 소스 수준은 맵 계층 구조의 드릴 수준에 해당하며 이러한 수준은 거의 일치합니다. 한 계층 구조에는 같은 수준의 맵 소스 하나만 동시에 존재할 수 있습니다. |
   | 활성 | 맵 보고서를 작성할 때 이 맵 소스를 사용할 수 없게 하려면 이 확인란의 선택을 취소합니다. |
   [표 1. 맵 소스 필드]

   {#customize-geomap-source__table_bnf_gxf_cyb}
7. 데이터 변환 섹션에서 다음 정보를 지정합니다.  
   {#customize-geomap-source__table_wxt_3dg_1v__entry__2}{#customize-geomap-source__ph_rmc_mb1_1z}

   | 필드 | 설명 |
   |-|-|
   | 데이터 사용 방법 | 이 맵 소스에서 데이터를 사용하는 방법을 선택합니다. * 테이블에서 데이터 사용: 데이터를 변환하지 않고 사용합니다 Now Platform® . 데이터가 매핑하는 JSON 키 값과 이미 일치하는 경우 이 옵션을 선택합니다. * 매핑 사용: 가장 일반적인 사용 사례입니다. 매핑하는 JSON 키 값과 일치하도록 데이터를 변환합니다. hc-key geoJSON 키를 사용하는 지리적 맵 소스의 경우 항상 이 옵션을 선택합니다. 지역과 도가 가장 낮은 수준 매핑이므로 이 옵션은 시/도 수준 아래의 데이터에는 사용할 수 없습니다. * 위도 및 경도 사용: 수준 3과 같은 맨 아래 맵 수준에 대해 항상 이 옵션을 선택합니다. 데이터에 위도 및 경도 값이 있는지 확인합니다. 경고: Use longitude and latitude(경도 및 위도 사용 옵션)는 드릴다운을 비활성화하므로 계층의 최하위 수준인 맵 소스 수준에서만 이 옵션을 선택합니다. {#customize-geomap-source__ul_amx_zfg_1v} |
   | 이 매핑을 사용 | 매핑 사용을 선택한 경우 사용할 매핑 그룹을 선택합니다. 매핑 그룹은 데이터를 변환하는 키-값 쌍 매핑의 컬렉션입니다. 매핑 그룹의 매핑을 검토하려면 위치 매핑 \[sys_report_map_source_mapping\] 테이블로 이동합니다. 예를 들어 필드 값 USA 를 hc-key value us로 변환하는 경우 관련 키-값 쌍 매핑이 포함된 국가 매핑을 선택합니다. |
   [ ]

   {#customize-geomap-source__table_wxt_3dg_1v}
8. JSON 키 섹션에서 JSON 키를 선택하여 맵 소스 데이터를 맵에 연결합니다.  
   지리적 맵은 일반적으로 hc 키를 사용합니다.

   모든 지리적 맵에는 JSON 정의가 있습니다. 데이터를 매핑할 JSON 키-값 쌍을 하나 선택합니다. 맵에 표시할 데이터는 JSON 키 값과 일치해야 합니다. 따라서 선택한 키는 데이터 사용 방법 섹션의 설정을 사용하여 데이터를 변환해야 하는지 여부를 결정합니다. 모든 기본 플랫폼 맵과 매핑에는 [geoJSON](http://geojson.org/) hc-key 및 ISO 3166 표준 값이 사용됩니다. 사용자 지정 맵의 경우 다른 JSON 키를 입력할 수 있습니다.
9. 업데이트를 선택합니다.