Стиль объектов в объекте FeatureView задается с помощью правил, определенных в объекте JavaScript. Стиль можно задать при первоначальном определении FeatureViewLayer или в любое время после этого. Система стилей позволяет задавать как общие правила для больших групп объектов, так и более конкретные правила для отдельных объектов. Стиль объекта можно задать с помощью постоянных значений или на основе данных, в зависимости от характеристик объекта.
Объект стиля
Ниже показана базовая структура объекта стиля. Существует два типа
правил: общие правила и конкретные правила. Общие правила влияют на все объекты в объекте FeatureView, а конкретные правила – на подмножество объектов.
{
// Broad style rules.
opacity: …,
polygonFillColor: …,
// Specific style rules.
rules: [
{ … },
{ … }
]
};
Общие правила
Чтобы применить свойства стиля ко всем объектам (или объектам определенного типа геометрии), укажите свойства стиля на верхнем уровне в объекте стиля.
{
opacity: 0.5,
pointShape: 'triangle',
lineWidth: 10,
polygonFillColor: 'green'
};
Специальные правила
Чтобы применить свойства стиля к подмножеству объектов, используйте поле rules. Поле rules принимает список объектов JavaScript, каждый из которых содержит filter, выбирающий объекты в соответствии с условиями, определенными объектом ee.Filter, за которым следует ряд свойств стиля. В примере ниже есть правило, которое задает polygonStrokeWidth и polygonFillColor, только если значение свойства REP_AREA меньше 100. Более конкретные правила переопределяют свойства стиля более общих правил, а правила, расположенные ближе к концу списка 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'
};
Категорийное
Правило категориального стиля состоит из свойства стиля, которое нужно задать, и объекта JavaScript с тремя свойствами:
property– название свойства объекта, значение которого будет влиять на стиль.categories– список списков, в которых значения свойств объектов на карте сопоставляются с условными обозначениями свойств стиля. Каждая категория включает значение свойства, за которым следует значение символики, которое нужно применить. Значение свойства, определяющее категорию, должно быть строкой.defaultValue– условные обозначения по умолчанию, которые применяются к объектам, значение свойства которых не определено вcategories. Если значение null/undefined, будут применены настройки стиля по умолчанию.
Например, в следующем объекте свойство стиля color задается на основе свойства объекта MARINE. Объекты в категории "0" слоя "MARINE" будут фиолетовыми, в категории "1" – зелеными, в категории "2" – синими, а в других категориях – белыми.
var visParams = {
color: {
property: 'MARINE',
categories: [
['0', 'purple'],
['1', 'green'],
['2', 'blue']
],
defaultValue: 'white'
}
};
Интерполированные
Правило интерполированного стиля состоит из свойства стиля, которое нужно задать, и объекта JavaScript, содержащего до пяти свойств:
property– название свойства объекта, значение которого будет влиять на стиль.mode– режим интерполяции ('linear'или'interval').palette– список цветов, прозрачностей или толщин, между которыми интерполируются значения входных свойств. Формат зависит от значения параметраmode. Подробную информацию можно найти в разделах Линейный и Интервал.
Применяется только к режиму "'linear'"
min– значение свойства, которое нужно сопоставить с первым элементом в спискеpalette.max– значение свойства, которое нужно сопоставить с последним элементом в спискеpalette.
Линейная
Режим линейной интерполяции задает свойство стиля объекта, линейно сопоставляя входные значения в диапазоне от min до max со списком значений символики, определенных в свойстве palette. Входные значения ограничены диапазоном, заданным параметрами min и max.
Например, в следующем объекте свойство стиля color задается на основе свойства объекта REP_AREA. Свойство palette – это список цветов, указывающий, что входные значения в диапазоне от min до max должны линейно переходить от желтого к красному и синему. Значение от 1 до 500 интерполируется между желтым и красным, а значение от 500 до 1000 – между красным и синим.
var visParams = {
color: {
property: 'REP_AREA',
mode: 'linear',
palette: ['yellow', 'red', 'blue'],
min: 1,
max: 1000
}
};
Интервал
В режиме интерполяции интервалов свойство стиля объекта задается путем сопоставления входных значений с границами классов и последующего применения условных обозначений, характерных для каждого класса. Входные значения из выбранного свойства объекта присваиваются ближайшему значению границы класса путем округления в меньшую сторону. Свойство palette форматируется как список списков, где каждый внутренний список содержит значение границы класса, за которым следует значение свойства стиля. Объекты, у которых значение свойства меньше минимального значения интервала, сохраняют настройки стиля по умолчанию.
В примере ниже прозрачность заливки объекта задается в соответствии с градуированными классами свойства REP_AREA. Определение класса и условные обозначения стиля указываются в свойстве palette в виде списка списков. Это означает, что должно быть четыре класса с разрывами в значениях 0, 80, 2000 и 5000 и соответствующими значениями непрозрачности объектов 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 |
Задает цвет заливки и контура для всех типов геометрии. Значение должно быть шестнадцатеричным кодом или цветом CSS3. | Да |
opacity |
Double |
Задает прозрачность заливки/обводки для всех типов геометрии. Значение должно быть числом двойной точности от 0 до 1. | Да |
width |
Double |
Задает ширину обводки для всех типов геометрии. | Да |
fillColor |
String |
Задает цвет заливки для всех типов геометрии. Должно быть шестнадцатеричным значением или цветом 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 |
Задает цвет заливки для точечных геометрических объектов. Должно быть шестнадцатеричным значением или цветом CSS3. | Да |
pointFillOpacity |
Double |
Задает прозрачность заливки для геометрий точек. Значение должно быть числом двойной точности в диапазоне от 0 до 1. | Да |
| Геометрии линий | |||
lineType |
String |
Задает тип линии. Поддерживаются те же типы, что и для ee.FeatureCollection.style (сплошная, пунктирная, точечная). |
Нет |
lineWidth |
Double |
Задает толщину линии (в пикселях). | Да |
lineColor |
String |
Задает цвет линий. Должно быть шестнадцатеричным значением или цветом CSS3. | Да |
lineOpacity |
Double |
Задает прозрачность для геометрий линий. Значение должно быть числом двойной точности от 0 до 1. | Да |
| Геометрии многоугольников | |||
polygonStrokeWidth |
Double |
Задает толщину контура многоугольников (в пикселях). | Да |
polygonStrokeType |
String |
Задает тип линий для многоугольников. Поддерживаются те же типы, что и для ee.FeatureCollection.style (сплошная, пунктирная, точечная). |
Нет |
polygonStrokeColor |
String |
Задает цвет контура для многоугольников. Должно быть шестнадцатеричным значением или цветом CSS3. | Да |
polygonStrokeOpacity |
Double |
Задает прозрачность обводки для геометрий многоугольников. Значение должно быть числом двойной точности в диапазоне от 0 до 1. | Да |
polygonFillColor |
String |
Задает цвет заливки для многоугольников. Должно быть шестнадцатеричным значением или цветом CSS3. | Да |
polygonFillOpacity |
Double |
Задает прозрачность заливки для геометрий многоугольников. Значение должно быть числом двойной точности в диапазоне от 0 до 1. | Да |