Stylizowanie widoku cech

Styl obiektów w zasobie FeatureView jest określany za pomocą reguł zdefiniowanych w obiekcie w JavaScripcie. Styl można ustawić podczas początkowego definiowania elementu FeatureViewLayer lub w dowolnym momencie później. System stylów umożliwia ustawianie ogólnych reguł stylu, które mają zastosowanie do dużych grup obiektów, a także bardziej szczegółowych reguł dotyczących konkretnych obiektów. Styl obiektu można zdefiniować za pomocą stałych wartości lub na podstawie danych, w zależności od cech obiektu.

Obiekt stylu

Poniżej przedstawiamy podstawową strukturę obiektu stylu. Istnieją 2 typy reguł: reguły ogólne i reguły konkretne. Reguły ogólne wpływają na wszystkie cechy zasobu FeatureView, a reguły szczegółowe – na podzbiór cech.

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

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

Reguły przybliżone

Aby zastosować właściwości stylu do wszystkich obiektów (lub obiektów o określonym typie geometrii), określ właściwości stylu na najwyższym poziomie obiektu stylu.

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

Konkretne reguły

Aby zastosować właściwości stylu do podzbioru obiektów, użyj pola rules. Pole rules akceptuje listę obiektów w JavaScripcie, z których każdy zawiera element filter, który wybiera elementy zgodnie z warunkami zdefiniowanymi przez obiekt ee.Filter, a następnie serię właściwości stylu. W przykładzie poniżej reguła ustawia właściwości polygonStrokeWidth i polygonFillColor tylko wtedy, gdy właściwość „REP_AREA” jest mniejsza niż 100. Reguły szczegółowe zastępują właściwości stylu reguł ogólnych, a reguły znajdujące się na końcu listy rules zastępują te, które znajdują się na początku (reguły szczegółowe są oceniane od pierwszej do ostatniej).

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

Ustaw styl

Styl obiektu można ustawić podczas deklarowania FeatureViewLayer lub w dowolnym momencie później.

FeatureViewLayer deklaracja

Aby ustawić parametry wizualizacji podczas deklarowania obiektu FeatureViewLayer, użyj parametru 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);

Obecne FeatureViewLayer

Aby ustawić parametry wizualizacji dla istniejącego obiektu FeatureViewLayer, użyj funkcji setVisParams. Zastępuje wszystkie wcześniej określone reguły stylu. Nieokreślone właściwości są ustawiane na wartości domyślne.

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

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

Symbology

Dla każdej właściwości stylu możesz określić stałą regułę stylu lub regułę stylu opartą na danych. Opcja oparta na danych wykorzystuje wartości właściwości cech do określania symbolizacji, która może być kategoryczna lub interpolowana. Pełną listę właściwości stylu znajdziesz w tabeli właściwości stylu.

Stała

Reguła stałego stylu składa się z właściwości stylu, którą należy ustawić, i jej wartości. W tym przykładzie kolor wypełnienia wielokąta jest ustawiony na niebieski.

var visParams = {
  polygonFillColor: 'blue'
};

Kategorialna

Reguła stylu kategorialnego składa się z właściwości stylu do ustawienia i obiektu JavaScriptu z 3 właściwościami:

  • property – nazwa właściwości elementu, której wartość będzie wpływać na styl.
  • categories – lista list, które mapują wartości właściwości cech na symbole właściwości stylu. Każda kategoria zawiera wartość właściwości, po której następuje wartość symbolu do zastosowania. Wartość właściwości, która definiuje kategorię, musi być ciągiem znaków.
  • defaultValue – domyślna symbolika, która ma być stosowana do obiektów, których wartość właściwości nie jest zdefiniowana w elemencie categories. Jeśli ma wartość null lub jest niezdefiniowany, zostaną zastosowane domyślne ustawienia stylu.

Na przykład ten obiekt ustawia właściwość stylu color na podstawie właściwości elementu „MARINE”. Elementy w kategorii „MARINE” „0” są ustawione jako fioletowe, „1” jako zielone, „2” jako niebieskie, a wszystkie inne kategorie jako białe.

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

Interpolowane

Reguła stylu interpolowanego składa się z właściwości stylu, którą należy ustawić, oraz obiektu w JavaScripcie z maksymalnie 5 właściwościami:

  • property – nazwa właściwości elementu, której wartość będzie wpływać na styl.
  • mode – tryb interpolacji, 'linear' lub 'interval'.
  • palette – lista kolorów, przezroczystości lub szerokości, między którymi mają być interpolowane wartości właściwości wejściowych. Format zależy od mode. Więcej informacji znajdziesz w sekcjach Liniowy i Interwał.

Dotyczy tylko trybu 'linear'

  • min – wartość właściwości, która ma zostać zmapowana na pierwszy element na liście palette.
  • max – wartość właściwości, która ma zostać zmapowana na ostatni element na liście palette.

Liniowe

Tryb interpolacji liniowej ustawia właściwość stylu obiektu przez liniowe mapowanie wartości wejściowych z zakresu od min do max między listą wartości symboli zdefiniowanych we właściwości palette. Wartości wejściowe są ograniczane do zakresu określonego przez parametry min i max.

