FeatureView のスタイルを設定する

FeatureView アセット内の対象物のスタイルは、JavaScript オブジェクトで定義されたルールを使用して指定します。スタイルは、FeatureViewLayer の初期定義時またはそれ以降に設定できます。スタイル設定システムでは、対象物の大規模なグループに適用される広範なスタイルルールを設定できるだけでなく、特定の対象物に対してより具体的なルールを設定することもできます。対象物のスタイルは、定数値またはデータドリブンで、対象物の特性に基づいて定義できます。

スタイル オブジェクト

スタイル オブジェクトの基本的な構造は次のとおりです。ルールには、広範なルールと特定のルールの 2 種類があります。広範なルールは FeatureView アセット内のすべての特徴に影響しますが、特定のルールは特徴のサブセットに影響します。

{
  // Broad style rules.
  opacity: …,
  polygonFillColor: …,

  // Specific style rules.
  rules: [
    { … },
    { … }
  ]
};

Broad ルール

すべての対象物(または特定のジオメトリ タイプの対象物)にスタイル プロパティを適用するには、スタイル オブジェクトの最上位でスタイル プロパティを指定します。

{
  opacity: 0.5,
  pointShape: 'triangle',
  lineWidth: 10,
  polygonFillColor: 'green'
};

固有のルール

対象物のサブセットにスタイル プロパティを適用するには、rules フィールドを使用します。rules フィールドは JavaScript オブジェクトのリストを受け入れます。各オブジェクトには、ee.Filter オブジェクトで定義された条件に従って対象物を選択する filter と、一連のスタイル プロパティが含まれます。次の例では、「REP_AREA」プロパティが 100 未満の場合にのみ polygonStrokeWidth と polygonFillColor を設定するルールがあります。具体的なルールは、広範なルールのスタイル プロパティをオーバーライドします。また、rules リストの末尾に近いルールは、先頭に近いルールをオーバーライドします(具体的なルールは、最初から最後まで評価されます)。

{
  rules: [
    {
      filter: ee.Filter.lt('REP_AREA', 100),
      polygonStrokeWidth: 0.5,
      polygonFillColor: 'blue'
    },
    { … }  // Optionally include additional rules.
  ]
};

スタイルを設定する

対象物のスタイルは、FeatureViewLayer の宣言時またはそれ以降に設定できます。

FeatureViewLayer 件の申告

FeatureViewLayer を宣言するときに可視化パラメータを設定するには、visParams パラメータを使用します。

var visParams = {
  opacity: 0.5,
  lineWidth: 10,
  polygonFillColor: 'purple'
};

var layer = ui.Map.FeatureViewLayer({
  assetId: 'WCMC/WDPA/current/polygons_FeatureView',
  visParams: visParams
});

Map.add(layer);

既存のFeatureViewLayer

既存の FeatureViewLayer の可視化パラメータを設定するには、setVisParams 関数を使用します。以前に指定されたスタイルルールはすべて置き換えられます。指定されていないプロパティはデフォルトに設定されます。

var layer = ui.Map.FeatureViewLayer('WCMC/WDPA/current/polygons_FeatureView');
Map.add(layer);

layer.setVisParams({
  opacity: 0.5,
  lineWidth: 10,
  polygonFillColor: 'purple'
});

シンボロジー

スタイル プロパティごとに、定数スタイルルールまたはデータドリブン スタイル設定ルールを指定できます。データドリブン オプションでは、特徴プロパティ値を使用してシンボル化を決定します。これは、カテゴリまたは補間のいずれかになります。スタイル プロパティの一覧については、スタイル プロパティの表をご覧ください。

定数

定数スタイルルールは、設定するスタイル プロパティとその値で構成されます。次の例では、ポリゴンの塗りつぶしの色を青に設定しています。

var visParams = {
  polygonFillColor: 'blue'
};

カテゴリ

カテゴリ スタイルルールは、設定するスタイル プロパティと、次の 3 つのプロパティを持つ JavaScript オブジェクトで構成されます。

  • property - スタイルに影響する値を持つ対象物プロパティの名前。
  • categories - 地図上の対象物のプロパティ値をスタイル プロパティのシンボルにマッピングするリストのリスト。各カテゴリには、プロパティ値と、それに続く適用するシンボル値が含まれます。カテゴリを定義するプロパティ値は文字列にする必要があります。
  • defaultValue - categories でプロパティ値が定義されていない対象物に適用するデフォルトのシンボル。null または未定義の場合、デフォルトのスタイル設定が適用されます。

たとえば、次のオブジェクトは、"MARINE" フィーチャー プロパティに基づいて color スタイル プロパティを設定します。「MARINE」カテゴリ「0」の対象物は紫、「1」は緑、「2」は青、その他のカテゴリは白に設定されます。

var visParams = {
  color: {
    property: 'MARINE',
    categories: [
      ['0', 'purple'],
      ['1', 'green'],
      ['2', 'blue']
    ],
    defaultValue: 'white'
  }
};

補間

補間スタイルルールは、設定するスタイル プロパティと、最大 5 つのプロパティを持つ JavaScript オブジェクトで構成されます。

  • property - スタイルに影響する値を持つ対象物プロパティの名前。
  • mode - 補間モード('linear' または 'interval')。
  • palette - 入力プロパティ値を補間する色、不透明度、幅のリスト。形式は mode によって異なります。詳細については、線形とインターバルのセクションをご覧ください。

'linear' モードにのみ適用

  • min - palette リストの最初の要素にマッピングするプロパティ値。
  • max - palette リストの最後の要素にマッピングするプロパティ値。

