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

Data

Класс данных

google.maps . Data Класс google.maps . Data

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

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

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

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

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

Конструктор
`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 Интерфейс 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 Интерфейс google.maps . Data.GeoJsonOptions

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

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

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

google.maps . 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

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

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

function( Data.Feature ): Data.StyleOptions

Класс Data.Feature

google.maps . 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 Интерфейс 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 Интерфейс google.maps . Data.Geometry

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

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