マップボード

概要

Contour の マップボード では、ユーザーの地理空間データを視覚化し、操作することができます。

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

• ベースレイヤー（タイルレイヤーとも呼ばれます）、これは背景の地図画像を提供し、
• オーバーレイレイヤー、これはデータをベースレイヤーの上に点または形状として表現します。

マップボードは MapboxGL によるマップレンダリングをサポートしています。ユーザーのブラウザーが WebGL をサポートしていない場合、マップボードは Leaflet でレンダリングされます。

マップボードはベースマップ画像の主要なソースとして Mapbox を使用しています。Web マップ技術について詳しく知るには、Mapbox のドキュメンテーションを参照してください。

オーバーレイレイヤーの種類

マップボードでは、オーバーレイレイヤー（インターフェースでは「レイヤー」と呼ばれます）は、地図のベースレイヤーの上にデータを点または形状として表現します。マップボードには以下の種類のオーバーレイレイヤーが含まれています：

• ポイント
• クラスタ
• コロプレス
• ラインセグメント

現在、静的レイヤー（Workshop のマップで一般的に使用される）はマップボードではサポートされていません。

ポイント

ポイントレイヤーは、地図上の個々のオブジェクトを緯度/経度のペアでプロットした点またはマーカーを使用します。ポイントの色、アイコンタイプ、サイズはスタイル化できます。

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

例：部屋のタイプによって色分けされたマンハッタンのローワー・イースト・サイド地区のAirbnbの場所を示す地図。この地図は、Inside Airbnbからのオープンソースデータを使用しています。

クラスタ

クラスタレイヤーは、緯度/経度のペアを含む大量のデータセットに理想的です。クラスターはポイントと似ていますが、オブジェクトごとに1つのマーカーをプロットするのではなく、プロットされるオブジェクトが地理的な近接性に基づいてクラスターに集約されます。クラスターのサイズや色は、特定のエリア内のデータポイントの数を表すように設定可能です。

データポイントの数（これはカウント集約です）に加えて、クラスタレイヤーは、データセット内の別の行の合計や平均など、さまざまな集約関数をサポートしています。

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

例：マンハッタンの Airbnb の価格分布を示す地図。クラスタのサイズ/色は、指定エリア内の平均価格に基づいています。

コロプレス

コロプレスレイヤーは、その地域を表す行の行値や行値の集計に基づいて色分けされた地域（国や州など）を表示します。これにより、異なる地域間での変動やパターンを視覚化する方法が提供され、時間経過によるこれらの値の変化を見るオプションがあります。

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

例：各州が2021年12月13日時点で完全にワクチン接種された人口の割合によって色分けされた、アメリカ合衆国本土の地図。

ラインセグメント

ラインセグメントレイヤーは、個々の行を2つのポイントをつなぐラインセグメントとしてプロットします。ポイントは緯度/経度のペアで定義されます。

設定情報については、以下の ラインセグメントレイヤーの設定を参照してください。

例：各州の中心から始まりカリフォルニアで終わるラインセグメントがあるアメリカ合衆国の地図。ラインセグメントは、カリフォルニアからの距離によって色分けされています。

設定

以下は、新しく追加され、まだ設定されていない マップボード の画像です。デフォルトでは、データソースが 現在のセット として設定されたポイントレイヤーがボードに追加されます。

設定パネルの上部には、Data と Format のタブがあります。

• Data タブでは、前のセクションで説明したマップの オーバーレイレイヤー を追加し、設定することができます。
• Format タブでは、マップの ベースレイヤー を設定することができます。また、マップの一般的なフォーマットオプション（例えば、マップ内の凡例の位置）も設定できます。

Data タブ

Data タブには、上部に レイヤーを追加 ボタンがあり、マップに表示される各オーバーレイレイヤーのための折りたたみ可能なセクションが含まれています。

セクションの上部にある レイヤーを追加 ボタンをクリックすると、新しいレイヤー（デフォルトではポイントレイヤー）がマップに追加され、他のすべてのセクションが折りたたまれます。

Data source は、レイヤーがデータを表示し、集計を計算するために使用するデータセットまたは Contour パスを表します。デフォルトでは、このオプションには 現在のセット が選択されており、現在の Contour パスからのデータが使用されます。

データソースの他のオプションには、同じ分析内の他のパス、または別の Foundry データセットが含まれます。

Map Type を変更して、異なるタイプのレイヤーを設定することができます。これらのレイヤーの異なるオプションは、ポイント、クラスタ、コロプレス、ラインセグメントであり、上記で説明されています。

