マップ [レガシー]

マップ [レガシー] とマップの比較

マップウィジェットは、強化された機能とよりモダンなインターフェースを備えているため、ほとんどのユースケースで推奨されます。ただし、新しいマップウィジェットが対応していないユースケースでは、マップ [レガシー] ウィジェットが引き続き役立つ場合があります。どちらを使用するか判断するために、以下の2つのウィジェットの比較を参照してください。

新しいプロジェクトや既存の設定を更新する際には、マップウィジェットへの移行を検討してください。一般に、パフォーマンスが向上し、継続的な機能更新も利用できます。

マップ [レガシー] の概要

マップ [レガシー] ウィジェットは、オブジェクトデータを簡略化された地理空間可視化で表示します。

これらのマップの可視化は、2種類のレイヤーで構成されます。

• ベースレイヤー： タイルレイヤーとも呼ばれ、背景となる地図画像を表示します。
• オーバーレイレイヤー： ベースレイヤーの上にポイントや図形としてデータを表示します。

マップ [レガシー] ウィジェットは、MapboxGL ↗ による地図のレンダリングに対応しています。ユーザーのブラウザーが WebGL に対応していない場合は、Leaflet ↗ で地図をレンダリングします。

マップ [レガシー] ウィジェットは、ベースマップ画像の主要なソースとして Mapbox を使用します。また、Mapbox へのプロキシ接続ができないセキュアなネットワーク向けに、ベースマップ画像のカスタムソースにも対応しています。Web 地図の技術については、Mapbox のドキュメント ↗ を参照してください。

以下の画像は、さまざまな種類のレイヤーを表示するように設定されたマップ [レガシー] ウィジェットの例です。

レイヤーの種類

マップ [レガシー] ウィジェットでは、オーバーレイレイヤーが地図のベースレイヤーの上にポイントや図形としてデータを表示します。マップ [レガシー] ウィジェットには、以下の種類のオーバーレイレイヤーがあります。

• ポイント
• クラスター
• コロプレス
• 線分
• 静的
• 保存済

ポイント

ポイントレイヤーは、ポイントやマーカーを使用して地図上に個々のオブジェクトを表示します。緯度と経度のペアの形式で保存された Geopoint プロパティを使用してプロットします。ポイントの色、アイコンの種類、サイズは、プロットするオブジェクトのプロパティに基づいてスタイルを設定できます。

設定については、以下のポイントレイヤーを設定するセクションを参照してください。

例：病院の場所をポイントとして表示し、利用可能な病床数に応じて色分けした地図。

クラスター

クラスターレイヤーは、位置を表す Geopoint プロパティに基づく大規模なオブジェクトセットに最適です。クラスターはポイントに似ていますが、オブジェクトごとに1個のマーカーをプロットするのではなく、プロットするオブジェクトを地理的な近さに基づいてクラスターに集計します。クラスターのサイズや色は、特定の範囲内にあるオブジェクトの数、またはリージョン内のオブジェクト全体にわたるプロパティの合計や平均などの集計関数を表すように設定できます。

設定については、以下のクラスターレイヤーを設定するセクションを参照してください。

例：全国の気象観測所のおおまかな地理的分布を示す地図。

コロプレス

マップ [レガシー] ウィジェットのコロプレスレイヤーは、国や省などのリージョンを表示し、そのリージョンが表すオブジェクトの属性や集計結果に基づいて色分けします。これにより、リージョン間の違いやパターンを可視化でき、これらの値の経時的な変化を確認することもできます。

設定については、以下のコロプレスレイヤーを設定するセクションを参照してください。

Functions で H3 六角形のカスタム集計に対応するため、コロプレスレイヤーを使用して H3 六角形を個別のリージョンとして地図上に表示することもできます。以下のH3 用のコロプレスレイヤーを設定するセクションを参照してください。

例：各州を人口密度に応じて色分けした州の地図。

線分

線分レイヤーは、2点を結ぶ線分として個々のオブジェクトをプロットします。

設定については、以下の線分レイヤーを設定するセクションを参照してください。

例：出発空港と到着空港を、飛行ルートを表す線で結んで表示した地図。

静的

静的レイヤーは、動的に絞り込むことができない、オブジェクトデータ以外のソースから取得した情報を表示します。これらのレイヤーは、同じマップ上のほかのデータレイヤーに背景情報を添えて理解を助ける場合に特に役立ちます。レイヤーのデータは、GeoJSON ↗ 形式またはベクターレイヤーを通じて指定できます。

設定については、以下の静的レイヤーを設定するセクションを参照してください。

例：さまざまな地域で悪天候が発生するリスクを示すレイヤー。

保存済

保存済レイヤーは、マップレイヤーエディターで設定し、個別のリソースとして保存したマップレイヤーを表示します。これらのレイヤーは複数のアプリケーション間で共有でき、Foundry 全体で一貫した背景情報を示すためによく使用されます。

設定オプション

• 基本設定
• ポイントレイヤー
• クラスターレイヤー
• コロプレスレイヤー
• 線分レイヤー
• 静的レイヤー
• 集計値系列
• 非集計値系列
• 色のコントロール
• 選択、表示設定、イベント
• 描画コントロール
• タイムステッパーのコントロール
• ビューポートフィルターのコントロール

基本設定

以下は、新しく追加された、まだ設定されていないマップ [レガシー] ウィジェットと、その設定パネルの例です。

マップ [レガシー] ウィジェットの基本設定オプションは次のとおりです。

• マップスタイル： この設定では、表示されるベースマップのタイルを制御します。
  • デフォルトでは、これらのタイルは Mapbox から読み込まれ、使用は既存のエンタープライズライセンスでカバーされます。Mapbox のタイルは、ライト、ダーク、衛星など、いくつかのテーマをサポートしています。
  • また、内部設定でカスタムタイルソースを選択することもできます。カスタムマップスタイルやベースタイルソースの設定の詳細については、Palantir の担当者にお問い合わせください。
• マップビューポート： 表示されているデータの範囲に合わせてマップを自動で全体表示するか、マップの初回読み込み時に事前設定されたビューポートを使用するかを選択できます。
  • 全体表示： 表示されているデータの範囲に合わせてマップが自動的にズームされ、データの変更（たとえば、フィルターによる変更）に合わせて調整されます。
    • フィットさせる際の最大ズーム： マップの自動ズームの最大ズームレベルを設定します。
  • 初期ビューポート： 初回読み込み時に表示される、事前設定されたビューポートです。この設定を使用する場合、ページまたはタブを再読み込みしない限り、マップのビューポートはリセットされません。
