Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Data

Класс 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` Это событие активируется, когда для геометрии активируется событие contextmenu 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

google.maps.Data.StylingFunction typedef

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

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

function(Data.Feature): Data.StyleOptions

Класс Data.Feature

google.maps.Data.Feature класс

У объекта есть геометрия, идентификатор и набор свойств.

Конструктор
`Data.Feature`	`Data.Feature([options])` Параметры: `options`: `Data.FeatureOptions optional` Создает объект Feature с заданными параметрами.

Методы
`forEachProperty`	`forEachProperty(callback)` Параметры: `callback`: `function(, string): void` Возвращаемое значение:* нет. Многократно вызывает указанную функцию, передавая значение и имя свойства при каждом вызове. Порядок итерации по свойствам не определен.
`getGeometry`	`getGeometry()` Параметры: нет. Возвращаемое значение: `Data.Geometry` Возвращает геометрию объекта.
`getId`	`getId()` Параметры: нет. Возвращаемое значение: `number\|string\|undefined` Возвращает идентификатор объекта.
`getProperty`	`getProperty(name)` Параметры: `name`: `string` Возвращаемое значение: `*` Возвращает значение запрошенного свойства или `undefined`, если свойство не существует.
`removeProperty`	`removeProperty(name)` Параметры: `name`: `string` Возвращаемое значение: нет. Удаляет свойство с указанным названием.
`setGeometry`	`setGeometry(newGeometry)` Параметры: `newGeometry`: `Data.Geometry\|LatLng\|LatLngLiteral` Возвращаемое значение: нет. Задает геометрию объекта.
`setProperty`	`setProperty(name, newValue)` Параметры: `name`: `string` `newValue`: `` Возвращаемое значение:* нет. Задает значение указанного свойства. Если `newValue` – это `undefined`, то это эквивалентно вызову `removeProperty`.
`toGeoJson`	`toGeoJson(callback)` Параметры: `callback`: `function(Object): void` Возвращаемое значение: нет. Экспортирует объект в объект GeoJSON.

События
`removeproperty`	`function(event)` Аргументы: `event`: `Data.RemovePropertyEvent` Это событие активируется, когда удаляется свойство объекта.
`setgeometry`	`function(event)` Аргументы: `event`: `Data.SetGeometryEvent` Это событие активируется, когда задана геометрия объекта.
`setproperty`	`function(event)` Аргументы: `event`: `Data.SetPropertyEvent` Это событие активируется, когда задается свойство функции.

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

google.maps.Data.FeatureOptions интерфейс

Необязательные параметры для создания объектов Data.Feature.

Свойства
`geometry optional`	Тип: `Data.Geometry\|LatLng\|LatLngLiteral optional` Геометрия объекта. Если при создании объекта не указать геометрию, будет использоваться `null`. Если задан объект `LatLng` или `LatLngLiteral`, он будет преобразован в геометрию `Data.Point`.
`id optional`	Тип: `number\|string optional` Идентификатор объекта указывать необязательно. Если идентификатор указан, его можно использовать для поиска объекта в объекте `Data` с помощью метода `getFeatureById()`. Обратите внимание, что идентификатор объекта нельзя изменить.
`properties optional`	Тип: `Object optional` Свойства объекта. Это произвольное сопоставление названий свойств со значениями.

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

google.maps.Data.Geometry интерфейс

Надкласс для различных геометрических объектов.

Методы
`forEachLatLng`	`forEachLatLng(callback)` Параметры: `callback`: `function(LatLng): void` Возвращаемое значение: нет. Многократно вызывает заданную функцию, передавая ей точку из геометрии при каждом вызове.
`getType`	`getType()` Параметры: нет. Возвращаемое значение: `string` Возвращает тип геометрического объекта. Возможные значения: `"Point"`, `"MultiPoint"`, `"LineString"`, `"MultiLineString"`, `"LinearRing"`, `"Polygon"`, `"MultiPolygon"` и `"GeometryCollection"`.