#### ポイントレイヤーの設定 ポイントレイヤーの主な設定オプションは以下の通りです。

• 位置: 緯度と経度の行を選択し、データソースの各行の位置を示します。
• ポイントスタイリング: 各ポイントのアイコンタイプ、色、サイズを設定します：
  • アイコンタイプ: 利用可能なアイコンタイプのドロップダウンセレクターで、テキスト検索でフィルター処理することができます。
  • 色: 「単一色」と「値による色」の選択肢があります。
    • 単一色: レイヤーの全てのポイントを均一に色付けする色のドロップダウンセレクターを提供します。
    • 値による色: 行のセレクターを提供します。各ポイントは、選択した行に含まれる値に基づいて色が割り当てられます。
  • サイズ: 利用可能なサイズ：小、中、大、特大のドロップダウンセレクターです。
  • ツールチップ: ユーザーがツールチップラベルを含む行を追加できる行のセレクターです。これらのラベルは、地図上のポイントにホバーするとツールチップに表示されます。

クラスターレイヤーの設定

クラスターレイヤーの主な設定オプションは以下の通りです：

• 位置: 緯度と経度の行を選択し、データソースの各行の位置を示します。
• 集約: 値を含む行とその行に基づく集約タイプを選択します。この集約の結果は、クラスターのサイズ/色を決定するのに使用されます。
• クラスタースタイリング: クラスターのサイズスケーリング、色、および不透明度を設定します：
  • サイズスケーリング: 地図上のクラスターが集約の結果に応じてどのようにスケールするかを説明します。オプションは線形、対数、平方根です。
  • 色: 「単一色」と「スケーリング色」の選択肢があります：
    • 単一色: レイヤーの全てのクラスターを均一に色付けする色のドロップダウンセレクターを提供します。
    • スケーリング色: 「色スケール」と「スケールタイプ」のセレクターを提供します。色スケールとスケールタイプは、各クラスターの値に応じてクラスターをグラデーションで色付けするために使用されます。
  • 不透明度: レイヤー上のクラスターの塗りつぶしの不透明度を設定するスライダーです。スケールは0（完全に透明）から1（完全に不透明）です。

コロプレスレイヤーの設定

コロプレスレイヤーを設定するには、まずコロプレスタイプを指定する必要があります。これは、表示される領域を定義する境界のソースに対応します。現在、マップボードは以下のコロプレスタイプをサポートしています：

• Mapbox: 世界中の一般的な領域（例えば、国、州、県など）を表示することに興味がある場合、コロプレスを設定する最も簡単な方法です。このオプションは、Mapbox enterprise boundary setsの使用を活用します。まず、Foundry インスタンスに Mapbox boundary datasets をインストールします。
• GeoJSON: GeoJSON を介して定義されたシンプルな、カスタム領域がある場合、または環境から Mapbox APIs にアクセスできない場合（ネットワーク制限など）に有用なオプションです。このオプションは、GeoJSON形式のデータを活用します。

レイヤー自体の設定オプションは、選択されたコロプレスタイプに基づいて異なります：

• Mapbox:
  • コロプレス地域タイプ: 境界タイプとデータレベルを選択します。Mapbox Boundaries データは、境界が果たす機能に基づいて五つの大きなタイプに分類されています：admin、legislative、locality、postal、stats。各境界タイプ内の特徴は、異なる番号のレベルの階層に組織されています。一般的に、大きな番号のレベルは、小さな番号のレベルの下にネストされます。たとえば、アメリカでは、郡（admin レベル 2）は州（admin レベル 1）の下位区分であり、州は国（admin レベル 0）の下位区分です。
    • レイヤーの地域 ID 行は、選択した境界レベルに対応する必要がある Mapbox feature IDs と一致しなければなりません。これらの feature ID 値のマッピングは、すでにプラットフォーム上に存在するはずのインポートされたデータセットを通じて利用可能です。これらのマッピングの場所がわからない場合は、サポートに連絡してください。
  • Worldview: この機能は、境界の複数のバージョンが存在する場合に、異なる視聴者に向けてマップの境界をレンダリングします。現在、利用可能なオプションはアメリカ、日本、インド、中国です。
  • 集約: 値を含む行とその行に基づく集約タイプを選択します。この集約の結果は、コロプレス地域上にホバーすると表示されるツールチップに表示されます。また、色スケール 色付けオプションを使用する際に利用されます。
  • GeoJSON:
    • GeoJSON geometry 行: GeoJSON 形式のデータを含む行の選択を許可します。データによって指定された形状が各レイヤーのマップに表示されます。これにより、Mapbox がサポートしていない可能性のあるカスタム形状が可能になりますが、集約や選択は許可されません。