• 凡例： 凡例には、次のような設定があります。
  • 凡例全体を表示するか非表示にするか
  • 位置と向き
  • 凡例を折りたためるかどうか（マップ上のスペースを節約するため）
  • 切り替え可能なレイヤー： エンドユーザーがマップの個々のレイヤーの表示と非表示を自分で切り替えられるようにするかどうか
• データレイヤー：****データレイヤーは、オブジェクトセットに基づくマップレイヤーです。データレイヤーの種類には、ポイント、クラスター、コロプレス、ラインがあります。それぞれに種類固有の設定がありますが、すべてのデータレイヤーで次の設定オプションが共通しています。
  • マップに表示するオブジェクトセット： データレイヤーへの入力変数であり、マップに表示されるデータを決定します。モジュールの作成者は、新しいオブジェクトセット変数を定義するか、Workshop モジュール内の別の場所で作成された既存のオブジェクトセット変数を再利用できます。
  • 選択、表示設定、イベントの設定： これらの設定オプションの詳細については、後述の選択、表示設定、イベントを設定するセクションを参照してください。これらのオプションは、レイヤー設定ペインの下部に表示されます。
  • その他のレイヤー固有の設定オプションの詳細は、以下を参照してください。
    • ポイントレイヤーの設定
    • クラスターレイヤーの設定
    • コロプレスレイヤーの設定
    • ラインレイヤーの設定
• 静的レイヤー： データレイヤーと静的レイヤーの主な違いは、静的レイヤーの表示にはオブジェクトセットが必須ではないことです。そのため、静的レイヤーを動的に絞り込むことはできません。静的レイヤーをオブジェクトセットに接続するように設定することもできます（必須ではありません）。この場合、静的レイヤー上のリージョンにホバーすると、オントロジー内の対応するオブジェクトの詳細が表示されます。詳細については、静的レイヤーの設定セクションを参照してください。
• マップ上での図形の描画を有効にする： この設定は、マップ上で図形を描画できるかどうかを決定します。この設定オプションを「はい」に設定すると、より詳細な設定が表示されます。詳細については、後述の描画コントロールを設定するセクションを参照してください。
• タイムステッパーを含める： この設定では、異なる時刻や日付におけるマップの状態を表示します。この設定オプションを「はい」に設定すると、より詳細な設定が表示されます。詳細については、後述のタイムステッパーのコントロールを設定するを参照してください。
• 公開済みビューポートフィルター： この設定は、ウィジェット内で表示されているマップの範囲に基づいてオブジェクトセットを絞り込むために役立ちます。詳細については、後述のビューポートフィルターのコントロールを設定するセクションを参照してください。
• 地名検索を有効にする： 有効にすると、マップの左上に検索アイコンが表示され、世界中の地点や住所を検索できます。ユーザーはマップを拡大し、指定した地点にマーカーを設定できます。検索結果のタイトルと Geopoint データは文字列変数に保存されます。マップ上にマーカーを表示するには、この変数を初期化する必要があります。
• ユーザーの現在位置を表示する： 有効にすると、デバイスの位置情報に基づいて、ユーザーの現在位置がマップ上に表示されます。ユーザーが現在位置を拡大表示できるようにするには、マップの左下に追加のボタンを表示する設定を有効にします。この設定は、一部のデバイスやブラウザーではサポートされていない場合があります。

ポイントレイヤーを設定する

ポイントレイヤーの主な設定オプションは次のとおりです。

• Geopoint プロパティ： マップに表示するオブジェクトセットの Geopoint プロパティタイプです。セット内の各オブジェクトの位置を示す Geopoint（緯度と経度のペア）が格納されています。
• 検索結果のページ数： 読み込まれるオブジェクトの数を決定します。最大10,000個のオブジェクトを読み込むことができます。
• 凡例のヘッダー： ユースケースや系列を説明する凡例ラベルです。
• スタイル： 各ポイントのアイコンの種類、色、サイズを設定できます。それぞれ、固定のスタイル、または各ポイントに対応するオブジェクトの選択したプロパティの値に基づく、動的なデータ駆動型スタイルに設定できます。設定の詳細については、後述の非集計値系列の設定および色の設定セクションを参照してください。
• オブジェクトプレビューに表示するプロパティ： 各ポイントのホバー時またはクリック時に表示されるツールチップには、設定された任意のプロパティを表示できます（「強調」、「特定」、「なし」など）。
• ポイント接続の設定： データが並べ替え可能な場合、ポイントを線で接続できます。この設定オプションを線で接続に設定すると、より詳細な設定が表示されます。
  • 並べ替えのプロパティタイプ： ポイントの並べ替えに使用するプロパティです。並べ替え順序によって、どのポイント同士を接続するかが決まります。
  • 順番にソート： ポイントを並べ替える順序です。
  • 色： ポイントを接続する線の色です。
  • 幅： ポイントを接続する線の幅です。
  • ストローク： ポイントを接続する線のストロークです。

クラスターレイヤーを設定する

クラスターレイヤーの主な設定オプションは次のとおりです。

• Geopoint プロパティ： 地図上に表示するオブジェクトセットの Geopoint プロパティタイプです。セット内の各オブジェクトの場所を示す Geopoint（緯度と経度のペア）が含まれます。クラスターを定義する際には、近くの Geopoint が考慮されます。
• 集計： 各クラスターに表示する値を計算するための集計を設定できます。たとえば、以下のスクリーンショットは、米国の空港から出発するフライトの総数を表示するクラスターレイヤーの設定を示しています（上の地図のように表示されます）。設定の詳細については、以下の集計値系列の設定セクションを参照してください。

