Документация
Справочник JavaScript API
2.1.50 (текущая версия)
collection
interactivityModel
Интерфейсы

map.GeoObjects

Расширяет IGeoObjectCollection.

Коллекция геообъектов карты. У каждой карты уже есть своя коллекция геообъектов, доступная как map.geoObjects. Не инстанцируйте экземпляры этого класса без необходимости.

См.: Map.geoObjects

Конструктор | Поля | События | Методы

Конструктор

map.GeoObjects(map[, options])

Параметры:

ПараметрЗначение по умолчаниюОписание
map *
[no-highlight[

* Обязательный параметр/опция.

]no-highlight]

Тип: Map

Карта.

options

Тип: Object

Опции коллекции геообъектов. Через опции map.geoObjects можно задавать настройки геообъектов, добавленных на карту:

* Обязательный параметр/опция.

Поля

ИмяТипОписание
eventsIEventManager

Менеджер событий.

Унаследовано от IEventEmitter.

optionsIOptionManager

Менеджер опций.

Унаследовано от ICustomizable.

События

ИмяОписание
add

Добавлен (вставлен) дочерний геообъект. Экземпляр класса Event. Имена полей, доступных через метод Event.get:

  • index: Integer - индекс добавленного геообъекта;
  • child: IGeoObject - ссылка на добавленный геообъект.

Унаследовано от IGeoObjectCollection.

boundschange

Изменение координат географической области, охватывающей коллекцию и ее дочерние геообъекты. Экземпляр класса Event.

Унаследовано от IGeoObjectCollection.

mapchange

Сменилась карта. Поля данных:

  • oldMap - старая карта;
  • newMap - новая карта.

Унаследовано от IParentOnMap.

optionschange

Изменение в опциях объекта.

Унаследовано от ICustomizable.

pixelboundschange

Изменение пиксельных координат области, охватывающей коллекцию и ее дочерние геообъекты. Экземпляр класса Event.

Унаследовано от IGeoObjectCollection.

remove

Удален дочерний геообъект. Экземпляр класса Event. Имена полей, доступных через метод Event.get:

  • index: Integer — индекс удаленного геообъекта;
  • child: IGeoObject — ссылка на удаленный геообъект.

Унаследовано от IGeoObjectCollection.

set

В коллекцию записан новый дочерний геообъект. Экземпляр класса Event. Имена полей, доступных через метод Event.get:

  • index: Integer - индекс геообъекта;
  • child: IGeoObject - ссылка на новый геообъект;
  • prevChild: IGeoObject — ссылка на предыдущее значение для данного индекса.

Унаследовано от IGeoObjectCollection.

Методы

ИмяВозвращаетОписание
add(child[, index])

map.GeoObjects

Добавляет (вставляет) дочерний геообъект в коллекцию.

each(callback[, context])

Для каждого дочернего геообъекта, вызывает функцию-обработчик.

get(index)

IGeoObject

Возвращает дочерний геообъект с заданным индексом.

getBounds()

Number[][]|null

Возвращает географические координаты области, охватывающей коллекции и ее дочерние геообъекты.

getIterator()

IIterator

Возвращает итератор по коллекции.

getLength()

Integer

Возвращает длину коллекции.

getMap()

Map

Возвращает ссылку на карту.

Унаследован от IParentOnMap.

getPixelBounds()

Number[][]|null

Возвращает глобальные пиксельные координаты области, охватывающей коллекцию и ее дочерние геообъекты.

indexOf(object)

Integer

Возвращает индекс дочернего геообъекта. Если геообъект в коллекции не найден, возвращается -1.

remove(child)

map.GeoObjects

Удаляет дочерний геообъект из коллекции.

removeAll()

map.GeoObjects

Очищает коллекцию.

set(index, child)

map.GeoObjects

Записывает в коллекцию новый дочерний геообъект.

splice(index, number)

GeoObjectCollection

Удаляет геообъекты из коллекции. Если необходимо, вставляет на их место другие. Объекты, которые будут вставлены вместо удаляемых, передаются как дополнительные параметры (после параметра number).

Описание методов

add

Добавляет (вставляет) дочерний геообъект в коллекцию.

Возвращает cсылку на себя.

Параметры:

ПараметрЗначение по умолчаниюОписание
child*
[no-highlight[

* Обязательный параметр/опция.

]no-highlight]

Тип: IGeoObject

Дочерний геообъект.

index

Тип: Integer

Индекс, в который добавляется новый объект. По умолчанию объект добавляется в конец коллекции.

* Обязательный параметр/опция.

each

{} each(callback[, context])

Для каждого дочернего геообъекта, вызывает функцию-обработчик.

Параметры:

ПараметрЗначение по умолчаниюОписание
callback*
[no-highlight[

* Обязательный параметр/опция.

]no-highlight]

Тип: Function

Функция-обработчик.

context

Тип: Object

Контекст выполнения функции-обработчика.

* Обязательный параметр/опция.

Пример:

// Отображаем индекс геообъекта в коллекции как содержимое его иконки.
myGeoObjects.events.add(["add", "remove", "set"], function () {
    this.each(function (el, i) {
        el.properties.set("iconContent", i);
    })
}, myGeoObjects);

get

Возвращает дочерний геообъект с заданным индексом.

Параметры:

ПараметрЗначение по умолчаниюОписание
index*
[no-highlight[

* Обязательный параметр/опция.

]no-highlight]

Тип: Integer

Индекс.

* Обязательный параметр/опция.

getBounds

{Number[][]|null} getBounds()

Возвращает географические координаты области, охватывающей коллекции и ее дочерние геообъекты.

getIterator

{IIterator} getIterator()

Возвращает итератор по коллекции.

getLength

{Integer} getLength()

Возвращает длину коллекции.

getPixelBounds

{Number[][]|null} getPixelBounds()

Возвращает глобальные пиксельные координаты области, охватывающей коллекцию и её дочерние геообъекты.

indexOf

{Integer} indexOf(object)

Возвращает индекс дочернего геообъекта. Если геообъект в коллекции не найден, возвращается -1.

Параметры:

ПараметрЗначение по умолчаниюОписание
object*
[no-highlight[

* Обязательный параметр/опция.

]no-highlight]

Тип: Object

Дочерний геообъект.

* Обязательный параметр/опция.

remove

Удаляет дочерний геообъект из коллекции.

Возвращает cсылку на себя.

Параметры:

ПараметрЗначение по умолчаниюОписание
child*
[no-highlight[

* Обязательный параметр/опция.

]no-highlight]

Тип: IGeoObject

Удаляемый геообъект.

* Обязательный параметр/опция.

Пример:

// При клике по геообъекту удаляем его из коллекции.
myGeoObjects.events.add("click", function (e) {
    if (e.get("target").getParent() == this) {
        this.remove(e.get("target"));
    }
}, myGeoObjects);

removeAll

{map.GeoObjects} removeAll()

Очищает коллекцию.

Возвращает cсылку на себя.

set

Записывает в коллекцию новый дочерний геообъект.

Возвращает cсылку на себя.

Параметры:

ПараметрЗначение по умолчаниюОписание
index*
[no-highlight[

* Обязательный параметр/опция.

]no-highlight]

Тип: Integer

Индекс.

child*
[no-highlight[

* Обязательный параметр/опция.

]no-highlight]

Тип: IGeoObject

Дочерний геообъект.

* Обязательный параметр/опция.

splice

Удаляет геообъекты из коллекции. Если необходимо, вставляет на их место другие. Объекты, которые будут вставлены вместо удаляемых, передаются как дополнительные параметры (после параметра number).

Возвращает коллекцию удаленных геообъектов.

Параметры:

ПараметрЗначение по умолчаниюОписание
index*
[no-highlight[

* Обязательный параметр/опция.

]no-highlight]

Тип: Integer

Индекс геообъекта, с которого начинается удаление.

number*
[no-highlight[

* Обязательный параметр/опция.

]no-highlight]

Тип: Integer

Количество удаляемых геообъектов.

* Обязательный параметр/опция.

Пример:

// Удаляет второй объект.
myGeoObjects.splice(1, 1);
// Вставляет новый объект obj во вторую позицию.
myGeoObjects.splice(1, 0, obj);
// Заменяет второй объект на новый объект obj.
myGeoObjects.splice(1, 1, obj);