また、コロプレスレイヤーは、色の設定の異なるタイプをサポートしています：

• 単一色: レイヤーの全ての形状を均一に色付けする色のドロップダウンセレクターを提供します。
• スケーリング色: 「色スケール」および「スケールタイプ」のセレクターを提供します。色スケールとスケールタイプは、各地域の値に応じて地域をグラデーションで色付けするために使用されます。
  • Mapbox コロプレスでは、各地域の値は集約の結果によって決まります。
  • GeoJSON コロプレスでは、各地域の値は、ユーザーがこのオプションを選択するときに提供しなければならない行によって決まります。
• 値による色: 行のセレクターを提供します。各地域は、選択した行に含まれる値に基づいて色が割り当てられます。
  • このオプションは GeoJSON コロプレスレイヤーでのみ利用可能です。
• カスタムバケット: 値の範囲に基づいて色を割り当てるためのフォームを提供します。カスタムバケットを設定するには、色、ラベル（オプション）、最小値を選択します。各バケットは、集約値がバケットの最小値と隣接するバケットの最小値の間にあるコロプレス地域を包含します。
  • このオプションは Mapbox コロプレスレイヤーでのみ利用可能です。

ラインセグメントレイヤーの設定

ラインセグメントレイヤーを設定するには、まずラインセグメントタイプを指定する必要があります。これは、ラインレイヤー上にラインを描く方法を指定します。現在、マップボードは以下のオプションをサポートしています：

• ポイントからポイント: 入力データセットの各行に対して、提供された開始点と終了点の間に直線を描きます。
  • このオプションを選択すると、ユーザーは以下の四つの行を提供する必要があります：
    • 開始緯度
    • 開始経度
    • 終了緯度
    • 終了経度
• GeoJSON ソース: 入力データセットの各行に対して、指定した行に含まれる GeoJSON 形状によってラインを描きます。このオプションでは、マップ上により複雑なラインを描くことができますが、そのようなレイヤーに対しては選択は利用できません。
  • このオプションを選択すると、ユーザーはGeoJSON feature 行に対応する行を提供する必要があります。これは、GeoJSON 形状を含む行です。

また、ラインセグメントレイヤーは、色の設定の異なるタイプをサポートしています：

• 単一色: レイヤーの全てのラインを均一に色付けする色のドロップダウンセレクターを提供します。
• スケーリング色: 「値の行」、「色スケール」、および「スケールタイプ」のセレクターを提供します。色スケールとスケールタイプは、各ラインの値に応じてラインをグラデーションで色付けするために使用されます。値は、ユーザーが提供する値の行を使用して決定されます。
• 値による色: 行のセレクターを提供します。各ラインは、選択した行に含まれる値に基づいて色が割り当てられます。

フォーマットタブ

フォーマットタブには、マップの一般的なフォーマット情報が含まれています。

マップテーマ: マップの基本レイヤーのスタイルに対応します。これらのオプションは Mapbox によって提供されています。デフォルトのマップテーマはライトテーマです。他のオプションには以下のものがあります：

• ダーク
• サテライト
• ベーシック
• ブライト
• アウトドア
• サテライトストリート
• ストリート

ビューポート: マップを初期にロードするとき、またはマップのポイントを再レンダリングする更新が行われたときのマップのビューポートを指定します。

• フィットにズーム: マップのビューポートは、マップ上の現在のデータに自動的にフィットするようにズームします。
• 初期ビューポート: 緯度、経度、ズームレベルを手動で設定することができます。また、これらの値をマップの現在のビューポートに自動的に設定するオプションもあります。

レジェンド: マップレジェンドのオプションを指定します。

• 位置: レジェンドがマップ上で表示される位置。
• 方向: レジェンドが水平に展開するか垂直に展開するかを指定します。
• レジェンドを表示: このオプションを切り替えると、ユーザーにレジェンドを表示/非表示にします。
• レイヤーの可視性の切り替えを許可: 有効にすると、レジェンド上の各レイヤーに目のアイコンが表示されます。このアイコンをクリックすると、ユーザーは個々のレイヤーを一時的に非表示にすることができます。

マップのフィルタリングと描画

フィルタリング

マップボードは、レイヤーによって異なる多くのフィルタリングオプションをサポートしています。フィルタリングは、データソースオプションが現在のセットに設定されている場合にのみ有効になります。マップ上の複数のフィルターは統合され（OR フィルター）ます。