• サイズの設定： クラスターのサイズを定義できます。サイズは、単一サイズ（均一なクラスター）または動的なサイズ（上で設定した集計から返される値に基づいてスケーリング）のいずれかにできます。
  • 単一サイズ： クラスターのサイズが均一になります。
    • サイズ： クラスターのサイズです。各クラスターのサイズは均一になります。
    • 凡例ラベル： ユースケースまたは系列を定義するラベルです。
  • 値に応じて自動スケーリング： クラスターのサイズは、基となる値に基づいて決まります。
    • スケールのタイプ： クラスターのサイズを決める値の計算に使用する数学的なスケールの種類です（線形、対数、平方根など）。データに大きな偏りがある場合は、線形スケーリングよりも対数または平方根スケーリングが適していることがあります。
    • 最大の下限値： 自動計算されるスケールで許容される下限値の最大値です。この下限値より低いデータ値がある場合、スケールはそれらの値を含むように拡張されます。
    • 最小の上限値： 自動計算されるスケールで許容される上限値の最小値です。この上限値より高いデータ値がある場合、スケールはそれらの値を含むように拡張されます。
• 色の設定： クラスターの色を定義できます。クラスターは均一な色にすることも、値に基づいて色を付けることもできます。設定の詳細については、以下の色の設定セクションを参照してください。
• 不透明度の設定： クラスターに単一の均一な不透明度を定義できます。
• 凡例ラベル： ユースケースまたは系列を定義するラベルで、凡例に表示されます。
• 値フォーマッター： 値を別の形式で表すことができます。たとえば、値をパーセントで表すには、値フォーマッターに % を設定します。指定する値は d3-format 文字列 ↗である必要があります。

コロプレスレイヤーを設定する

コロプレスレイヤーの主な設定オプションは次のとおりです。

• 凡例のヘッダー： このレイヤーの凡例セクションで、系列レベルの凡例ヘッダーの上に表示されるヘッダーです。レイヤー内の各系列には、凡例ヘッダーを指定するオプションがあります。
• コロプレスレイヤーの設定： コロプレスレイヤーとラインレイヤーには、集計または非集計を設定できます。一般に、すべてのコロプレスレイヤーは国や省などのリージョンを表示します。集計の種類によって、入力オブジェクトセットの各オブジェクトが特定のリージョンに対応するか（非集計）、特定のリージョン内に1個以上のオブジェクトが存在し得るか（集計）が異なります。
  • 集計： リージョン（国や省など）が表すオブジェクトの集計結果に基づいて色分けされたリージョンを表示します。たとえば、入力された経費に基づいて、国ごとのコスト対数量比を示す地図です。
    • リージョンIDのプロパティタイプ：****リージョンIDプロパティを選択できます。このプロパティを基準に集計を実行して、各リージョンのデータ値を計算します。このリージョンIDプロパティの値は、以下で選択する境界ソースのリージョンIDと完全に一致している必要があります。
    • コロプレス境界ソース： レイヤーの境界ソースを選択できます。以下の「コロプレス境界ソース」に、サポートされている3種類のソース（Mapbox、ジオJSON、ベクター）の詳細を示します。
    • 集計値の設定： 集計系列のリストを定義できます。各系列では、プロットされるオブジェクトがリージョンIDに基づいて集計されます。リージョンの色は、特定のリージョンのオブジェクト数、またはリージョン内のオブジェクトのプロパティの合計や平均など、ほかの集計関数を表すように設定できます。設定の詳細については、以下の集計値系列の設定および色の設定のセクションを参照してください。
  • 非集計： リージョンが表すオブジェクトのプロパティ値に基づいて色分けされたリージョンを表示します。たとえば、米国の州を表示し、各州を人口密度で色分けした地図です。この場合、人口密度は州のオブジェクトタイプのプロパティタイプです。
    • リージョンIDのプロパティタイプ：****リージョンIDプロパティを選択できます。このプロパティ値は各リージョンを一意に識別するために使用され、「リージョン」を選択した場合に、このプロパティで絞り込みが行われます。このリージョンIDプロパティの値は、以下で選択する境界ソースのリージョンIDと完全に一致している必要があります。
    • コロプレス境界ソース： レイヤーの境界ソースを選択できます。以下の「コロプレス境界ソース」に、サポートされている3種類のソース（Mapbox、ジオJSON、ベクター）の詳細を示します。
    • 非集計値の設定： 非集計系列のリストを定義できます。各系列では、リージョンの色を、プロットされるオブジェクトのプロパティ値を表すように設定できます。設定の詳細については、以下の非集計値系列の設定および色の設定のセクションを参照してください。
    • 検索結果のページ数： 読み込まれるオブジェクト数を決定します。1ページは1000個のオブジェクトです。非集計レイヤーごとに、最大10,000個のオブジェクト（10ページ）を読み込めます。
    • オブジェクトプレビューに表示するプロパティ： 各ポイントのホバー時またはクリック時に表示されるツールチップには、設定した任意のプロパティ（強調、特定、なしなど）を表示できます。 コロプレス境界ソース： コロプレスレイヤーを設定するには、表示するリージョンを定義する境界のソースを指定する必要があります。境界データには、いくつかのソースを使用できます。
• Mapbox ソース： 世界各地の一般的なリージョン（国、州、郡など）を表示したい場合に、コロプレスを最も簡単に設定できる方法です。このオプションは、Mapbox のエンタープライズ境界セット ↗を利用します。Foundry インスタンスに Mapbox の境界データセットをインストールする方法を参照してください。
  • Mapbox エンタープライズ境界バージョン： 現在、Mapbox の2つのバージョン（V3 と V4）がサポートされています。最新の境界を使用するには、V4 を推奨します。
    • Mapbox ソース設定ID：境界の種類とデータレベル ↗を選択できます。Mapbox Boundaries のデータは、境界の役割に基づいて、管理者、立法、地域、郵便番号、統計の5つの大きな種類に分類されます。各境界の種類の中で、フィーチャーは番号の異なるレベルの階層に整理されています。通常、番号の大きいレベルは番号の小さいレベルの配下にあります。たとえば米国では、郡（管理レベル2）は州（管理レベル1）の下位区分であり、州は国（管理レベル0）の下位区分です。
      • レイヤーのリージョンIDプロパティタイプは、選択した境界レベルで必要とされる Mapbox のフィーチャーIDと一致する必要があります。これらのフィーチャーID値のマッピングは、プラットフォーム上にすでに存在しているはずのインポート済みデータセットで利用可能です。これらのマッピングの場所が分からない場合は、Palantir の担当者にお問い合わせください。
    • ワールドビュー： この機能 ↗は、境界に複数のバージョンが存在する場合に、対象ユーザーに応じた地図の境界を表示します。現在利用可能な選択肢は、米国、日本、インド、中国です。
