Эта страница переведена с помощью Cloud Translation API.

Data

Класс данных

google.maps . Data

Слой для отображения геопространственных данных. Могут отображаться точки, линии и полигоны.

У каждой Map по умолчанию есть объект Data , поэтому в большинстве случаев нет необходимости его создавать. Например:

 var myMap = new google.maps.Map(...);
 myMap.data.addGeoJson(...);
 myMap.data.setStyle(...);

Объект Data представляет собой коллекцию Features .

Этот класс расширяет MVCObject .

Доступ осуществляется путем вызова const {Data} = await google.maps.importLibrary("maps") .
См. Библиотеки в Maps JavaScript API .

Конструктор
`Data`	`Data([options])` Параметры: `options` : `Data.DataOptions optional` Создает пустую коллекцию с заданными `DataOptions` .

Методы
`add`	`add([feature])` Параметры: `feature` : `Data.Feature \| Data.FeatureOptions optional` Возвращаемое значение: `Data.Feature` Добавляет функцию в коллекцию и возвращает добавленную функцию. Если у объекта есть идентификатор, он заменит любой существующий объект в коллекции с тем же идентификатором. Если объект не указан, будет создан новый объект с нулевой геометрией и без свойств. Если указаны `FeatureOptions` , будет создан новый объект с указанными свойствами. Обратите внимание, что идентификаторы `1234` и `'1234'` эквивалентны. Добавление объекта с идентификатором `1234` заменит объект с идентификатором `'1234'` , и наоборот.
`addGeoJson`	`addGeoJson(geoJson[, options])` Параметры: `geoJson` : `Object` `options` : `Data.GeoJsonOptions optional` Возвращаемое значение: `Array < Data.Feature >` Добавляет объекты GeoJSON в коллекцию. Передайте этому методу разобранный JSON. Возвращаются импортированные объекты. Вызывает исключение, если GeoJSON не удалось импортировать.
`contains`	`contains(feature)` Параметры: `feature` : `Data.Feature` Возвращаемое значение: `boolean` Проверяет, присутствует ли заданный объект в коллекции.
`forEach`	`forEach(callback)` Параметры: `callback` : `function( Data.Feature ): void` Возвращаемое значение: нет Многократно вызывает заданную функцию, передавая ей объект из коллекции при каждом вызове. Порядок перебора объектов не определён.
`getControlPosition`	`getControlPosition()` Параметры: нет Возвращаемое значение: `ControlPosition` Возвращает положение элементов управления рисованием на карте.
`getControls`	`getControls()` Параметры: нет Возвращаемое значение: `Array <string>` Возвращает доступные пользователю режимы рисования в порядке их отображения. Это не включает `null` режим рисования, который добавляется по умолчанию. Возможные режимы рисования: `"Point"` , `"LineString"` или `"Polygon"` .
`getDrawingMode`	`getDrawingMode()` Параметры: нет Возвращаемое значение: `string\|null` Возвращает текущий режим отрисовки заданного слоя данных. Режим отрисовки, равный `null` означает, что пользователь может взаимодействовать с картой как обычно, и щелчки мышью ничего не рисуют. Возможные режимы отрисовки: `null` , `"Point"` , `"LineString"` или `"Polygon"` .
`getFeatureById`	`getFeatureById(id)` Параметры: `id` : `number\|string` Возвращаемое значение: `Data.Feature \|undefined` Возвращает объект с заданным идентификатором, если он существует в коллекции. В противном случае возвращает `undefined` . Обратите внимание, что идентификаторы `1234` и `'1234'` эквивалентны. Любой из них можно использовать для поиска одного и того же объекта.
`getMap`	`getMap()` Параметры: нет Возвращаемое значение: `Map` Возвращает карту, на которой отображаются объекты.
`getStyle`	`getStyle()` Параметры: нет Возвращаемое значение: `Data.StylingFunction \| Data.StyleOptions` Получает стиль для всех элементов коллекции.
`loadGeoJson`	`loadGeoJson(url[, options, callback])` Параметры: `url` : `string` `options` : `Data.GeoJsonOptions optional` `callback` : `function( Array < Data.Feature >): void optional` Возвращаемое значение: нет Загружает GeoJSON из URL-адреса и добавляет объекты в коллекцию. ПРИМЕЧАНИЕ: GeoJSON-файл загружается с помощью XHR и может не работать в кросс-доменном режиме. При возникновении проблем рекомендуем загрузить GeoJSON-файл с помощью выбранной вами AJAX-библиотеки, а затем вызвать метод `addGeoJson()` .
`overrideStyle`	`overrideStyle(feature, style)` Параметры: `feature` : `Data.Feature` `style` : `Data.StyleOptions` Возвращаемое значение: нет Изменяет стиль объекта. Эти изменения применяются поверх стиля, заданного функцией `setStyle()` . Свойства стиля, установленные в `null` возвращаются к значению, заданному функцией `setStyle()` .
`remove`	`remove(feature)` Параметры: `feature` : `Data.Feature` Возвращаемое значение: нет Удаляет объект из коллекции.
`revertStyle`	`revertStyle([feature])` Параметры: `feature` : `Data.Feature optional` Возвращаемое значение: нет Удаляет эффект предыдущих вызовов `overrideStyle()` . Стиль данного объекта возвращается к стилю, заданному `setStyle()` . Если ни одна функция не указана, то стиль всех функций возвращается к исходному.
`setControlPosition`	`setControlPosition(controlPosition)` Параметры: `controlPosition` : `ControlPosition` Возвращаемое значение: нет Устанавливает положение элементов управления рисованием на карте.
`setControls`	`setControls(controls)` Параметры: `controls` : `Array <string>` Возвращаемое значение: нет Устанавливает доступные пользователю режимы рисования в порядке их отображения. Этот режим не должен включать `null` режим рисования, который добавляется по умолчанию. Если `null` , элементы управления отрисовкой отключены и не отображаются. Возможные режимы рисования: `"Point"` , `"LineString"` или `"Polygon"` .
`setDrawingMode`	`setDrawingMode(drawingMode)` Параметры: `drawingMode` : `string optional` Возвращаемое значение: нет Устанавливает текущий режим отрисовки для заданного слоя данных. Режим отрисовки, равный `null` означает, что пользователь может взаимодействовать с картой как обычно, и щелчки мышью ничего не рисуют. Возможные режимы отрисовки: `null` , `"Point"` , `"LineString"` или `"Polygon"` .
`setMap`	`setMap(map)` Параметры: `map` : `Map` Возвращаемое значение: нет Отображает объекты на указанной карте. Если значение карты равно `null` , объекты будут удалены с карты.
`setStyle`	`setStyle(style)` Параметры: `style` : `Data.StylingFunction \| Data.StyleOptions` Возвращаемое значение: нет Задаёт стиль для всех объектов в коллекции. Стили, заданные для каждого объекта с помощью `overrideStyle()` продолжают применяться. Передайте либо объект с желаемыми параметрами стиля, либо функцию, вычисляющую стиль для каждого объекта. Функция будет вызываться каждый раз при обновлении свойств объекта.
`toGeoJson`	`toGeoJson(callback)` Параметры: `callback` : `function( Object ): void` Возвращаемое значение: нет Экспортирует объекты коллекции в объект GeoJSON.
Унаследовано: `addListener` , `bindTo` , `get` , `notify` , `set` , `setValues` , `unbind` , `unbindAll`