ポイントレイヤーのフィルタリング

• 個々のポイントをクリックすると、選択したポイントの緯度と経度に対応するフィルターが追加されます。フィルターは、設定で選択された緯度と経度の行に適用されます。レイヤーごとに最大30の選択が許可されます。
• ラジアルフィルターを描く（マップ描画セクションを参照）と、設定で選択された緯度と経度の行に対応するラジアルフィルターが作成されます。
• 同様に、ポリゴンフィルターを描くと、設定で選択された緯度と経度の行に対応するポリゴンフィルターが作成されます。

例：マップ上に描かれたポイント選択とラジアルフィルター。対応するフィルターは「行を保持する場所（緯度 = 40.80826 および経度 = -73.93401）または緯度、経度が 40.8081, -73.94189 の 0.2969 km 以内である」です。最初のフィルターはポイント選択に対応し、2つ目のフィルターはラジアルフィルターに対応しています。

クラスターレイヤーのフィルター処理

現在、クラスターレイヤーでのフィルター処理はサポートされていません。

Choroplethレイヤーのフィルター処理

• Mapbox: 地域をクリックすると、選択した地域の値に基づいてRegion ID行でフィルター処理されます。レイヤーごとに選択できる地域は最大30です。
• GeoJSON: 現在、GeoJSONのchoroplethsではフィルター処理がサポートされていません。

例: Mapboxのchoroplethレイヤーで選択を行った。選択によりフィルターが作成され、その内容は「feature_id = 332521の行を保持する」となっている。feature_idは「Region ID行」として提供された行で、332521は選択した形状（カリフォルニア）に対応するMapboxの機能IDである。

ラインセグメントレイヤーのフィルター処理

• Point to point: ラインをクリックすると、開始緯度、開始経度、終了緯度、終了経度の行でフィルター処理が行われます。レイヤーごとに選択できるラインは最大30です。
• GeoJSON: 現在、GeoJSONのラインセグメントレイヤーではフィルター処理がサポートされていません。

例: ラインセグメントレイヤーで選択を行った。選択によりフィルターが作成され、その内容は「(Latitude = 38.5 AND end_Latitude = 36.778259 AND Longitude = -98 AND end_Longitude = -119.417931)の行を保持する」である。

地図の描画

地図ボードは地図上に形状を描画することをサポートしています。これらは、マウスカーソルを地図の上に置くと表示される地図の左上隅のボタンからアクセスできます。

以下のオプションが描画に対応しています:

• 円形フィルターの追加: 地図上に円を描画することができ、これによりボード内のすべてのポイントレイヤーに対して、Data sourceがcurrent setに設定されている場合に円形フィルターが作成されます。フィルターを描画するには以下の手順を守ってください:
  1. ボタンをクリックします。
  2. 次に、地図上の任意の場所をクリックして円の中心を指定します。カーソルを中心点から離す/近づけると、円の半径が増え/減ります。
  3. 最後に、地図を再度クリックして円の描画を終えます。

• 多角形フィルターの追加: 地図上に多角形を描画することができ、これによりボード内のすべてのポイントレイヤーに対して、Data sourceがcurrent setに設定されている場合に多角形フィルターが作成されます。フィルターを描画するには以下の手順を守ってください:
  1. ボタンをクリックします。
  2. 次に、地図上の任意の場所をクリックして多角形の最初の頂点を指定します。地図上でのその後のクリックにより、多角形の他の頂点が順番に指定されます。
  3. 最後に、最初のポイントをクリックして多角形の描画を終えます。

• ラインの描画: 地図上にラインを描画することができます。ラインは表示のみの目的であり、地図上でフィルターを作成することはありません。ラインを描画するには以下の手順を守ってください:

  1. ボタンをクリックします。
  2. 次に、地図上の任意の場所をクリックしてラインの開始点を指定します。その後のクリックで追加のラインセグメントが作成されます。
  3. 最後に、最近追加されたセグメントを再度クリックして描画を完了します。

• 描画した形状の削除: ユーザーが地図上の描画した形状を削除することを可能にします。円を削除する場合、対応するフィルターも削除されます。形状を削除するには以下の手順を守ってください:

  1. xアイコンのボタンをクリックします。
  2. 削除したい形状をマウスオーバーします。形状が赤くなるはずです。
  3. マウスオーバーした形状をクリックして削除します。
  4. 最後に、ボタンを再度クリックして形状の削除を終えます。