• GeoJSON ソース： このオプションは、GeoJSON で定義された単純なカスタムリージョンがある場合や、環境から Mapbox API にアクセスできない場合（ネットワークの制限など）に役立ちます。このオプションは、GeoJSON ↗ 形式のデータを利用します。
  • 集計 GeoJSON： 単一の GeoJSON ファイル（プロジェクトにアップロード）として境界セットを定義できます。このオプションは、図形の数や図形の複雑さの点で一般に規模が小さく、プロットしたいオブジェクトの規模が大きく、各リージョンが1個以上のオブジェクトを表す可能性がある場合（そのためオブジェクトが集計される場合）に適しています。
    • GeoJSON ソース RID： アップロードした GeoJSON ファイルのリソース RID です。
    • リージョンIDのフィーチャープロパティ： 各リージョンの ID を含む GeoJSON 内のプロパティIDです。GeoJSON 内のこれらの値は、オブジェクトのリージョンIDプロパティ（上で定義）と照合されます。
    • リージョン表示名のフィーチャープロパティ： 各リージョンの表示名を含む GeoJSON 内のプロパティIDです。
  • 非集計 GeoJSON： 地図上の各リージョン/オブジェクトの GeoJSON を含む、入力オブジェクトの Geoshape プロパティを選択できます。このオプションは、図形の規模や図形の複雑さが高くても、オブジェクトの規模がまだ管理可能な場合に適しています。各オブジェクトは1個の図形にのみ対応でき、各図形は1個のオブジェクトにのみ対応できます。
    • GeoJSON ジオメトリのプロパティタイプ： GeoJSON ジオメトリを定義するプロパティタイプです（geoshape 型または string 型のプロパティをサポートします）。
• ベクターソース： ベクターソースは基本的な GeoJSON よりもパフォーマンスに優れているため、このオプションは、非常に詳細な、または非常に大規模なカスタム境界定義がある場合に特に役立ちます。このオプションを使用するには、ベクターソースがタイルサーバー（内部または外部のいずれでも可）でホストされている必要があります。
  • ソース URL： タイルサーバーでホストされているタイルセットの完全な URL です。
  • レイヤー名： 設定されたタイルソース内のベクターレイヤーの ID です。
  • リージョンIDのフィーチャープロパティ： 各リージョンの ID を含む、各ベクターフィーチャー内のプロパティIDです。ベクターフィーチャー内のこれらの値が、オブジェクトのリージョンIDプロパティ（上で定義）と照合されます。
  • リージョン表示名のフィーチャープロパティ： 各リージョンの表示名を含む、各ベクターフィーチャー内のプロパティIDです。これは集計されたベクターソースでのみサポートされます。
  • 最小ズーム： マップのズームレベルが最小ズームを下回る場合、タイルソースへのクエリは実行されません（レイヤーも表示されません）。
  • 最大ズーム： マップのズームレベルが最大ズームを上回る場合、タイルソースへのクエリは実行されません（レイヤーも表示されません）。

H3 用のコロプレスレイヤーを設定する

マップ [レガシー] ウィジェットに表示するカスタム集計をサポートするように H3 用のコロプレスレイヤーを設定するには、Ontology Manager で H3 Hexagon などのオブジェクトタイプを設定する必要があります。このオブジェクトタイプでは、各オブジェクトが目的の解像度の H3 六角形であり、各六角形とそれに関連する GeoJSON の図形を一意に識別するためのプロパティを持ちます。オブジェクトタイプのプロパティの例を以下に示します。

1. hex_index：各 H3 六角形の一意の識別子です。値の例：82f25ffffffffff
2. hex_geojson：H3 六角形の GeoJSON ジオメトリです。値の例：

Copied!
1
{"type":"Polygon","coordinates":[[[-114.88722592804382,-74.86647343694071],[-110.43933775312789,-76.04791578897344],[-103.98485051466383,-75.45226049628374],[-103.08914246618076,-73.75952697882984],[-107.50751324842204,-72.74554847287561],[-112.95182804024837,-73.26746640072781],[-114.88722592804382,-74.86647343694071]]]}

次に、マップ [レガシー] ウィジェットの設定オプションを次のように適用できます。

• マップに表示するオブジェクトセット： H3 六角形を使用して設定したオブジェクトタイプ（この例では「H3 Hexagon」）を指定します。
• レイヤー設定： コロプレスを選択します。
  • コロプレスレイヤーの設定： 非集計を選択します。
    • リージョンIDのプロパティタイプ： 各 H3 六角形の一意の識別子（この例では hex_index）を選択します。
    • コロプレスの境界ソースとデータ設定： GeoJson を選択します。
      • GeoJSON ジオメトリのプロパティタイプ： GeoJSON ジオメトリを含むプロパティ（この例では hex_geojson）を選択します。

次に、非集計値の設定オプションを使用して関数ベースのプロパティを設定し、オブジェクトセットの入力を H3 六角形ごとに集計して、マップ [レガシー] ウィジェットに値を表示できます。たとえば、以下の関数は、入力オブジェクトセット内の H3 六角形ごとに、導出された COVID 検査の陽性率を計算します。

Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
import { Function, Double, FunctionsMap} from "@foundry/functions-api";
import { Objects, ObjectSet, CovidPositive, CovidTest, H3Hexagon} from "@foundry/ontology-api";


export class MyFunctions {

    @Function()
    public async calculateCovidPositivityRate(hexes: ObjectSet<H3Hexagon>,
                                       positives: ObjectSet<CovidPositive>,
                                       tests: ObjectSet<CovidTest>): Promise<FunctionsMap<H3Hexagon, Double>> {
        const map = new FunctionsMap<H3Hexagon, Double>();
        // 解像度2のすべての H3 六角形を集計できるように、最大バケット数を6000に設定します
        const max_buckets = {maxBuckets: 6000}

        const positives_bucketed = await positives
            .groupBy(positive => positive.hex_index.exactValues(max_buckets))
            .count();

        // バケット化された配列よりも効率的に参照できるように、結果をマップに変換します
        const positives_hex_map = new Map();
        positives_bucketed.buckets.forEach((bucket: any) => {
            positives_hex_map.set(bucket.key, bucket.value);
        });

        const tests_bucketed = await tests
            .groupBy(test => test.hex_index.exactValues(max_buckets))
            .count();

        const tests_hex_map = new Map();
        tests_bucketed.buckets.forEach(bucket => {
            tests_hex_map.set(bucket.key, bucket.value);
        });

        hexes.all().forEach(hex => {
            const positive_count = positives_hex_map.get(hex.hex_index);
            const test_count = tests_hex_map.get(hex.hex_index);
            if ((positive_count !== undefined) && (test_count !== undefined)) {
                map.set(hex, positive_count/test_count * 100);
            }
        });

        return map;
    }
}

