---
sourceDocument: Xanadu プラットフォームアナリティクス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/now-intelligence

 Release :

    - xanadu

ft:locale :

    - ja-JP

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) 所要時間：7分

ジオマップデータの可視化は、特別なマップソースの場所テーブルに接続されます。

ジオマップのマップ ソースは、マップ ソース階層に整理されます。同じテーブルを参照するすべてのマップ ソースは、同じ階層内にあります。マップ ソース階層は、親ソースと最大 4 レベルの子ソースで構成されます。親ソースはテーブルのみを参照し、子ソースはテーブル内のフィールドを参照します。

デフォルトでは、インスタンスには場所 \[cmn_location\] テーブルを参照するジオマップのマップソース階層があります。そのため、ジオマップ上に \[場所\] のフィールドを参照する \[グループ\] フィールドを設定できます。\[グループ\] フィールドは、データ ソース テーブルの最上位に配置することも、ドット連結することもできます。カスタムロケーションテーブルを参照する追加のマップソース階層を作成できます。

## データの可視化とレポートのマップソースの違い {#geomap-map-source__section_znr_nhg_cyb}

コア UI のマップ レポートを使い慣れている場合は、ジオマップのマップ ソースがマップ レポートのマップ ソースとは異なることに気付いたかもしれません。これらは、異なるマップソーステーブル、sys_report_map_source、およびviz_map_sourceに存在するのに十分な違いがあります。最も大きな違いは、テーブルの参照方法です。  
マップ レポートでは、マップ ソースはインシデント \[incident\] などのファクト テーブルを参照します。マップ ソースには、場所テーブルを指す参照フィールドも含まれています。子マップソースは、場所テーブルのフィールドにドット連結します。この構造により、マップのデータソースとして必要なデータテーブルごとに個別のマップソース階層が作成されます。図 : 1. マップ レポートのマップ ソース   

ジオマップのマップ ソースは、場所テーブルを直接指します。ファクトテーブルは参照しません。ファクトテーブルは、ジオマップデータの可視化でのみ指定されます。この構造により、表示されるデータに関係なく、インスタンス上のすべてのジオマップに対して 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. テーブルのマップ ソース階層が存在する場合は、作成するマップ ソースの 1 つ上のレベルにあるマップ ソースを開きます。  
   注:  
   最上位の親の下にマップ ソースのレベルを 4 つまで設定できます。
5. \[ マップソース \] 関連リストで、\[ 新規\] を選択します。  
   新しいマップソース \[viz_map_source\] レコードが開き、\[テーブル\] フィールドと \[親\] フィールドが読み取り専用になります。
6. 次の情報を指定します。  
   {#customize-geomap-source__table_bnf_gxf_cyb__entry__2}

   | フィールド | 説明 |
   |-|-|
   | 名前 | マップ ソースの名前を入力します。マップ ソース レベルの名前にはレベルを含めます。通常、同じ階層内のすべてのマップ ソースに同じルート名を付けます。ロケーションマッピング (レベル 2) とロケーションマッピング (レベル 3) のように、レベルによってのみ区別してください。 |
   | テーブル (読み取り専用) | 同じテーブルがマップ ソース階層全体で使用され、最上位のマップ ソースで指定されます。 |
   | フィールド | 表示しているマップよりも詳細度が 1 レベル高い位置データのフィールドを選択します。 たとえば、世界地図に表示されるレベル 1 のマップ ソースのデータを構成する場合は、各国のデータを世界地図上に表示するため、\[場所：国\] を選択します。同様に、都道府県の地図に表示するデータを構成する場合は、\[場所：都道府県\] を選択します。 注: 市区町村は、マップ レポートにドリル ダウンするときに表示できる最も詳細な場所レベルです。たとえば、都市内のさまざまな場所のレポートを作成して、最下位のマップ ソース フィールドの定義に location.name を含めた場合、マップ レポートには複数の場所が対応する市ラベルとして表示されます。その結果、同じ location.city の値を持つ複数の場所のレポートを作成すると、ラベルが同じで集計値が異なる複数のマップ ドットが表示され、異なる場所にドリル ダウンされます。 |
   | レベル | このマップ ソースの階層レベルを選択します。親マップ ソースのレベルより 1 つ低いレベルを選択する必要があります。最大 4 つのレベルを持たせることができます。マップ ソース レベルはそれぞれ、マップ階層のドリル レベルに対応し、それらのレベルはほとんど一致しています。同じレベルのマップ ソースは、階層内に同時に 1 つだけ存在できます。 |
   | アクティブ | マップ レポートの作成時にこのマップ ソースを使用できないようにするには、このチェック ボックスをオフにします。 |
   [表 : 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}

   | フィールド | Description (説明) |
   |-|-|
   | データの使用方法 | このマップ ソースでのデータの使用方法を選択します。 * テーブルのデータを使用: Now Platform® 内のデータを変換せずに使用します。データがマッピング先の JSON キー値と既に一致する場合は、このオプションを選択します。 * マッピングの使用:最も一般的なユースケースです。マッピング先の JSON キー値と一致するようにデータを変換します。hc キーの geoJSON キーを使用する地図のマップ ソースの場合は、常にこのオプションを選択します。 地域と都道府県は最下位レベルのマッピングであるため、このオプションは都道府県レベルより下位のデータには使用できません。 * 緯度と経度を使用: レベル 3 などの下位のマップ レベルでは、このオプションを常に選択します。データに緯度と経度の値があることを確認します。 警告: \[ 経度と緯度を使用 \] オプションはドリルダウンを無効にするため、このオプションは階層の最下位レベルにあるマップ ソース レベルでのみ選択します。 {#customize-geomap-source__ul_amx_zfg_1v} |
   | 次のマッピングを使用 | \[マッピングを使用\] を選択した場合は 、使用するマッピング グループを選択します。マッピング グループは、データを変換するキーと値のペアのマッピングの集まりです。マッピング グループ内のマッピングを確認するには、\[場所マッピング\] の \[sys_report_map_source_mapping\] テーブルに移動します。 たとえば、フィールド値 USA を hc キー値 us に変換する場合は、関連するキーと値のペアのマッピングを含む \[ 国のマッピング\] を選択します。 |
   [ ]

   {#customize-geomap-source__table_wxt_3dg_1v}
8. \[JSON キー\] セクションで、マップ ソース データをマップに結び付ける JSON キーを選択します。  
   地図では通常、hc キーを使用します。

   すべてのジオマップには JSON 定義があります。データのマップ先となる JSON のキーと値のペアを 1 つ選択します。マップに表示するデータは、JSON キー値と一致する必要があります。したがって、選択するキーによって、\[データの使い方\] セクションの設定でデータを変換する必要があるかどうかが決まります。すべてのデフォルトのプラットフォームマップとマッピングは、 [geoJSON](http://geojson.org/) hc キーと ISO 3166 標準値を使用します。カスタム マップでは、別の JSON キーを入力できます。
9. \[更新\] を選択します。