События
`addfeature`	`function(event)` Аргументы: `event` : `Data.AddFeatureEvent` Это событие срабатывает при добавлении объекта в коллекцию.
`click`	`function(event)` Аргументы: `event` : `Data.MouseEvent` Это событие запускается при щелчке по геометрии.
`contextmenu`	`function(event)` Аргументы: `event` : `Data.MouseEvent` Это событие срабатывает, когда для геометрии срабатывает событие контекстного меню DOM.
`dblclick`	`function(event)` Аргументы: `event` : `Data.MouseEvent` Это событие запускается при двойном щелчке по геометрии.
`mousedown`	`function(event)` Аргументы: `event` : `Data.MouseEvent` Это событие запускается при наведении курсора мыши на геометрию.
`mouseout`	`function(event)` Аргументы: `event` : `Data.MouseEvent` Это событие срабатывает, когда мышь покидает область геометрии.
`mouseover`	`function(event)` Аргументы: `event` : `Data.MouseEvent` Это событие срабатывает, когда мышь попадает в область геометрии.
`mouseup`	`function(event)` Аргументы: `event` : `Data.MouseEvent` Это событие запускается при наведении курсора мыши на геометрию.
`removefeature`	`function(event)` Аргументы: `event` : `Data.RemoveFeatureEvent` Это событие срабатывает при удалении объекта из коллекции.
`removeproperty`	`function(event)` Аргументы: `event` : `Data.RemovePropertyEvent` Это событие возникает при удалении свойства объекта.
`setgeometry`	`function(event)` Аргументы: `event` : `Data.SetGeometryEvent` Это событие срабатывает при задании геометрии объекта.
`setproperty`	`function(event)` Аргументы: `event` : `Data.SetPropertyEvent` Это событие вызывается при установке свойства объекта.
`rightclick`	Устарело: вместо этого используйте событие `Data.contextmenu` , чтобы поддерживать шаблоны использования, такие как Control-клик в macOS. `function(event)` Аргументы: `event` : `Data.MouseEvent` Это событие запускается при щелчке правой кнопкой мыши по геометрии.

Интерфейс Data.DataOptions

google.maps . Data.DataOptions

Объект DataOptions, используемый для определения свойств, которые разработчик может установить для объекта Data .