線形

線形補間モードでは、palette プロパティで定義されたシンボル値のリスト間で、min~max の範囲の入力値を線形にマッピングすることで、対象物スタイル プロパティを設定します。入力値は、min と max で設定された範囲にクランプされます。

たとえば、次のオブジェクトは、「REP_AREA」対象物プロパティに基づいて color スタイル プロパティを設定します。palette プロパティは、min~max の入力値が黄色から赤、青へと線形にグラデーションされることを示す色のリストです。1 ~ 500 の値は黄色と赤の間で補間され、500 ~ 1, 000 の値は赤と青の間で補間されます。

var visParams = {
  color: {
    property: 'REP_AREA',
    mode: 'linear',
    palette: ['yellow', 'red', 'blue'],
    min: 1,
    max: 1000
  }
};

間隔

インターバル補間モードでは、入力値をクラスブレークにマッピングし、クラス固有のシンボルを適用することで、対象物スタイル プロパティを設定します。選択した特徴プロパティの入力値は、切り捨てによって最も近いクラスブレーク値に割り当てられます。palette プロパティはリストのリストとしてフォーマットされます。各内部リストには、クラスブレーク値と、それに続くスタイル プロパティ値が含まれます。プロパティ値が最小のクラスブレーク値より小さい対象物は、デフォルトのスタイル プロパティ設定を維持します。

次の例では、"REP_AREA" プロパティの段階的なクラスに応じて、対象物の塗りつぶしの不透明度が設定されています。クラス定義とスタイル シンボルは、palette プロパティにリストのリストとして指定されます。これは、値 0、80、2000、5000 で区切られた 4 つのクラスがあり、それぞれの特徴の不透明度が 0.5、0.35、0.22、0.15 であることを示します。つまり、「REP_AREA」の値が $ 0 \le x < 80 $ の範囲にある対象物は塗りつぶしの不透明度が 0.5 になり、$ 80 \le x < 2000 $ の範囲にある対象物は塗りつぶしの不透明度が 0.35 になります。

var visParams = {
  fillOpacity: {
    property: 'REP_AREA',
    mode: 'interval',
    palette: [
      [0, 0.5],
      [80, 0.35],
      [2000, 0.22],
      [5000, 0.15]
    ]
  }
};

すべてのスタイル プロパティ

スタイル オブジェクトで指定できるスタイル プロパティは次のとおりです。特定のジオメトリ タイプにスタイル プロパティを設定すると、[すべてのジオメトリ] に設定されている対応するスタイル プロパティがオーバーライドされます(たとえば、polygonFillColor を設定すると、fillColor に設定されている値がオーバーライドされます)。

プロパティ タイプ 説明 補間ルールをサポート
すべてのジオメトリ
isVisible Boolean 対象物を表示するかどうかを設定します。 いいえ
color String すべてのジオメトリ タイプの塗りつぶし / ストロークの色を設定します。16 進数値または CSS3 の色にする必要があります。 ○
opacity Double すべてのジオメトリ タイプの塗りつぶし / ストロークの不透明度を設定します。 0 ~ 1 の倍精度浮動小数点数にしてください。 ○
width Double すべてのジオメトリ タイプのストローク幅を設定します。 ○
fillColor String すべてのジオメトリ タイプの塗りつぶしの色を設定します。16 進数値または CSS3 の色にする必要があります。 ○
ポイント ジオメトリ
pointShape String ポイント ジオメトリの形状を設定します。ee.FeatureCollection.style と同じ形状(circle、square、diamond、cross、plus、pentagram、hexagram、triangle、triangle_up、triangle_down、triangle_left、triangle_right、pentagon、hexagon、star5、star6)をサポートします。 いいえ
pointSize Double ポイント ジオメトリの幅をピクセル単位で設定します。 ○
pointFillColor String ポイント ジオメトリの塗りつぶしの色を設定します。16 進数値または CSS3 の色にする必要があります。 ○
pointFillOpacity Double ポイント ジオメトリの塗りつぶしの不透明度を設定します。0 ~ 1 の倍精度浮動小数点数にする必要があります。 ○
ライン ジオメトリ
lineType String 線の種類を設定します。ee.FeatureCollection.style と同じタイプ(実線、破線、点線)をサポートします。 いいえ
lineWidth Double 線の幅をピクセル単位で設定します。 ○
lineColor String ライン ジオメトリの色を設定します。16 進数値または CSS3 の色にする必要があります。 ○
lineOpacity Double ライン ジオメトリの不透明度を設定します。0 ~ 1 の倍精度浮動小数点数にしてください。 ○
ポリゴン ジオメトリ
polygonStrokeWidth Double ポリゴンのストローク幅を設定します(ピクセル単位)。 ○
polygonStrokeType String ポリゴンの線の種類を設定します。ee.FeatureCollection.style と同じタイプ(実線、破線、点線)をサポートします。 いいえ
polygonStrokeColor String ポリゴン ジオメトリのストロークの色を設定します。16 進数値または CSS3 の色にする必要があります。 ○
polygonStrokeOpacity Double ポリゴン ジオメトリのストロークの不透明度を設定します。0 ~ 1 の double 値にする必要があります。 ○
polygonFillColor String ポリゴン ジオメトリの塗りつぶしの色を設定します。16 進数値または CSS3 の色にする必要があります。 ○
polygonFillOpacity Double ポリゴン ジオメトリの塗りつぶしの不透明度を設定します。0 ~ 1 の double 値にする必要があります。 ○