ジオマップデータの可視化のためのマップソース

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：7分

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

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

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

    データの可視化とレポートのマップソースの違い

    コア UI のマップ レポートに精通している場合は、ジオマップのマップ ソースがマップ レポートのマップ ソースとは異なることに気付いたかもしれません。これらは、sys_report_map_sourceとviz_map_sourceが異なるマップソーステーブルにあるため、十分に異なります。最も重要な違いは、テーブルの参照方法です。

    マップレポートでは、マップソースはインシデント [incident] などのファクトテーブルを参照します。マップソースには、場所テーブルを指す参照フィールドも含まれています。子マップソースは、場所テーブルのフィールドへのドット連結です。この構造により、マップのデータソースとして必要なデータテーブルごとに個別のマップソース階層が作成されます。
    図 : 1. マップレポートのマップソース

    ファクトテーブルを表示するマップレポートのマップソースのリスト。
    ジオマップのマップソースは、場所テーブルを直接指しています。ファクトテーブルは参照されません。ファクトテーブルは、ジオマップデータの可視化でのみ指定されます。この構造により、表示されるデータに関係なく、インスタンス上のすべてのジオマップに対して 1 つのマップ階層を再利用できます。
    図 : 2. ジオマップデータの可視化のためのマップソース
    インスタンス上のすべてのジオマップデータの可視化のための再利用可能なマップソースのセット。

    データ可視化マップソースの作成

    ジオマップデータの可視化でカスタムロケーションテーブルを使用するには、テーブルにリンクするマップソースを定義します。階層のさまざまなレベルにマップ ソースを追加します。

    始める前に

    必要なロール: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. 次の情報を指定します。
        フィールド 説明
        名前 マップソースの名前を追加します。テーブルの内容を示すわかりやすい名前を使用します。この階層に作成する他のすべてのマップ ソースの名前の一部として、この名前を含めます。
        テーブル データの可視化マップソースでまだ使用されていない場所テーブルを選択します。また、選択するテーブルは、データ可視化マップソースで既に使用されているテーブル (cmn_location など) を参照してはなりません。
      3. [送信] を選択します。
      これで、新しいマップソース階層の親マップソースが作成されました。階層にさらにレベルを追加できます。
    4. テーブルのマップソース階層が存在する場合は、作成するマップソースの 1 レベル上のマップソースを開きます。
      注:
      トップレベルの親の下に設定できるマップソースのレベルは 4 つまでです。
    5. [ マップソース ] 関連リストで、[ 新規] を選択します。
      新しいマップソース [viz_map_source] レコードが開き、[テーブル] フィールドと [親] フィールドが読み取り専用になります。
    6. 次の情報を指定します。
      表 : 1. ソースフィールドをマッピング
      フィールド 説明
      名前 マップソースの名前を入力します。マップソースレベルの名前にレベルを含めます。通常、同じ階層内のすべてのマップソースに同じルート名を付けます。ロケーションマッピング (レベル 2) やロケーションマッピング (レベル 3) など、レベルによってのみ区別します。
      テーブル (読み取り専用) 同じテーブルがマップ ソース階層全体で使用され、最上位のマップ ソースで指定されます。
      フィールド 表示しているマップよりも 1 レベル詳細な位置データのフィールドを選択します。
      たとえば、世界地図に表示されるレベル 1 マップソースのデータを構成しているとします。国のデータは世界地図に表示されるため、[ 場所の国] を選択します。同様に、ドイツまたは米国の地図に表示するデータを構成する場合は、[ 場所の都道府県] を選択します。
      注:
      市区町村は、マップレポートにドリルダウンするときに表示できる最も詳細な場所レベルです。たとえば、都市内のさまざまなサイトの場所についてレポートする必要があり、location.name を含む最下位レベルのマップソースフィールドを定義する場合、マップレポートには複数の場所が対応する都市ラベルとして表示されます。その結果、同じ location.city 値を持つ複数の場所についてレポートすると、同じラベルを持つ複数のマップドットが表示されますが、集計値が異なり、異なる場所にドリルダウンされます。
      レベル このマップソースの階層レベルを選択します。親マップソースのレベルより 1 レベル低いレベルを選択する必要があります。最大 4 つのレベルを設定できます。各マップソースレベルはマップ階層のドリルレベルに対応しており、これらのレベルはほぼ一致しています。階層に同時に存在できるのは、同じレベルの 1 つのマップ ソースのみです。
      有効 マップレポートの作成時にこのマップソースを使用不可にするには、このチェックボックスをオフにします。
    7. [ データ変換 ] セクションで、次の情報を指定します。
      フィールド 説明
      データの使用方法 このマップ ソースでデータを使用する方法を選択します。
      • テーブルのデータを使用: ServiceNow AI Platform® 内のデータを変換せずに使用します。データがマッピング先の JSON キー値と既に一致する場合は、このオプションを選択します。
      • マッピングを使用:最も一般的なユースケース。マッピング先の JSON キー値と一致するようにデータを変換します。hc-key geoJSON キーを使用する地理的マップソースの場合は、常にこのオプションを選択します。

        地域 と都道府県が 最下位レベルのマッピングであるため、このオプションは州/都道府県レベルの下のデータでは使用できません。

      • 緯度と経度を使用:レベル 3 などの最下位のマップレベルでは常にこのオプションを選択します。データに緯度と経度の値があることを確認します。
        警告:
        [ 経度と緯度を使用 ] オプションはドリルダウンを無効にするため、階層の最下位レベルであるマップソースレベルでのみこのオプションを選択します。
      次のマッピングを使用 [ マッピングを使用] を選択した場合は、使用するマッピンググループを選択します。マッピンググループは、データを変換するキーと値のペアのマッピングのコレクションです。マッピンググループのマッピングを確認するには、ロケーションマッピング [sys_report_map_source_mapping] テーブルに移動します。

      たとえば、フィールド値 USA を hc-key 値 us に変換する場合は、関連するキーと値のペアのマッピングが含まれている [ 国マッピング] を選択します。
    8. [JSON キー] セクションで、マップソースデータをマップに接続するための JSON キーを選択します。
      地理的地図では、通常 hc キーを使用します。

      すべてのジオマップには JSON 定義があります。データをマッピングする JSON キーと値のペアを 1 つ選択します。マップに表示するデータは、JSON キー値と一致する必要があります。そのため、選択したキーによって、[ データの使用方法 ] セクションの設定でデータを変換する必要があるかどうかが決まります。すべてのデフォルトのプラットフォームマップとマッピングは、 geoJSON hc-key および ISO 3166 標準値を使用します。カスタムマップの場合は、別の JSON キーを入力できます。

    9. [Update (更新)] を選択します。