Estilizar uma FeatureView

O estilo dos elementos em um recurso FeatureView é especificado usando regras definidas em um objeto JavaScript. O estilo pode ser definido durante a definição inicial de um FeatureViewLayer ou a qualquer momento depois. O sistema de estilo permite definir regras de estilo amplas que se aplicam a grandes grupos de elementos, bem como regras mais específicas para elementos específicos. O estilo do elemento pode ser definido por valores constantes ou orientado por dados, com base nas características do elemento.

Objeto de estilo

A estrutura básica de um objeto de estilo é mostrada abaixo. Há dois tipos de regras: amplas e específicas. As regras amplas afetam todos os recursos em um recurso FeatureView, enquanto as regras específicas afetam um subconjunto de recursos.

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

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

Regras amplas

Para aplicar propriedades de estilo a todos os elementos (ou àqueles de um tipo de geometria específico), especifique as propriedades de estilo no nível superior do objeto de estilo.

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

Regras específicas

Para aplicar propriedades de estilo a um subconjunto de elementos, use o campo rules. O campo rules aceita uma lista de objetos JavaScript, cada um com um filter que seleciona recursos de acordo com as condições definidas por um objeto ee.Filter, seguido por uma série de propriedades de estilo. No exemplo abaixo, há uma regra que define polygonStrokeWidth e polygonFillColor somente se a propriedade "REP_AREA" for menor que 100. As regras específicas substituem as propriedades de estilo das regras amplas, e as regras próximas ao final da lista rules substituem as que estão próximas ao início (as regras específicas são avaliadas da primeira à última).

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

Definir estilo

O estilo do elemento pode ser definido quando um FeatureViewLayer é declarado ou a qualquer momento depois disso.

FeatureViewLayer declaração

Para definir os parâmetros de visualização ao declarar um FeatureViewLayer, use o parâmetro 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 atuais

Para definir os parâmetros de visualização de um FeatureViewLayer, use a função setVisParams. Ela substitui todas as regras de estilo especificadas anteriormente. As propriedades não especificadas são definidas como padrão.

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

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

Simbologia

Para cada propriedade de estilo, é possível especificar uma regra de estilo constante ou uma regra de estilo baseada em dados. A opção baseada em dados usa valores de propriedade de elementos para determinar a simbolização, que pode ser categórica ou interpolada. Para uma lista completa das propriedades de estilo, consulte a tabela de propriedades de estilo.

Constante

Uma regra de estilo constante consiste em uma propriedade de estilo a ser definida e o valor dela. O exemplo a seguir define a cor de preenchimento do polígono como azul.

var visParams = {
  polygonFillColor: 'blue'
};

Categórico

Uma regra de estilo categórica consiste em uma propriedade de estilo a ser definida e um objeto JavaScript com três propriedades:

  • property: um nome de propriedade de elemento cujo valor vai afetar o estilo.
  • categories: uma lista de listas que mapeiam valores de propriedade de elementos para simbologias de propriedade de estilo. Cada categoria inclui um valor de propriedade seguido por um valor de simbologia a ser aplicado. O valor da propriedade que define uma categoria precisa ser uma string.
  • defaultValue: uma simbologia padrão a ser aplicada a elementos com valor de propriedade não definido em categories. Se for nulo/indefinido, as configurações de estilo padrão serão aplicadas.

Por exemplo, o objeto a seguir define a propriedade de estilo color com base na propriedade de elemento "MARINE". Os elementos na categoria "MARINE" "0" são definidos como roxo, "1" como verde, "2" como azul e qualquer outra categoria como branco.

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

Interpolado

Uma regra de estilo interpolada consiste em uma propriedade de estilo a ser definida e um objeto JavaScript com até cinco propriedades:

  • property: um nome de propriedade de elemento cujo valor vai afetar o estilo.
  • mode: o modo de interpolação, 'linear' ou 'interval'.
  • palette: uma lista de cores, opacidades ou larguras para interpolar os valores de propriedade de entrada. O formato depende do mode. Consulte as seções Linear e Intervalo para mais detalhes.

Aplicável apenas ao modo 'linear'

  • min: o valor da propriedade a ser mapeado para o primeiro elemento na lista palette.
  • max: o valor da propriedade a ser mapeado para o último elemento na lista palette.

Linear

O modo de interpolação linear define uma propriedade de estilo de elemento mapeando valores de entrada no intervalo de min a max de forma linear entre uma lista de valores de simbologia definidos na propriedade palette. Os valores de entrada são fixados no intervalo definido por min e max.

