Data-driven styling

Интерфейс FeatureLayer

google.maps.FeatureLayer интерфейс

Интерфейс, представляющий слой карты, который содержит объекты определенного типа (FeatureType). Стиль этих объектов можно переопределить на стороне клиента или связать с ними события.

featureType
Тип: FeatureType
FeatureType, связанный с этим FeatureLayer.
isAvailable
Тип: boolean
Доступен ли этот FeatureLayer, то есть доступны ли стили на основе данных для этой карты (в стиле карты консоли Google Cloud есть идентификатор карты, использующий векторные фрагменты с включенным FeatureLayer). Если это значение равно false (или становится равным false), стиль этого элемента FeatureLayer возвращается к значению по умолчанию, а события не запускаются.
BetadatasetId
необязательно
Тип: string optional
Идентификатор набора данных для этого FeatureLayer. Указывается, только если featureType – FeatureType.DATASET.
style
необязательно
Стиль Feature в FeatureLayer. Стиль применяется, когда он задан. Если функция стиля обновляется, нужно снова задать свойство стиля. Функция FeatureStyleFunction должна возвращать согласованные результаты при применении к фрагментам карты и быть оптимизирована для повышения производительности. Асинхронные функции не поддерживаются. Если вы используете FeatureStyleOptions, все объекты на слое будут оформлены с помощью одного и того же FeatureStyleOptions. Чтобы удалить ранее заданный стиль, установите для стиля значение null. Если FeatureLayer недоступен, настройка стиля не будет работать и будет регистрироваться ошибка.
addListener
addListener(eventName, handler)
Параметры:
  • eventName: string зарегистрированное событие.
  • handler: Function Функция для обработки событий.
Возвращаемое значение: MapsEventListener – итоговый прослушиватель событий.
Добавляет указанную функцию прослушивателя к указанному названию события. Возвращает идентификатор для этого прослушивателя, который можно использовать с event.removeListener.
click
function(event)
Аргументы:
Это событие активируется при нажатии на FeatureLayer.
mousemove
function(event)
Аргументы:
Это событие активируется, когда пользователь наводит указатель мыши на FeatureLayer.

Константы FeatureType

google.maps.FeatureType Библиотека констант
"maps"

Идентификаторы типов объектов.

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом FeatureTypeString.

const {FeatureType} = await google.maps.importLibrary("maps");
ADMINISTRATIVE_AREA_LEVEL_1 Первый уровень национального административного деления.
ADMINISTRATIVE_AREA_LEVEL_2 Второй уровень национального административного деления.
COUNTRY Указывает национальную политическую организацию.
BetaDATASET Указывает на сторонний набор данных.
LOCALITY Городская административная единица.
POSTAL_CODE Указывает почтовый индекс в том виде, в котором он используется в стране для обработки почты. Включает почтовые индексы.
SCHOOL_DISTRICT Указывает на школьный округ.

FeatureStyleFunction typedef

google.maps.FeatureStyleFunction typedef

Функция для стилизации FeatureLayer.

function(FeatureStyleFunctionOptions): (FeatureStyleOptions optional)

Интерфейс FeatureStyleFunctionOptions

google.maps.FeatureStyleFunctionOptions интерфейс

Параметры, передаваемые в FeatureStyleFunction.

feature
Тип: Feature
Feature передано в FeatureStyleFunction для стилизации.

Интерфейс FeatureStyleOptions

google.maps.FeatureStyleOptions интерфейс

Эти параметры определяют, как должен быть изменен стиль Feature на карте.

fillColor
необязательно
Тип: string optional
Шестнадцатеричная строка RGB (например, "#00FF00" для зеленого цвета). Применяется только к многоугольникам.
fillOpacity
необязательно
Тип: number optional
Прозрачность заливки: от 0,0 до 1,0. Применяется только к многоугольникам.
strokeColor
необязательно
Тип: string optional
Шестнадцатеричная строка RGB (например, "#00FF00" для зеленого цвета).
strokeOpacity
необязательно
Тип: number optional
Прозрачность штриха: от 0,0 до 1,0. Применяется только к геометриям линий и многоугольников.
strokeWeight
необязательно
Тип: number optional
ширина штриха в пикселях. Применяется только к геометриям линий и многоугольников.

Интерфейс Feature

google.maps.Feature интерфейс

Интерфейс, представляющий объект фрагмента векторной карты. Это входные данные для FeatureStyleFunction. Не сохраняйте ссылку на определенный объект Feature, так как она не будет стабильной.

featureType
Тип: FeatureType
FeatureType этого Feature.

Интерфейс PlaceFeature

google.maps.PlaceFeature interface
extends Feature

Интерфейс, представляющий объект с идентификатором места, который включает объекты типа FeatureType.ADMINISTRATIVE_AREA_LEVEL_1, FeatureType.ADMINISTRATIVE_AREA_LEVEL_2, FeatureType.COUNTRY, FeatureType.LOCALITY, FeatureType.POSTAL_CODE и FeatureType.SCHOOL_DISTRICT.

placeId
Тип: string
Унаследованные: featureType
fetchPlace
fetchPlace()
Параметры: нет.
Возвращаемое значение: Promise<Place>
Получает Place для этого PlaceFeature. В полученном объекте Place будут заполнены свойства id и displayName. Отображаемое название будет на языке, который конечный пользователь видит на карте. Дополнительные поля можно запросить позже через Place.fetchFields(). При этом действуют стандартные условия включения и оплаты Places API. Не вызывайте этот метод из FeatureStyleFunction, поскольку поддерживаются только синхронные функции FeatureStyleFunction. Если при получении Place произошла ошибка, объект Promise отклоняется.

Интерфейс DatasetFeature

google.maps.DatasetFeature interface
extends Feature

Интерфейс, представляющий объект из набора данных. featureType DatasetFeature всегда будет FeatureType.DATASET.

datasetAttributes
Тип: Object<string, string>
Сопоставление пар "ключ-значение" для атрибутов объекта.
datasetId
Тип: string
Идентификатор набора данных, к которому относится этот объект.
Унаследованные: featureType

Интерфейс FeatureMouseEvent

google.maps.FeatureMouseEvent interface
extends MapMouseEvent

Этот объект возвращается из события мыши на объекте FeatureLayer.

features
Тип: Array<Feature>
Feature в этом событии мыши.
Унаследованные: domEvent, latLng
Унаследованные: stop