H3 六角形の解像度2を使用している場合、5,882個の六角形をすべてプロットするには、検索結果のページ数を6に増やす必要があります。

線分レイヤーを設定する

線分レイヤーの主な設定オプションは次のとおりです。

• 凡例のヘッダー： このレイヤーの凡例セクションで、系列レベルの凡例ヘッダーの上に表示されるヘッダーです。レイヤー内の各系列には、凡例のヘッダーを指定するオプションがあります。
• 線分レイヤーの設定： 線分レイヤーは、コロプレスと同様に、集計または非集計にできます。線分レイヤーには何らかの線分が表示されます。集計レイヤーと非集計レイヤーの違いは、入力オブジェクトセット内の各オブジェクトが特定の線に対応するか（非集計）、1個以上のオブジェクトが特定の線に対応できるか（集計）です。
  • 集計： 線が表すオブジェクトの集計に基づいて色分けされた線を表示します。たとえば、特定のルートを通るすべてのフライトの平均遅延時間を示す地図です。
    • セグメントIDプロパティタイプ： 線分IDプロパティを選択できます。このプロパティに基づいて集計を行い、表示される各線のデータ値を計算します。このセグメントIDプロパティの値は、以下で選択する線分レイヤーソースのフィーチャーIDと完全に一致する必要があります。
    • 線分レイヤーソース： レイヤーの線分ソースを選択できます。以下の「線分レイヤーソース」では、集計線分レイヤーでサポートされる2種類のソースであるジオJSONとベクターについて詳しく説明します。
    • 集計系列の設定： 集計系列のリストを定義できます。各系列では、描画するオブジェクトをセグメントIDに基づいて集計します。線の色は、特定の線に対応するオブジェクト数や、ほかの集計関数（線に対応するオブジェクトのプロパティの合計や平均など）を表すように設定できます。設定の詳細については、以下の集計値系列の設定と色の設定のセクションを参照してください。
  • 非集計： 線が表すオブジェクトのプロパティ値に基づいて色分けされた線を表示します。たとえば、送電線を現在の稼働ステータスによって色分けして示す地図です。
    • セグメントIDプロパティタイプ： セグメントIDプロパティを選択できます。このプロパティ値は各線を一意に識別し、「線」を選択した場合に絞り込みに使用されるプロパティです。このセグメントIDプロパティの値は、以下で選択する線分レイヤーソースのフィーチャーIDと完全に一致する必要があります。
    • 線分レイヤーソース： レイヤーの線分ソースを選択できます。以下の「線分レイヤーソース」では、サポートされる3種類のソースであるポイントからポイント、ジオJSON、ベクターについて詳しく説明します。
    • 非集計系列の設定： 非集計系列のリストを定義できます。各系列では、描画するオブジェクトのプロパティ値を表すように線の色を設定できます。設定の詳細については、以下の非集計値系列の設定と色の設定のセクションを参照してください。
    • 検索結果のページ数： 読み込むオブジェクト数を決定します。各ページには1000個のオブジェクトが含まれます。非集計レイヤーごとに最大10,000個のオブジェクト（10ページ）を読み込めます。
    • オブジェクトプレビューに表示するプロパティ： 各ポイントのホバー時またはクリック時に表示されるツールチップには、設定した任意のプロパティ群（強調、特定、なしなど）を表示できます。 線分レイヤーソース： 線分レイヤーで線を描画する方法を指定するために、ソース情報を読み込む方法には次の種類があります。
