--- metadata: - name: generator content: Diplodoc Platform v5.39.1 alternate: - https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/llms.txt # GeoObjectArray Расширяет [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md), [IMapObjectCollection](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IMapObjectCollection.md). Упорядоченная группа геообъектов на базе массива. Обеспечивает быстрые операции на основе порядковых индексов, но поиск объектов в данной группе медленнее чем в коллекции на основе двусвязного списка. Смотрите также [GeoObjectCollection](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectCollection.md). ## Конструктор {#constructor} ```javascript GeoObjectArray([feature[, options]]) ``` Создает упорядоченную группу геообъектов. **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || `feature` | — | Тип: Object Описание группы. Функционально соответствует описанию геообъекта. Смотрите [GeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObject.md). || || `feature.geometry` | — | Тип: [IGeometry](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeometry.md)\|Object Геометрия группы. || || `feature.properties` | — | Тип: [IDataManager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDataManager.md)\|Object Данные группы. || || `options` | — | Тип: Object Опции группы. Здесь можно задавать все опции описанные в классе [GeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObject.md). Значения опций будут применяться как к самой группе, так и к ее дочерним объектам, если для них данные опции не заданы. || |# **Пример:** ```javascript // Создаем группу геообъектов и задаем опции. var myGroup = new ymaps.GeoObjectArray({}, { preset: "twirl#airplaneIcon", strokeWidth: 4, geodesic: true }); // Добавляем в группу метки и линию. myGroup.add(new ymaps.Placemark([13.38, 52.51])); myGroup.add(new ymaps.Placemark([30.30, 50.27])); myGroup.add(new ymaps.Polyline([[13.38, 52.51], [30.30, 50.27]])); // Добавляем группу на карту. myMap.geoObjects.add(myGroup); // Устанавливаем карте центр и масштаб так, чтобы охватить группу целиком. myMap.setBounds(myGroup.getBounds()); ``` ## Поля {#fields} #| || **Имя** | **Тип** | **Описание** || || [events](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#events) | [IEventManager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IEventManager.md) | Менеджер событий. Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#events). || || [geometry](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#geometry) | [IGeometry](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeometry.md) | Геометрия геообъекта. Унаследовано от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#geometry). || || [options](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#options) | [IOptionManager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IOptionManager.md) | Менеджер опций. Унаследовано от [ICustomizable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#options). || || [properties](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#properties) | [IDataManager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDataManager.md) | Менеджер данных геообъекта. Унаследовано от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#properties). || || [state](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#state) | [IDataManager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDataManager.md) | Состояние геообъекта. Определяется следующими полями: • active - признак того, что на геообъекте открыт балун. • hover - признак того, что в данный момент на геообъект наведен указатель мыши. • drag - признак того, что геообъект перетаскивается. Унаследовано от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#state). || |# ## События {#events} #| || **Имя** | **Описание** || || [add](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICollection.md#add) | Произошло добавление дочернего объекта. Унаследовано от [ICollection](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICollection.md#add). || || [boundschange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#boundschange) | Изменение координат географической области, охватывающей группу и все ее дочерние геообъекты. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get: • oldBounds - предыдущая ограничивающая область; • newBounds - новая ограничивающая область. || || [click](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#click) | Однократное нажатие левой кнопки мыши на объекте. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#click). || || [contextmenu](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#contextmenu) | Вызов контекстного меню на элементе. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#contextmenu). || || [dblclick](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#dblclick) | Двойное нажатие левой кнопки мыши на объекте. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#dblclick). || || [geometrychange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#geometrychange) | Изменение геометрии геообъекта. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get: • originalEvent - оригинальное событие геометрии. Унаследовано от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#geometrychange). || || [mapchange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md#mapchange) | Сменилась карта. Поля данных: • oldMap - старая карта; • newMap - новая карта. Унаследовано от [IParentOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md#mapchange). || || [mousedown](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#mousedown) | Нажатие кнопки мыши над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#mousedown). || || [mouseenter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#mouseenter) | Наведение курсора на объект. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#mouseenter). || || [mouseleave](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#mouseleave) | Вывод курсора за пределы объекта. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#mouseleave). || || [mousemove](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#mousemove) | Перемещение курсора над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#mousemove). || || [mouseup](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#mouseup) | Отпускание кнопки мыши над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#mouseup). || || [multitouchend](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#multitouchend) | Окончание мультисенсорного управления. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях. Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#multitouchend). || || [multitouchmove](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#multitouchmove) | Повторящееся событие при мультисенсорном управлении. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях. Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#multitouchmove). || || [multitouchstart](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#multitouchstart) | Начало мультисенсорного управления. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях. Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#multitouchstart). || || [optionschange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#optionschange) | Изменение в опциях объекта. Унаследовано от [ICustomizable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#optionschange). || || [overlaychange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#overlaychange) | Изменение оверлея геообъекта. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get: • newOverlay - новый оверлей, либо null, если оверлея нет; • oldOverlay - старый оверлей, либо null, если оверлея нет. Унаследовано от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#overlaychange). || || [parentchange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChild.md#parentchange) | Сменился родительский объект. Поля данных: • oldParent - старый родитель; • newParent - новый родитель. Унаследовано от [IChild](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChild.md#parentchange). || || [pixelboundschange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#pixelboundschange) | Изменение пиксельных координат области, охватывающей группу и все ее дочерние геообъекты. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get: • oldPixelBounds - предыдущая ограничивающая область; • newPixelBounds - новая ограничивающая область. || || [pixelgeometrychange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#pixelgeometrychange) | Изменение пиксельной геометрии геообъекта. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get: • newPixelGeometry - новая пиксельная геометрия; • oldPixelGeometry - старая пиксельная геометрия. Унаследовано от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#pixelgeometrychange). || || [propertieschange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#propertieschange) | Изменение данных геообъекта. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get: • originalEvent - оригинальное событие менеджера данных. Унаследовано от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#propertieschange). || || [remove](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICollection.md#remove) | Произошло удаление дочернего объекта. Унаследовано от [ICollection](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICollection.md#remove). || || [wheel](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#wheel) | Скролл мышкой. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#wheel). || |# ## Методы {#method} #| || **Имя** | **Возвращает** | **Описание** || || [add](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#add)([child](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#add-param-child)[, [index](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#add-param-index)]) | [GeoObjectArray](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md) | Добавляет геообъект в группу. || || [each](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#each)([callback](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#each-param-callback)[, [context](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#each-param-context)]) | | Перебирает все элементы группы, вызывая для каждого функцию-обработчик. || || [get](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#get)([index](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#get-param-index)) | [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md)\|null | Returns ссылку на дочерний геообъект, либо null, если объекта с заданным индексом нет в группе. || || [getBounds](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#getBounds)() | Number[][]\|null | Returns географические координаты области, охватывающей группу и все ее дочерние геообъекты. || || [getIterator](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#getIterator)() | [IIterator](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IIterator.md) | Returns итератор по группе. || || [getLength](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#getLength)() | [GeoObjectArray](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md) | Returns количество геообъектов в группе. || || [getMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md#getMap)() | [Map](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Map.md) | Returns ссылку на карту. Унаследован от [IParentOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md#getMap). || || [getOverlay](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#getOverlay)() | [IOverlay](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IOverlay.md)\|null | Returns оверлей геообъекта, либо null. Унаследован от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#getOverlay). || || [getParent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md#getParent)() | [IParentOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md) | Returns ссылку на родительский объект. Унаследован от [IChildOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md#getParent). || || [getPixelBounds](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#getPixelBounds)() | Number[][]\|null | Returns глобальные пиксельные координаты области, охватывающей группу и все ее дочерние геообъекты. || || [indexOf](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#indexOf)([object](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#indexOf-param-object)) | Integer | Returns индекс геообъекта в группе или -1, если объект не найден. || || [remove](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#remove)([child](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#remove-param-child)) | [GeoObjectArray](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md) | Удаляет геообъект из группы. || || [removeAll](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#removeAll)() | [GeoObjectArray](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md) | Удаляет из группы все геообъекты. || || [setParent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md#setParent)([parent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md#setParent-param-parent)) | [IChildOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md) | Устанавливает родительский объект. Унаследован от [IChildOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md#setParent). || || [splice](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#splice)([index](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#splice-param-index), [number](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/GeoObjectArray.md#splice-param-number)) | [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md)[] | Удаляет геообъекты из группы. Если необходимо, вставляет на их место другие. Объекты, которые будут вставлены вместо удаляемых, передаются как дополнительные параметры (после параметра number). || |# ## Описание событий {#description-events} ### boundschange Изменение координат географической области, охватывающей группу и все ее дочерние геообъекты. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get: • oldBounds - предыдущая ограничивающая область; • newBounds - новая ограничивающая область. ### pixelboundschange Изменение пиксельных координат области, охватывающей группу и все ее дочерние геообъекты. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get: • oldPixelBounds - предыдущая ограничивающая область; • newPixelBounds - новая ограничивающая область. ## Описание методов {#description-methods} ### add ```javascript {GeoObjectArray} add(child[, index]) ``` Добавляет геообъект в группу. **Returns** ссылку на группу. **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || `child`[*](*parametr) | — | Тип: [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md) Дочерний геообъект. || || `index` | — | Тип: Integer Индекс, в который добавляется новый объект. Если индекс не задан, то объект будет добавлен в конец группы. || |# \* Обязательный параметр/опция. ### each ```javascript {} each(callback[, context]) ``` Перебирает все элементы группы, вызывая для каждого функцию-обработчик. **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || `callback`[*](*parametr) | — | Тип: Function Функция-обработчик. || || `context`[*](*parametr) | — | Тип: Object Контекст выполнения функции. || |# \* Обязательный параметр/опция. **Пример:** ```javascript // Отображаем индекс геообъекта в группе как содержимое его иконки. myGroup.events.add(["add", "remove"], function () { this.each(function (el, i) { el.properties.set("iconContent", i); }) }, myGroup); ``` ### get ```javascript {IGeoObject|null} get(index) ``` **Returns** ссылку на дочерний геообъект, либо null, если объекта с заданным индексом нет в группе. **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || `index`[*](*parametr) | — | Тип: Integer Индекс дочернего геообъекта. || |# \* Обязательный параметр/опция. ### getBounds ```javascript {Number[][]|null} getBounds() ``` **Returns** географические координаты области, охватывающей группу и все ее дочерние геообъекты. ### getIterator ```javascript {IIterator} getIterator() ``` **Returns** итератор по группе. ### getLength ```javascript {GeoObjectArray} getLength() ``` **Returns** количество геообъектов в группе. ### getPixelBounds ```javascript {Number[][]|null} getPixelBounds() ``` **Returns** глобальные пиксельные координаты области, охватывающей группу и все ее дочерние геообъекты. ### indexOf ```javascript {Integer} indexOf(object) ``` **Returns** индекс геообъекта в группе или -1, если объект не найден. **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || `object`[*](*parametr) | — | Тип: Object Геообъект. || |# \* Обязательный параметр/опция. ### remove ```javascript {GeoObjectArray} remove(child) ``` Удаляет геообъект из группы. **Returns** ссылку на группу. **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || `child`[*](*parametr) | — | Тип: [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md) Дочерний геообъект. || |# \* Обязательный параметр/опция. **Пример:** ```javascript // При клике по геообъекту удаляем его из группы. myGroup.events.add("click", function (e) { if (e.get("target").getParent() == this) { this.remove(e.get("target")); } }, myGroup); ``` ### removeAll ```javascript {GeoObjectArray} removeAll() ``` Удаляет из группы все геообъекты. **Returns** ссылку на группу. ### splice ```javascript {IGeoObject[]} splice(index, number) ``` Удаляет геообъекты из группы. Если необходимо, вставляет на их место другие. Объекты, которые будут вставлены вместо удаляемых, передаются как дополнительные параметры (после параметра number). **Returns** массив удаленных геообъектов. **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || `index`[*](*parametr) | — | Тип: Integer Индекс геообъекта, с которого начинается удаление. || || `number`[*](*parametr) | — | Тип: Integer Количество удаляемых геообъектов. || |# \* Обязательный параметр/опция. **Пример:** ```javascript // Удаляет второй объект. myGroup.splice(1, 1); // Вставляет новый объект obj во вторую позицию. myGroup.splice(1, 0, obj); // Заменяет второй объект на новый объект obj. myGroup.splice(1, 1, obj); ``` [*parametr]:Обязательный параметр/опция.