Na przykład ten obiekt ustawia właściwość stylu color na podstawie właściwości obiektu „REP_AREA”. Właściwość palette to lista kolorów wskazująca, że wartości wejściowe z zakresu od min do max powinny być stopniowane liniowo od żółtego przez czerwony do niebieskiego. Wartość od 1 do 500 jest interpolowana między żółtym a czerwonym, a wartość od 500 do 1000 – między czerwonym a niebieskim.

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

Interwał

Tryb interpolacji interwałów ustawia właściwość stylu obiektów przez mapowanie wartości wejściowych na przerwy klas, a następnie stosowanie symboli specyficznych dla klasy. Wartości wejściowe z wybranej właściwości cechy są przypisywane do najbliższej wartości granicznej klasy przez zaokrąglenie w dół. Właściwość palette jest sformatowana jako lista list, gdzie każda lista wewnętrzna zawiera wartość przedziału klas, po której następuje wartość właściwości stylu. Elementy, których wartość właściwości jest mniejsza niż minimalna wartość granicy klasy, zachowują domyślne ustawienie właściwości stylu.

W tym przykładzie przezroczystość wypełnienia elementu jest ustawiana zgodnie z klasami stopniowanymi właściwości „REP_AREA”. Definicja klasy i symbole stylu są podane we właściwości palette jako lista list. Wskazuje, że powinny być 4 klasy z przerwami przy wartościach 0, 80, 2000 i 5000, z odpowiednimi przezroczystościami obiektów wynoszącymi 0,5, 0,35, 0,22 i 0,15. Innymi słowy, obiekty z wartościami „REP_AREA” w przedziale $ 0 \le x < 80 $ będą miały przezroczystość wypełnienia równą 0,5, wartości w przedziale $ 80 \le x < 2000 $ będą miały przezroczystość wypełnienia równą 0,35 itd.

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

Wszystkie właściwości stylu

Poniżej znajdziesz wszystkie właściwości stylu, które możesz określić w obiekcie stylu. Ustawienie właściwości stylu dla określonych typów geometrii zastępuje odpowiednie właściwości stylu ustawione dla opcji „Wszystkie geometrie” (np. ustawienie polygonFillColor zastępuje wartość ustawioną w fillColor).

Właściwość Typ Opis Obsługuje regułę interpolowaną
Wszystkie geometrie
isVisible Boolean Określa, czy funkcja jest widoczna. Nie
color String Ustawia kolor wypełnienia/obrysu dla wszystkich typów geometrii. Musi to być wartość szesnastkowa lub kolor CSS3. Tak
opacity Double Ustawia przezroczystość wypełnienia/obrysu dla wszystkich typów geometrii. Wymagana jest liczba zmiennoprzecinkowa podwójnej precyzji od 0 do 1. Tak
width Double Ustawia szerokość obrysu dla wszystkich typów geometrii. Tak
fillColor String Ustawia kolor wypełnienia dla wszystkich typów geometrii. Musi to być wartość szesnastkowa lub kolor CSS3. Tak
Geometrie punktowe
pointShape String Ustawia kształt geometrii punktów. Obsługuje te same kształty co ee.FeatureCollection.style (circle, square, diamond, cross, plus, pentagram, hexagram, triangle, triangle_up, triangle_down, triangle_left, triangle_right, pentagon, hexagon, star5, star6). Nie
pointSize Double Ustawia szerokość geometrii punktów (w pikselach). Tak
pointFillColor String Ustawia kolor wypełnienia geometrii punktów. Musi to być wartość szesnastkowa lub kolor CSS3. Tak
pointFillOpacity Double Ustawia przezroczystość wypełnienia geometrii punktów. Musi być liczbą zmiennoprzecinkową podwójnej precyzji z zakresu od 0 do 1. Tak
Geometrie linii
lineType String Ustawia typ linii. Obsługuje te same typy co ee.FeatureCollection.style (linia ciągła, przerywana, kropkowana). Nie
lineWidth Double Ustawia szerokość linii (w pikselach). Tak
lineColor String Ustawia kolor geometrii linii. Musi to być wartość szesnastkowa lub kolor CSS3. Tak
lineOpacity Double Ustawia nieprzezroczystość geometrii linii. Wymagana jest liczba zmiennoprzecinkowa podwójnej precyzji od 0 do 1. Tak
Geometrie wielokątów
polygonStrokeWidth Double Ustawia szerokość obrysu wielokątów (w pikselach). Tak
polygonStrokeType String Ustawia typ linii dla wielokątów. Obsługuje te same typy co ee.FeatureCollection.style (linia ciągła, przerywana, kropkowana). Nie
polygonStrokeColor String Ustawia kolor obrysu geometrii wielokątów. Musi to być wartość szesnastkowa lub kolor CSS3. Tak
polygonStrokeOpacity Double Ustawia przezroczystość obrysu dla geometrii wielokątów. Musi być liczbą zmiennoprzecinkową podwójnej precyzji z zakresu od 0 do 1. Tak
polygonFillColor String Ustawia kolor wypełnienia geometrii wielokątów. Musi to być wartość szesnastkowa lub kolor CSS3. Tak
polygonFillOpacity Double Ustawia nieprzezroczystość wypełnienia geometrii wielokątów. Musi być liczbą zmiennoprzecinkową podwójnej precyzji z zakresu od 0 do 1. Tak