Por exemplo, o objeto a seguir define a propriedade de estilo color com base na propriedade de elemento "REP_AREA". A propriedade palette é uma lista de cores que indica que os valores de entrada entre min e max precisam ser classificados linearmente de amarelo para vermelho e para azul. Um valor entre 1 e 500 é interpolado entre amarelo e vermelho, e um valor entre 500 e 1.000 é interpolado entre vermelho e azul.

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

Intervalo

O modo de interpolação de intervalo define uma propriedade de estilo de elemento mapeando valores de entrada para quebras de classe e aplicando uma simbologia específica da classe. Os valores de entrada da propriedade do elemento selecionado são atribuídos ao valor de quebra de classe mais próximo por arredondamento para baixo. A propriedade palette é formatada como uma lista de listas, em que cada lista interna contém um valor de intervalo de classe seguido por um valor de propriedade de estilo. Os recursos com valor de propriedade menor que o valor mínimo de quebra de classe mantêm a configuração padrão da propriedade de estilo.

No exemplo a seguir, a opacidade de preenchimento do elemento é definida de acordo com as classes graduadas da propriedade "REP_AREA". A definição de classe e a simbologia de estilo são fornecidas na propriedade palette como uma lista de listas. Ele indica que deve haver quatro classes com quebras nos valores 0, 80, 2.000 e 5.000, com as respectivas opacidades de elementos de 0,5, 0,35, 0,22 e 0,15. Em outras palavras, os elementos com valores "REP_AREA" no intervalo $ 0 \le x < 80 $ terão uma opacidade de preenchimento de 0,5, os valores no intervalo $ 80 \le x < 2000 $ terão uma opacidade de preenchimento de 0,35 e assim por diante.

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

Todas as propriedades de estilo

Confira abaixo todas as propriedades de estilo que podem ser especificadas no objeto de estilo. A definição de propriedades de estilo para tipos de geometria específicos substitui as propriedades de estilo correspondentes definidas para "Todas as geometrias". Por exemplo, definir polygonFillColor substitui o valor definido em fillColor.

Propriedade Tipo Descrição Suporta regra interpolada
Todas as geometrias
isVisible Boolean Define se o recurso está visível. Não
color String Define a cor de preenchimento/traço para todos os tipos de geometria. Precisa ser um valor hexadecimal ou uma cor CSS3. Sim
opacity Double Define a opacidade de preenchimento/traço para todos os tipos de geometria. Precisa ser um valor duplo entre 0 e 1. Sim
width Double Define a largura do traço para todos os tipos de geometria. Sim
fillColor String Define a cor de preenchimento para todos os tipos de geometria. Precisa ser um valor hexadecimal ou uma cor CSS3. Sim
Geometrias de pontos
pointShape String Define a forma das geometrias de pontos. Aceita as mesmas formas que ee.FeatureCollection.style (circle, square, diamond, cross, plus, pentagram, hexagram, triangle, triangle_up, triangle_down, triangle_left, triangle_right, pentagon, hexagon, star5, star6). Não
pointSize Double Define a largura das geometrias de ponto (em px). Sim
pointFillColor String Define a cor de preenchimento para geometrias de pontos. Precisa ser um valor hexadecimal ou uma cor CSS3. Sim
pointFillOpacity Double Define a opacidade de preenchimento para geometrias de pontos. Precisa ser um valor duplo entre 0 e 1. Sim
Geometrias de linha
lineType String Define o tipo de linha. Oferece suporte aos mesmos tipos que ee.FeatureCollection.style (sólido, tracejado, pontilhado). Não
lineWidth Double Define a largura da linha (em px). Sim
lineColor String Define a cor das geometrias de linha. Precisa ser um valor hexadecimal ou uma cor CSS3. Sim
lineOpacity Double Define a opacidade para geometrias de linha. Precisa ser um valor duplo entre 0 e 1. Sim
Geometrias de polígono
polygonStrokeWidth Double Define a largura do traço dos polígonos (em px). Sim
polygonStrokeType String Define o tipo de linha para polígonos. Oferece suporte aos mesmos tipos que ee.FeatureCollection.style (sólido, tracejado, pontilhado). Não
polygonStrokeColor String Define a cor do traço para geometrias de polígono. Precisa ser um valor hexadecimal ou uma cor CSS3. Sim
polygonStrokeOpacity Double Define a opacidade do traço para geometrias de polígono. Precisa ser um valor duplo entre 0 e 1. Sim
polygonFillColor String Define a cor de preenchimento para geometrias de polígono. Precisa ser um valor hexadecimal ou uma cor CSS3. Sim
polygonFillOpacity Double Define a opacidade do preenchimento para geometrias de polígono. Precisa ser um valor duplo entre 0 e 1. Sim