• ポイントからポイント： 入力オブジェクトセット内の各オブジェクトについて、指定された始点と終点の Geopoint 間に直線を描画します。このオプションは非集計線分レイヤーでのみ利用可能です。
• GeoJSON ソース： このオプションは、GeoJSON で定義された単純なカスタム線分がある場合や、環境から Mapbox API にアクセスできない場合（たとえば、ネットワークの制限がある場合）に役立ちます。このオプションは GeoJSON (https://geojson.org/) 形式のデータを使用します。
  • 集計 GeoJSON： 単一の GeoJSON ファイル（Foundry にアップロードされたもの）で線分の定義を指定できます。このオプションは、線の数や複雑さが全般的に低く、描画するオブジェクトの規模が大きく、各線が1個以上のオブジェクトを表す場合（そのためオブジェクトが集計される場合）に最適です。
    • GeoJSON ソース RID： アップロードされた GeoJSON ファイルのリソース RID です。
    • リージョンIDのフィーチャープロパティ： 各線分フィーチャーの ID を含む、GeoJSON 内のプロパティIDです。GeoJSON 内のこれらの値が、オブジェクトのセグメントIDプロパティ（上記で定義）と照合されます。
    • リージョン表示名のフィーチャープロパティ： 各線分の表示名を含む、GeoJSON 内のプロパティIDです。
  • 非集計 GeoJSON： 地図上の各線の GeoJSON を含む、入力オブジェクトの Geoshape プロパティを選択できます。このオプションは、線の規模や複雑さがより高くても、オブジェクトの規模はまだ扱える範囲にある場合に最適です。各オブジェクトは1本の線にのみ対応でき、同様に各線は1個のオブジェクトにのみ対応できます。
    • GeoJSON ジオメトリプロパティタイプ： GeoJSON ジオメトリを定義するプロパティタイプです（geoshape 型または string 型のプロパティをサポートします）。
• ベクターソース： このオプションは、カスタム線分の定義が非常に詳細または非常に大規模な場合に最も役立ちます。ベクターソースは、基本的な GeoJSON よりもパフォーマンス面で優れています。このオプションでは、ベクターソースをタイルサーバー（内部または外部）でホストする必要があります。
  • ソース URL： タイルサーバーでホストされているタイルセットの完全な URL です。
  • レイヤー名： 設定されたタイルソース内のベクターレイヤーの ID です。
  • リージョンIDのフィーチャープロパティ： 各線の ID を含む、各ベクターフィーチャー内のプロパティIDです。ベクターフィーチャー内のこれらの値が、オブジェクトのセグメントIDプロパティ（上記で定義）と照合されます。
  • リージョン表示名のフィーチャープロパティ： 各線の表示名を含む、各ベクターフィーチャー内のプロパティIDです。これは集計ベクターソースでのみサポートされます。
  • 最小ズーム： マップのズームレベルが最小ズームを下回る場合、タイルソースへのクエリは行われません（また、レイヤーは表示されません）。
  • 最大ズーム： マップのズームレベルが最大ズームを上回る場合、タイルソースへのクエリは行われません（また、レイヤーは表示されません）。

静的レイヤーを設定する

静的レイヤーの主な設定オプションは次のとおりです。

• レイヤーソース： 静的レイヤーのソースには、GeoJSON またはベクタータイルセットを使用できます。
  • GeoJSON ソース： このオプションは、GeoJSON ↗ 形式のデータに使用します。境界セットを単一の GeoJSON ファイル（Foundry にアップロードしたもの）として定義できます。
    • Compass RID: アップロードした GeoJSON ファイルのリソース RID です。
  • ベクターソース： ベクターソースは基本的な GeoJSON よりもパフォーマンスに優れているため、このオプションは、非常に詳細なフィーチャーや非常に大規模なフィーチャーがある場合に最も役立ちます。このオプションを使用するには、ベクターソースをタイルサーバー（内部または外部）でホストする必要があります。単一のベクタータイルソースから複数のレイヤーを読み込めます。
    • ソース URL: タイルサーバーでホストされているタイルセットの完全な URL です。
    • レイヤー名： 設定したタイルソース内のベクターレイヤーの ID です。
• リージョンIDの設定： GeoJSON またはベクターソース内の各フィーチャーを一意に識別する ID を設定できます。リージョンIDには、フィーチャー固有の ID（つまり、フィーチャーの最上位の ID フィールド）を使用するか、各フィーチャーの指定されたプロパティ/属性から取得した値を使用できます。ホバーおよび選択のインタラクションには、リージョンIDの設定が必要です。リージョンIDが設定されていない場合、そのレイヤーはインタラクティブになりません。
• リージョンラベルのフィーチャー属性ID： 各フィーチャーのラベルを含む、そのフィーチャー内のプロパティ/属性IDです。このラベルはホバー時にツールチップに表示されます。
• スタイル： 静的フィーチャーのスタイルを定義します。静的フィーチャーがポリゴンの場合、色の設定はポリゴンの塗りつぶしに影響します。静的フィーチャーが線の場合、色の設定は線の色に影響します。詳細については、以下の色の設定セクションを参照してください。
• オブジェクトの設定： 静的レイヤーのホバー時にオブジェクトに基づくツールチップを表示できるほか、地図上の選択に対するオブジェクトセットフィルターを公開できます。
  • リージョンIDプロパティ： 地図上のフィーチャーをオントロジー内のオブジェクトに関連付けるために使用する、オブジェクトとプロパティタイプです。地図上のフィーチャー/リージョンのリージョンIDが、この設定されたプロパティタイプの値と一致すると、そのフィーチャーはオントロジー内のオブジェクトに関連付けられます。
  • オブジェクトプレビューに表示するプロパティ： 各ポイントのホバー時/クリック時に表示されるツールチップには、設定した任意のプロパティ（強調、特定、なしなど）を表示できます。
• 選択、表示設定、イベントの設定： 詳細については、以下の選択、表示設定、イベントを設定するセクションを参照してください。

集計値系列を設定する

集計値系列は、単純集計、関数集計、派生集計の3つの方法で設定できます。

• 単純集計： オブジェクトの件数、または別の集計関数（オブジェクト全体にわたるプロパティの合計や平均など）を表す単純な集計です。
• 関数集計： 集計関数は <locationId, value> のマップを返す必要があります。クラスターレイヤーの場合、場所の ID は Geopoint または geohash になり、コロプレスの場合は各リージョンのリージョンIDになります。たとえば、以下の関数は、入力された経費に基づいて国ごとのコスト対量比を計算します。

Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
@Function()
    public costToVolume(expenses: ObjectSet<Expense>): FunctionsMap<string, Double> {
        const map = new FunctionsMap<string, Double>();
        const costsPerCountry = expenses
            .groupBy(expense => expense.countryId.topValues())
            .sum(expense => expense.cost);
        const volumePerCountry = expenses
            .groupBy(expense => expense.countryId.topValues())
            .sum(expense => expense.volume);
        costsPerCountry.buckets.forEach(bucket => {
            var volume = volumePerCountry.buckets.find(b => b.key === bucket.key);
            map.set(bucket.key, bucket.value / volume);
        });
        return map;
    }

• 派生集計： 派生数式で表す集計です。数式は基本的な数値数式である必要があります。たとえば、ある国の30歳未満の人口の割合は、数式 (people under 30/ total population) で表せます。

非集計値系列を設定する

非集計値系列は、固定のプロパティ、関数ベースのプロパティ、時系列プロパティの3つの方法で設定できます。

• 固定のプロパティ： データを表すために値が必要となるプロパティです。以下のスクリーンショットは、米国の州を面積に応じて色分けした地図の固定のプロパティの設定を示しています。

• 関数ベースのプロパティ： 非集計関数は <object, value> のマップを返す必要があります。たとえば、以下の関数は、入力オブジェクトセット内の国ごとに、派生値である COVID 検査陽性率を計算します。

Copied!
1
2
3
4
5
6
7
8
9
@Function()
    public countryPositivityRate(countries: ObjectSet<Country>): FunctionsMap<Country, Double> {
        const positivityRatePerCountry = new FunctionsMap<Country, Double>();
        countries.all().forEach(country => {
            var positivityRate = country.dailyNewCases / country.dailyNewPositiveTests;
            positivityRatePerCountry.set(country, positivityRate);
        });
        return positivityRatePerCountry;
     }

• 時系列プロパティ： 時系列変換によって生成されたデータを含む時系列プロパティは、通常のプロパティと同様にマップ上で表示できます。時系列プロパティは、タイムスタンプ付きの値の履歴を保存するオブジェクトプロパティです。詳細については、Workshop の時系列プロパティを参照してください。

以下の例では、Country オブジェクトに時系列プロパティ COVID19 New Cases があり、その国で確認された COVID19 の新規感染者数の日次履歴を保存しています。次に、時系列変換によって、この日次の感染者件数が、感染者数の変化率を記録する時系列に変換されます。最後に、時系列サマライザーが、この変換された時系列の最新の値をマップのデータレイヤーに渡します。つまり、感染者数の値について、最後に確認された変化率を計算します。色の設定パネルでは、この値の国ごとの差が際立つようにマップのスタイルを設定します。時系列変換とサマライザーの詳細については、Workshop の時系列プロパティを参照してください。配色の設定の詳細については、以下の色の設定セクションを参照してください。

色のコントロールを設定する

次のスクリーンショットは、色の設定の設定オプションを示しています。

色の設定の設定オプションは次のとおりです。

• 色の設定： 色は3つの方法で設定できます。

  • 単色： 単一の色を選択できます。
    • 色： 地図上に表示する色です。
    • 凡例： ユースケースや系列を説明する凡例ラベルです。
  • 値に応じて自動スケーリング： 値に基づいて色の変化を表示します。
    • カラースケール： 色のパターンの選択肢です。
    • スケールのタイプ： 値を色のバケットに対応付ける計算に使用する数学的なスケールの種類です（線形、対数、平方根など）。データに大きな偏りがある場合は、線形スケーリングよりも対数または平方根のスケーリングが適している場合があります。
    • 最大の下限値： 自動計算されるスケールの下限として許容される最大値です。この下限よりも小さいデータ値がある場合は、それらの値を含むようにスケールが拡張されます。
    • 最小の上限値： 自動計算されるスケールの上限として許容される最小値です。この上限よりも大きいデータ値がある場合は、それらの値を含むようにスケールが拡張されます。
    • 凡例の向き： 凡例の向きを設定できます。横方向または縦方向を選択できます。
  • プロパティ値による色分け： 値に基づいて色が設定されます。値の完全一致または値の範囲に基づいて色を設定できます。
    • 正確な値の一致： 地図上の値が設定した値と完全に一致する場合に色を表示します。
      • 一致する正確な値： 地図上の値がこの値と完全に一致すると、以下で設定した色が表示されます。
      • 色： 地図上の値が上記で設定した値と完全に一致する場合に表示する色です。
      • 凡例ラベル： 地図上の値が上記で設定した値と完全に一致する場合に表示する凡例ラベルです。
      • フォールバック色： 地図上の値が設定したどの値とも一致しない場合に表示する色です。
      • フォールバック凡例： 地図上の値が設定したどの値とも一致しない場合に表示する凡例ラベルです。
    • 範囲値の一致： 地図上の値が設定した値の範囲内にある場合に表示する色です。
      • 最小値： 範囲の下限（この値を含む）です。
      • 最大値： 範囲の上限（この値を含む）です。
      • 色： 地図上の値が設定した値の範囲内にある場合に表示する色です。
      • 凡例ラベル： 地図上の値が上記で設定した範囲内にある場合に表示する凡例ラベルです。
      • フォールバック色： 地図上の値が設定した値の範囲内にない場合に表示する色です。
      • フォールバック凡例： 地図上の値が設定した値の範囲内にない場合に表示する凡例ラベルです。

• 線の境界線スタイル： 線レイヤーに表示される線のスタイル、またはほかの種類のレイヤーの境界線スタイルの設定です。

  • 線/境界線の幅： 線レイヤーに表示される線の幅、またはほかの種類のレイヤーの境界線の幅です。
  • 線/境界線のストロークの種類： 線レイヤーに表示される線のストローク、またはほかの種類のレイヤーの境界線の幅です。
  • 線/境界線の方向を表示： 線の方向を示す矢印を表示します。次のスクリーンショットは、線上に方向が表示されたマップを示しています。
    
    
    
    

• 値フォーマッター： 値を異なる形式で表現できます。たとえば、値をパーセントで表現するには、値フォーマッターに % を設定します。指定する値は d3-format 文字列 ↗にする必要があります。

選択、表示設定、イベントを設定する

選択、表示設定、イベントの設定： の主な設定オプションは次のとおりです。

• レイヤーの Z インデックス： 重なり合うレイヤーの表示順序を制御します。ツールチップの内容と選択のインタラクションは、Z インデックスが高いレイヤーから先に表示されます。
• 単一選択モードを有効化： これを True に切り替えると、複数のオブジェクトを一度に選択できなくなります。次の選択を行うたびに、前の選択が解除されます。
• 初期状態で非表示： これを True に切り替えると、マップの初回読み込み時にレイヤーを非表示にできます。レイヤーがグループの一部である場合は、最初のレイヤーに設定された値が適用されます。
• レイヤーグループ名： レイヤーをグループ化し、凡例のドロップダウンにまとめて表示できます。
• オブジェクトセット選択フィルタ： マップ上で選択を行うと公開されるフィルターです。
• 選択時のイベント： マップ上で選択を行ったときにトリガーされる Workshop イベント（ドロワーを展開するなど）を設定できます。
• 表示条件： Workshop 変数のステータスや値に基づいて、このレイヤーの表示設定を条件付きで制御できます。デフォルトでは、条件が設定されていない場合、レイヤーは常に表示されます。

描画コントロールを設定する

以下のスクリーンショットは、さまざまな図形を表示する設定済みのマップ［レガシー］ウィジェットと、その設定パネルの例です。

描画コントロールの主な設定オプションは次のとおりです。

• 半径/円のコントロール： コントロールを表示に設定すると、半径を表示した円の図形を地図上に描画できます。円を描画するには、左上の円ボタンを選択し、地図上の任意の場所を1回クリックして円の中心を設定し、マウスボタンを離してから、円の中心からマウスを移動します。
  • コントロールボタンのオプション：
    • ツールチップのラベル： 左上の円ボタンにカーソルが置かれたときにラベルを表示します。
    • 無効化： true に設定すると、円ボタンが無効になります。
  • 図形のスタイルオプション：
    • 塗りつぶしの色： 描画した図形の色を設定します。デフォルトの色は #F29D49 で、薄いオレンジ色の16進数コードです。
    • 塗りつぶしの不透明度： 描画した図形の不透明度を 0 から 1 の範囲で設定します。不透明度の最大値は 1 です。
    • 境界線の色： 描画した図形の境界線の色を設定します。デフォルトの色は #F29D49 で、薄いオレンジ色の16進数コードです。
    • 境界線の不透明度： 描画した図形の境界線の不透明度を設定します。
    • 距離の単位： 描画した円の半径を表示する単位です。キロメートル、メートル、マイル、ヤード、フィートを選択できます。
• ポリゴンのコントロール： コントロールを表示に設定すると、地図上にポリゴンの図形を描画できます。ポリゴンを描画するには、まず左上のポリゴンボタンを選択してから、地図上をクリックします。クリックするたびにポリゴンの点が指定され、連続する2点の間に辺が描画されます。
  • コントロールボタンのオプション：
    • ツールチップのラベル： 左上のポリゴンボタンにカーソルが置かれたときにラベルを表示します。
    • 無効化： true に設定すると、ポリゴンボタンが無効になります。
  • 図形のスタイルオプション：
    • 塗りつぶしの色： 描画した図形の色を設定します。デフォルトの色は #F29D49 で、薄いオレンジ色の16進数コードです。
    • 塗りつぶしの不透明度： 描画した図形の不透明度を 0 から 1 の範囲で設定します。不透明度の最大値は 1 です。
    • 境界線の色： 描画した図形の境界線の色を設定します。デフォルトの色は #F29D49 で、薄いオレンジ色の16進数コードです。
    • 境界線の不透明度： 描画した図形の境界線の不透明度を設定します。
    • 距離の単位： キロメートル、メートル、マイル、ヤード、フィートを選択できます。
• 削除コントロール： コントロールを表示に設定すると、地図上に描画した図形を削除できます。描画した図形を削除するには、まず左上の削除ボタンを選択してから、描画した図形をクリックします。
  • コントロールボタンのオプション：
    • ツールチップのラベル： 左上の削除ボタンにマウスカーソルが置かれたときにラベルを表示します。
    • 無効化： true に設定すると、削除ボタンが無効になります。
• 単一描画モード： 有効にすると、地図上に一度に描画できる図形は1個だけになります。新しい図形を描画すると、以前の図形は削除されます。
• 公開されたフィルタ： 描画した図形の境界に基づいて、地図上に表示するオブジェクトセットを絞り込むためのオブジェクトセットフィルター変数を出力します。
• 公開される描画ジオメトリ： このオプションを使用すると、描画した図形のジオメトリを文字列変数に公開できます。これにより、描画した図形のジオメトリを新しいプロパティに書き込めます。
• 描画時のイベント： このオプションは、地図上に図形が描画されたときに、1つ以上の Workshop イベントをトリガーする動作を制御します。

タイムステッパーのコントロールを設定する

マップ［レガシー］ウィジェットにはタイムステッパーが組み込まれており、ユーザーは時間を前後に「ステップ」させて、地図上のデータが時間とともにどのように変化するかを確認できます。

タイムステッパーは、ユーザーが選択した時間ウィンドウに対応するオブジェクトセットフィルターを、設定したオブジェクトセットフィルター変数に公開することで動作します。このフィルター変数を使用して、地図上に表示される1つ以上のレイヤーの元となるオブジェクトセットを絞り込み、その時間ウィンドウに関連するオブジェクトのみを返すことができます。

タイムステッパーを活用するには、使用する時系列オブジェクトに、一定の時間単位ごとの測定値を持つオブジェクトを含めることを推奨します。各オブジェクトには、絞り込みに使用できる日付またはタイムスタンプのプロパティが必要です。これにより、特定の時間ウィンドウで絞り込んで個々のオブジェクトを読み込む（または、そのウィンドウ内のオブジェクトを集計する）ことで、地図上に表示するデータを取得できます。

以下は、タイムステッパーを設定したマップの例です。

以下は、タイムステッパーのコントロールの設定オプションの例です。

タイムステッパーの主な設定オプションは次のとおりです。

• タイムステッパータイプ： このオプションを使用すると、日付またはタイムスタンプに基づいてタイムステッパーを設定できます。
• デフォルトのウィンドウ開始日（タイムスタンプ）： マップ［レガシー］ウィジェットが初めて読み込まれたときのデフォルトの日付（タイムスタンプ）です。
• ウィンドウ開始日の最小値（タイムスタンプ）： ユーザーが選択できる日付（タイムスタンプ）範囲の下限です。
• ウィンドウ開始日の最大値（タイムスタンプ）： ユーザーが選択できる日付（タイムスタンプ）範囲の上限です。
• 予測に関する警告を表示： タイムステッパーが未来の時点を示しているときに表示される情報ボタンのテキストを設定できます。
• 過去のデータに関する警告を表示： タイムステッパーが過去の時点を示しているときに表示される情報ボタンのテキストを設定できます。
• 情報アイコンツールチップのテキスト： ユーザーに情報を伝えるためのツールチップのテキストです。
• 公開済みフィルター： タイムステッパーで選択した日付（タイムスタンプ）範囲に基づいて、地図上に表示するオブジェクトセットを絞り込むためのオブジェクトセットフィルター変数を出力します。
• 小さなステップ： 小さなステップの動作を設定できます。小さなステップをクリックしたときに、時間をどれだけ戻すか、または進めるかを定義します。
• 大きなステップ： 大きなステップの動作を設定できます。大きなステップをクリックしたときに、時間をどれだけ戻すか、または進めるかを定義します。
• ウィンドウサイズ： 開始日からの日付（タイムスタンプ）の範囲を定義します。たとえば、日付ベースのタイムステッパーで開始日が1月1^日、ウィンドウサイズが1日の場合、選択される日付範囲は1月1^日から1月2^日までになります。

ビューポートフィルターのコントロールを設定する

以下のスクリーンショットは、ビューポートフィルターの設定例です。

ビューポートフィルターは、オブジェクトセットフィルター変数を出力します。これにより、ウィジェット内で表示されている地図の境界に基づいて、地図上に表示するオブジェクトセットを絞り込めます。たとえば、空港の位置を表示した地図でユーザーが米国にズームした場合、ビューポートフィルターは、米国の空港のオブジェクトのみを含むようにオブジェクトセットを絞り込めるフィルター変数を生成します。

コロプレスレイヤーでビューポートによる絞り込みを使用するには、地図上に表示するオブジェクトタイプに Geopoint プロパティが必要です。このプロパティには、リージョンの重心を使用できます。