Характеристики
`map`	Тип: `Map` Карта, на которой будут отображены объекты коллекции.
`controlPosition optional`	Тип: `ControlPosition optional` По умолчанию: `ControlPosition.TOP_LEFT` Положение рисунка контролируется на карте.
`controls optional`	Тип: `Array <string> optional` По умолчанию: `null` Описывает доступные пользователю режимы рисования в порядке их отображения. Этот режим не включает `null` режим рисования, который добавляется по умолчанию. Если `null` , элементы управления отрисовкой отключены и не отображаются. Возможные режимы рисования: `"Point"` , `"LineString"` или `"Polygon"` .
`drawingMode optional`	Тип: `string optional` По умолчанию: `null` Текущий режим отрисовки данного слоя данных. Режим отрисовки `null` означает, что пользователь может взаимодействовать с картой как обычно, и щелчки мышью ничего не отображают. Возможные режимы отрисовки: `null` , `"Point"` , `"LineString"` или `"Polygon"` .
`featureFactory optional`	Тип: `function( Data.Geometry ): Data.Feature optional` Если включено рисование и пользователь рисует геометрию (точку, линию или многоугольник), эта функция вызывается с этой геометрией и должна вернуть объект, который необходимо добавить в слой данных. Если featureFactory не указан, из этой геометрии будет создан объект без идентификатора и свойств. Значение по умолчанию — `null` .
`style optional`	Тип: `Data.StylingFunction \| Data.StyleOptions optional` Стиль для всех объектов коллекции. Подробнее см. метод `setStyle()` выше.

Интерфейс Data.GeoJsonOptions

google.maps . Data.GeoJsonOptions

Дополнительные параметры для импорта GeoJSON.

Характеристики
`idPropertyName optional`	Тип: `string optional` Имя свойства объекта, которое будет использоваться в качестве идентификатора объекта. Если не указано, будет использован идентификатор объекта GeoJSON.

Интерфейс Data.StyleOptions

google.maps . Data.StyleOptions

Эти параметры определяют, как объект должен выглядеть при отображении на карте.

Характеристики
`animation optional`	Тип: `Animation optional` Анимация, воспроизводимая при добавлении маркера на карту. Применимо только к точечной геометрии.
`clickable optional`	Тип: `boolean optional` По умолчанию: `true` Если `true` , маркер получает события мыши и касания.
`cursor optional`	Тип: `string optional` Курсор мыши, отображаемый при наведении. Применимо только к точечной геометрии.
`draggable optional`	Тип: `boolean optional` По умолчанию: `false` Если `true` , объект можно перетаскивать по карте, а геометрия базового объекта будет обновляться.
`editable optional`	Тип: `boolean optional` По умолчанию: `false` Если `true` , объект можно редактировать, перетаскивая контрольные точки, а геометрия базового объекта будет обновлена. Применимо только к геометриям LineString и Polygon.
`fillColor optional`	Тип: `string optional` Цвет заливки. Поддерживаются все цвета CSS3, за исключением расширенных именованных цветов. Применяется только к полигональной геометрии.
`fillOpacity optional`	Тип: `number optional` Непрозрачность заливки от 0,0 до 1,0. Применяется только к полигональной геометрии.
`icon optional`	Тип: `string\| Icon \| Symbol optional` Значок для переднего плана. Если указана строка, она обрабатывается как `Icon` со строкой в качестве `url` . Применимо только к точечной геометрии.
`icons optional`	Тип: `Array < IconSequence > optional` Значки, отображаемые вдоль полилинии. Применимо только к линейным геометриям.
`label optional`	Тип: `string\| MarkerLabel optional` Добавляет метку к маркеру. Метка может быть строкой или объектом `MarkerLabel` . Применяется только к точечным геометриям.
`opacity optional`	Тип: `number optional` Прозрачность маркера в диапазоне от 0,0 до 1,0. Применяется только к точечной геометрии.
`shape optional`	Тип: `MarkerShape optional` Определяет карту изображения, используемую для обнаружения попаданий. Применимо только к точечной геометрии.
`strokeColor optional`	Тип: `string optional` Цвет обводки. Поддерживаются все цвета CSS3, за исключением расширенных именованных цветов. Применяется только к линейным и многоугольным геометриям.
`strokeOpacity optional`	Тип: `number optional` Непрозрачность обводки от 0,0 до 1,0. Применяется только к линейным и многоугольным объектам.
`strokeWeight optional`	Тип: `number optional` Ширина штриха в пикселях. Применимо только к линейным и многоугольным геометриям.
`title optional`	Тип: `string optional` Текст при наведении курсора. Применимо только к точечной геометрии.
`visible optional`	Тип: `boolean optional` По умолчанию: `true` Видна ли функция.
`zIndex optional`	Тип: `number optional` Все объекты отображаются на карте в порядке их zIndex: объекты с более высокими значениями отображаются перед объектами с более низкими значениями. Маркеры всегда отображаются перед линиями и полигонами.

Data.StylingFunction typedef

google.maps . Data.StylingFunction typedef

Функция, которая вычисляет внешний вид объекта.

Метод Data.setStyle() может принимать функцию стилизации. Используйте его, когда элементы должны выглядеть по-разному в зависимости от их свойств. Подробнее о функциях стилизации см. в руководстве разработчика .

function(

Data Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Класс данных

Конструктор

Методы

События

Интерфейс Data.DataOptions

Характеристики

Интерфейс Data.GeoJsonOptions

Характеристики

Интерфейс Data.StyleOptions

Характеристики

Data.StylingFunction typedef

Data