Le style des éléments d'un élément FeatureView est spécifié à l'aide de règles définies dans un objet JavaScript. Le style peut être défini lors de la définition initiale d'un FeatureViewLayer ou à tout moment par la suite. Le système de style vous permet de définir des règles de style générales qui s'appliquent à de grands groupes d'éléments géographiques, ainsi que des règles plus spécifiques pour des éléments géographiques particuliers. Le style des éléments géographiques peut être défini par des valeurs constantes ou basé sur les données, en fonction des caractéristiques des éléments géographiques.
Objet de style
La structure de base d'un objet de style est illustrée ci-dessous. Il existe deux types de règles : les règles générales et les règles spécifiques. Les règles générales affectent toutes les caractéristiques d'un élément FeatureView, tandis que les règles spécifiques n'en affectent qu'un sous-ensemble.
{
// Broad style rules.
opacity: …,
polygonFillColor: …,
// Specific style rules.
rules: [
{ … },
{ … }
]
};
Règles générales
Pour appliquer des propriétés de style à tous les éléments (ou à ceux d'un type de géométrie spécifique), spécifiez les propriétés de style au niveau supérieur de l'objet de style.
{
opacity: 0.5,
pointShape: 'triangle',
lineWidth: 10,
polygonFillColor: 'green'
};
Règles spécifiques
Pour appliquer des propriétés de style à un sous-ensemble d'éléments géographiques, utilisez le champ rules. Le champ rules accepte une liste d'objets JavaScript, chacun avec un filter qui sélectionne des éléments selon les conditions définies par un objet ee.Filter, suivi d'une série de propriétés de style. Dans l'exemple ci-dessous, une règle définit polygonStrokeWidth et polygonFillColor uniquement si la propriété "REP_AREA" est inférieure à 100. Les règles spécifiques remplacent les propriétés de style des règles générales, et les règles situées vers la fin de la liste rules remplacent celles situées vers le début (les règles spécifiques sont évaluées de la première à la dernière).
{
rules: [
{
filter: ee.Filter.lt('REP_AREA', 100),
polygonStrokeWidth: 0.5,
polygonFillColor: 'blue'
},
{ … } // Optionally include additional rules.
]
};
Définir le style
Le style d'un élément géographique peut être défini lorsqu'un FeatureViewLayer est déclaré ou à tout moment par la suite.
FeatureViewLayer déclaration
Pour définir les paramètres de visualisation lors de la déclaration d'un FeatureViewLayer, utilisez le paramètre 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);
Type existant : FeatureViewLayer
Pour définir les paramètres de visualisation d'un FeatureViewLayer existant, utilisez la fonction setVisParams. Il remplace toutes les règles de style précédemment spécifiées. Les propriétés non spécifiées sont définies sur leur valeur par défaut.
var layer = ui.Map.FeatureViewLayer('WCMC/WDPA/current/polygons_FeatureView');
Map.add(layer);
layer.setVisParams({
opacity: 0.5,
lineWidth: 10,
polygonFillColor: 'purple'
});
Symbologie
Pour chaque propriété de style, vous pouvez spécifier une règle de style constante ou une règle de style basée sur les données. L'option basée sur les données utilise les valeurs des propriétés des éléments géographiques pour déterminer la symbolisation, qui peut être catégorielle ou interpolée. Pour obtenir la liste complète des propriétés de style, consultez le tableau des propriétés de style.
Constante
Une règle de style constante se compose d'une propriété de style à définir et de sa valeur. L'exemple suivant définit la couleur de remplissage du polygone sur bleu.
var visParams = {
polygonFillColor: 'blue'
};
Catégorielle
Une règle de style catégorielle se compose d'une propriété de style à définir et d'un objet JavaScript avec trois propriétés :
property: nom d'une propriété d'élément dont la valeur affectera le style.categories: liste de listes qui associent les valeurs des propriétés des éléments géographiques aux symbologies des propriétés de style. Chaque catégorie inclut une valeur de propriété suivie d'une valeur de symbologie à appliquer. La valeur de la propriété qui définit une catégorie doit être une chaîne.defaultValue: symbologie par défaut à appliquer aux éléments dont la valeur de propriété n'est pas définie danscategories. Si la valeur est nulle/non définie, les paramètres de style par défaut sont appliqués.
Par exemple, l'objet suivant définit la propriété de style color en fonction de la propriété d'élément géographique "MARINE". Les éléments géographiques de la catégorie "MARINE" "0" sont définis en violet, "1" en vert, "2" en bleu et toute autre catégorie en blanc.
var visParams = {
color: {
property: 'MARINE',
categories: [
['0', 'purple'],
['1', 'green'],
['2', 'blue']
],
defaultValue: 'white'
}
};
Interpolé
Une règle de style interpolée se compose d'une propriété de style à définir et d'un objet JavaScript comportant jusqu'à cinq propriétés :
property: nom d'une propriété d'élément dont la valeur affectera le style.mode: mode d'interpolation, soit'linear', soit'interval'.palette: liste de couleurs, d'opacités ou de largeurs entre lesquelles interpoler les valeurs des propriétés d'entrée. Le format dépend demode. Pour en savoir plus, consultez les sections Linéaire et Intervalle.
S'applique uniquement au mode 'linear'
min: valeur de la propriété à mapper au premier élément de la listepalette.max: valeur de la propriété à mapper au dernier élément de la listepalette.
Linéaire
Le mode d'interpolation linéaire définit une propriété de style d'élément géographique en mappant les valeurs d'entrée de la plage min à max de manière linéaire entre une liste de valeurs de symbologie définies dans la propriété palette. Les valeurs d'entrée sont limitées à la plage définie par min et max.
Par exemple, l'objet suivant définit la propriété de style color en fonction de la propriété d'élément géographique "REP_AREA". La propriété palette est une liste de couleurs indiquant que les valeurs d'entrée comprises entre min et max doivent être classées de manière linéaire du jaune au rouge, puis au bleu. Une valeur comprise entre 1 et 500 est interpolée entre le jaune et le rouge, et une valeur comprise entre 500 et 1 000 est interpolée entre le rouge et le bleu.
var visParams = {
color: {
property: 'REP_AREA',
mode: 'linear',
palette: ['yellow', 'red', 'blue'],
min: 1,
max: 1000
}
};
Intervalle
Le mode d'interpolation par intervalle définit une propriété de style d'élément cartographique en mappant les valeurs d'entrée sur des limites de classe, puis en appliquant une symbologie spécifique à la classe. Les valeurs d'entrée de la propriété de caractéristique sélectionnée sont attribuées à la valeur de rupture de classe la plus proche en arrondissant à l'inférieur. La propriété palette est formatée sous la forme d'une liste de listes, où chaque liste interne contient une valeur de seuil de classe suivie d'une valeur de propriété de style. Les éléments dont la valeur de propriété est inférieure à la valeur minimale de la classe conservent leur paramètre de propriété de style par défaut.
Dans l'exemple suivant, l'opacité de remplissage des éléments géographiques est définie en fonction des classes graduées de la propriété "REP_AREA". La définition de la classe et la symbologie de style sont fournies dans la propriété palette sous la forme d'une liste de listes. Il indique qu'il doit y avoir quatre classes avec des seuils aux valeurs 0, 80, 2 000 et 5 000, avec des opacités d'éléments respectives de 0,5, 0,35, 0,22 et 0,15. En d'autres termes, les éléments géographiques dont les valeurs "REP_AREA" sont comprises dans l'intervalle $ 0 \le x < 80 $ auront une opacité de remplissage de 0,5, les valeurs comprises dans l'intervalle $ 80 \le x < 2000 $ auront une opacité de remplissage de 0,35, et ainsi de suite.
var visParams = {
fillOpacity: {
property: 'REP_AREA',
mode: 'interval',
palette: [
[0, 0.5],
[80, 0.35],
[2000, 0.22],
[5000, 0.15]
]
}
};
Toutes les propriétés de style
Vous trouverez ci-dessous toutes les propriétés de style que vous pouvez spécifier dans l'objet de style.
La définition de propriétés de style pour des types de géométrie spécifiques remplace les propriétés de style correspondantes définies pour "Toutes les géométries" (par exemple, la définition de polygonFillColor remplace la valeur définie dans fillColor).
| Propriété | Type | Description | Compatible avec la règle interpolée |
|---|---|---|---|
| Toutes les géométries | |||
isVisible |
Boolean |
Définit si l'élément géographique est visible. | Non |
color |
String |
Définit la couleur de remplissage/du trait pour tous les types de géométrie. Doit être une valeur hexadécimale ou une couleur CSS3. | Oui |
opacity |
Double |
Définit l'opacité du remplissage/du trait pour tous les types de géométrie. La valeur doit être un double compris entre 0 et 1. | Oui |
width |
Double |
Définit l'épaisseur du trait pour tous les types de géométrie. | Oui |
fillColor |
String |
Définit la couleur de remplissage pour tous les types de géométrie. Doit être une valeur hexadécimale ou une couleur CSS3. | Oui |
| Géométries de points | |||
pointShape |
String |
Définit la forme des géométries de points. Accepte les mêmes formes que ee.FeatureCollection.style (cercle, carré, losange, croix, plus, pentagramme, hexagramme, triangle, triangle_up, triangle_down, triangle_left, triangle_right, pentagone, hexagone, star5, star6). |
Non |
pointSize |
Double |
Définit la largeur des géométries de points (en px). | Oui |
pointFillColor |
String |
Définit la couleur de remplissage des géométries de points. Doit être une valeur hexadécimale ou une couleur CSS3. | Oui |
pointFillOpacity |
Double |
Définit l'opacité du remplissage pour les géométries de points. Doit être un double compris entre 0 et 1. | Oui |
| Géométries de lignes | |||
lineType |
String |
Définit le type de ligne. Accepte les mêmes types que ee.FeatureCollection.style (plein, tirets, pointillés). |
Non |
lineWidth |
Double |
Définit l'épaisseur de la ligne (en px). | Oui |
lineColor |
String |
Définit la couleur des géométries de ligne. Doit être une valeur hexadécimale ou une couleur CSS3. | Oui |
lineOpacity |
Double |
Définit l'opacité des géométries de lignes. La valeur doit être un double compris entre 0 et 1. | Oui |
| Géométries de polygones | |||
polygonStrokeWidth |
Double |
Définit l'épaisseur du trait des polygones (en px). | Oui |
polygonStrokeType |
String |
Définit le type de ligne pour les polygones. Accepte les mêmes types que ee.FeatureCollection.style (plein, tirets, pointillés). |
Non |
polygonStrokeColor |
String |
Définit la couleur du trait pour les géométries de polygones. Doit être une valeur hexadécimale ou une couleur CSS3. | Oui |
polygonStrokeOpacity |
Double |
Définit l'opacité du trait pour les géométries de polygones. La valeur doit être un double compris entre 0 et 1. | Oui |
polygonFillColor |
String |
Définit la couleur de remplissage des géométries de polygones. Doit être une valeur hexadécimale ou une couleur CSS3. | Oui |
polygonFillOpacity |
Double |
Définit l'opacité du remplissage pour les géométries de polygones. La valeur doit être un double compris entre 0 et 1. | Oui |