--- metadata: - name: generator content: Diplodoc Platform v5.39.1 alternate: - https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/GeoObjectCollection.md - https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/jsapi-v2-1/doc/ru/llms.txt # GeoObjectCollection Расширяет [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md), [IGeoObjectCollection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md). Коллекция геообъектов. Позволяет группировать геообъекты для добавления на карту, задания опций и т.д. Коллекция также является геообъектом. [Конструктор](#constructor-summary) | [Поля ](#properties-summary) | [События ](#events-summary) | [Методы ](#methods-summary) ## Конструктор {#constructor-summary} ```javascript GeoObjectCollection([feature[, options]]) ``` Создает коллекцию геообъектов. **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || [`feature`](#param-feature) | — | Тип: Object Описание коллекции. Функционально соответствует описанию геообъекта. См.: [GeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md) || || [`feature.children`](#param-feature.children) | — | Тип: [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md)[] Массив дочерних геообъектов. || || [`feature.geometry`](#param-feature.geometry) | — | Тип: [IGeometry](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md)\|Object Геометрия коллекции. || || [`feature.properties`](#param-feature.properties) | — | Тип: [IDataManager](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDataManager.md)\|Object Данные коллекции. || || [`options`](#param-options) | — | Тип: Object Опции коллекции. Здесь можно задавать все опции, описанные в классе [GeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject.md). Значения опций будут применяться как к самой коллекции, так и к ее дочерним объектам, если для них данные опции не определены. || |# **Пример:** ```javascript // Создание коллекции геообъектов и настройка параметров. var myGeoObjects = new ymaps.GeoObjectCollection({}, { preset: "islands#redCircleIcon", strokeWidth: 4, geodesic: true }); // Добавление меток и полилинии в коллекцию. myGeoObjects.add(new ymaps.Placemark([13.38, 52.51])); myGeoObjects.add(new ymaps.Placemark([30.30, 50.27])); myGeoObjects.add(new ymaps.Polyline([[13.38, 52.51], [30.30, 50.27]])); // Добавление коллекции на карту. myMap.geoObjects.add(myGeoObjects); // Установка центра и масштаба карты таким образом, чтобы вся коллекция была видна. myMap.setBounds(myGeoObjects.getBounds()); ``` ## Поля {#properties-summary} #| || **Имя** | **Тип** | **Описание** || || [events](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#events) | [IEventManager](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventManager.md) | Менеджер событий. Унаследовано от [IDomEventEmitter](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#events). || || [geometry](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#geometry) | [IGeometry](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md)\|null | Геометрия геообъекта. Унаследовано от [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#geometry). || || [options](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#options) | [IOptionManager](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IOptionManager.md) | Менеджер опций. Унаследовано от [ICustomizable](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#options). || || [properties](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#properties) | [IDataManager](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDataManager.md) | Данные геообъекта. Унаследовано от [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#properties). || || [state](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#state) | [IDataManager](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDataManager.md) | Состояние геообъекта. Унаследовано от [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#state). || |# ## События {#events-summary} #| || **Имя** | **Описание** || || [add](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#event-add) | Добавлен (вставлен) дочерний геообъект. Экземпляр класса [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - index: Integer - индекс добавленного геообъекта; - child: [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md) - ссылка на добавленный геообъект. Унаследовано от [IGeoObjectCollection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#event-add). || || [boundschange](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#event-boundschange) | Изменение координат географической области, охватывающей коллекцию и все ее дочерние геообъекты. Экземпляр класса [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). || || [click](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-click) | Однократное нажатие левой кнопки мыши на объекте. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-click). || || [contextmenu](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-contextmenu) | Вызов контекстного меню на элементе. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-contextmenu). || || [dblclick](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-dblclick) | Двойное нажатие левой кнопки мыши на объекте. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-dblclick). || || [geometrychange](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#event-geometrychange) | Изменение геометрии геообъекта. Экземпляр класса [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - originalEvent: [IEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md) - оригинальное событие геометрии. Унаследовано от [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#event-geometrychange). || || [mapchange](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md#event-mapchange) | Сменилась карта. Поля данных: - oldMap - старая карта; - newMap - новая карта. Унаследовано от [IParentOnMap](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md#event-mapchange). || || [mousedown](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mousedown) | Нажатие кнопки мыши над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mousedown). || || [mouseenter](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseenter) | Наведение курсора на объект. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseenter). || || [mouseleave](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseleave) | Вывод курсора за пределы объекта. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseleave). || || [mousemove](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mousemove) | Перемещение курсора над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mousemove). || || [mouseup](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseup) | Отпускание кнопки мыши над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseup). || || [multitouchend](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchend) | Окончание мультисенсорного управления. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent. Унаследовано от [IDomEventEmitter](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchend). || || [multitouchmove](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchmove) | Повторящееся событие при мультисенсорном управлении. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях. Определяет свойство touches, которое содержит список прикосновений. Каждое прикосновение описано объектом, которое содержит поля: - clientX - координата касания X относительно видимой области браузера; - clientY - координата касания Y относительно видимой области браузера; - pageX - координата касания X касания относительно начала документа; - pageY - координата касания Y касания относительно начала документа. Унаследовано от [IDomEventEmitter](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchmove). || || [multitouchstart](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchstart) | Начало мультисенсорного управления. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях. Определяет свойство touches, которое содержит список прикосновений. Каждое прикосновение описано объектом, которое содержит поля: - clientX - координата касания X относительно видимой области браузера; - clientY - координата касания Y относительно видимой области браузера; - pageX - координата касания X касания относительно начала документа; - pageY - координата касания Y касания относительно начала документа. Унаследовано от [IDomEventEmitter](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchstart). || || [optionschange](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#event-optionschange) | Изменение в опциях объекта. Унаследовано от [ICustomizable](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#event-optionschange). || || [overlaychange](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#event-overlaychange) | Изменение оверлея геообъекта. Экземпляр класса [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - overlay: [IOverlay](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IOverlay.md)\|null - ссылка на оверлей; - oldOverlay: [IOverlay](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IOverlay.md)\|null - предыдущий оверлей геообъекта. Унаследовано от [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#event-overlaychange). || || [parentchange](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChild.md#event-parentchange) | Сменился родительский объект. Поля данных: - oldParent - старый родитель; - newParent - новый родитель. Унаследовано от [IChild](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChild.md#event-parentchange). || || [pixelboundschange](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#event-pixelboundschange) | Изменение пиксельных координат области, охватывающей коллекцию и все ее дочерние геообъекты. Экземпляр класса [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). || || [propertieschange](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#event-propertieschange) | Изменение данных геообъекта. Экземпляр класса [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - originalEvent: [IEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEvent.md) - оригинальное событие менеджера данных. Унаследовано от [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#event-propertieschange). || || [remove](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#event-remove) | Удален дочерний геообъект. Экземпляр класса [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - index: Integer — индекс удаленного геообъекта; - child: [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md) — ссылка на удаленный геообъект. Унаследовано от [IGeoObjectCollection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#event-remove). || || [set](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#event-set) | В коллекцию записан новый дочерний геообъект. Экземпляр класса [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - index: Integer - индекс геообъекта; - child:[IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md) - ссылка на новый геообъект; - prevChild: [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md) — ссылка на предыдущее значение для данного индекса. Унаследовано от [IGeoObjectCollection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#event-set). || || [wheel](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-wheel) | Скролл мышкой. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-wheel). || |# ## Методы {#methods-summary} #| || **Имя** | **Возвращает** | **Описание** || || [add](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#add)([child](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#add-param-child)) | [GeoObjectCollection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md) | Добавляет геообъект в коллекцию. || || [each](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#each)([callback](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#each-param-callback)[, [context](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#each-param-context)]) | | Перебирает все элементы коллекции, вызывая для каждого функцию-обработчик. || || [get](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#get)([index](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#get-param-index)) | [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md) | Возвращает дочерний геообъект с заданным индексом. Унаследован от [IGeoObjectCollection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#get). || || [getBounds](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#getBounds)() | Number[][]\|null | Возвращает географические координаты области, охватывающей коллекцию и все ее дочерние геообъекты. || || [getIterator](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#getIterator)() | [IIterator](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IIterator.md) | Возвращает итератор по коллекции. || || [getLength](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#getLength)() | Integer | Возвращает количество геообъектов в коллекции. || || [getMap](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md#getMap)() | [Map](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md) | Возвращает ссылку на карту. Унаследован от [IParentOnMap](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md#getMap). || || [getOverlay](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#getOverlay)() | [vow.Promise](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md) | Возвращает объект-обещание, который подтверждается объектом оверлея в момент его фактического создания, либо отклоняется с передачей соответствующей ошибки. Унаследован от [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#getOverlay). || || [getOverlaySync](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#getOverlaySync)() | [IOverlay](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IOverlay.md)\|null | Метод предоставляет синхронный доступ к оверлею. Унаследован от [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md#getOverlaySync). || || [getParent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#getParent)() | [IParentOnMap](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md)\|null | Возвращает ссылку на родительский объект или null, если родительский элемент не был установлен. Унаследован от [IChildOnMap](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#getParent). || || [getPixelBounds](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#getPixelBounds)() | Number[][]\|null | Возвращает глобальные пиксельные координаты области, охватывающей коллекцию и ее дочерние геообъекты. || || [indexOf](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#indexOf)([object](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#indexOf-param-object)) | Integer | Возвращает индекс дочернего геообъекта. Если геообъект в коллекции не найден, возвращается -1. Унаследован от [IGeoObjectCollection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#indexOf). || || [remove](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#remove)([child](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#remove-param-child)) | [GeoObjectCollection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md) | Удаляет геообъект из коллекции. || || [removeAll](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#removeAll)() | [GeoObjectCollection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md) | Удаляет из коллекции все геообъекты. || || [set](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#set)([index](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#set-param-index), [child](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#set-param-child)) | [GeoObjectCollection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md) | Записывает в коллекцию новый дочерний геообъект. || || [setParent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#setParent)([parent](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#setParent-param-parent)) | [IChildOnMap](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md) | Устанавливает родительский объект. Если передать значение null, то элемент управления будет только удален из текущего родительского объекта. Унаследован от [IChildOnMap](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#setParent). || || [splice](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#splice)([index](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#splice-param-index), [number](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#splice-param-number)) | [GeoObjectCollection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md) | Удаляет геообъекты из коллекции. Если необходимо, вставляет на их место другие. Объекты, которые будут вставлены вместо удаляемых, передаются как дополнительные параметры (после параметра number). || || [toArray](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md#toArray)() | [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md)[] | Возвращает массив, содержащий все геообъекты коллекции на момент вызова. || |# ## Описание событий {#event_detail} ### boundschange {#boundschange} Изменение координат географической области, охватывающей коллекцию и все ее дочерние геообъекты. Экземпляр класса [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). ### pixelboundschange {#pixelboundschange} Изменение пиксельных координат области, охватывающей коллекцию и все ее дочерние геообъекты. Экземпляр класса [Event](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). ## Описание методов {#method_detail} ### add {#add} ```javascript {GeoObjectCollection} add(child) ``` Добавляет геообъект в коллекцию. **Возвращает** ссылку на коллекцию. **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || [`child`](#add-param-child)[*](*star) | — | Тип: [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md) Дочерний геообъект. || |# \* Обязательный параметр/опция. ### each {#each} ```javascript {} each(callback[, context]) ``` Перебирает все элементы коллекции, вызывая для каждого функцию-обработчик. **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || [`callback`](#each-param-callback)[*](*star) | — | Тип: Function Функция-обработчик. || || [`context`](#each-param-context) | — | Тип: Object Контекст исполнения функции. || |# \* Обязательный параметр/опция. ### getBounds {#getBounds} ```javascript {Number[][]|null} getBounds() ``` **Возвращает** географические координаты области, охватывающей коллекцию и все ее дочерние геообъекты. **Пример:** ```javascript // Устанавливаем центр и масштаб карты так, чтобы отобразить всю коллекцию целиком. myMap.setBounds(myCollection.getBounds()); ``` ### getIterator {#getIterator} ```javascript {IIterator} getIterator() ``` **Возвращает** итератор по коллекции. **Пример:** ```javascript // Найдем в коллекции геообъект с геометрией "Ломаная линия". var iterator = myGroup.getIterator(), object; while ((object = iterator.getNext()) != iterator.STOP_ITERATION) { if (object.geometry.getType() == "LineString") { break; } } ``` ### getLength {#getLength} ```javascript {Integer} getLength() ``` **Возвращает** количество геообъектов в коллекции. ### getPixelBounds {#getPixelBounds} ```javascript {Number[][]|null} getPixelBounds() ``` **Возвращает** глобальные пиксельные координаты области, охватывающей коллекцию и ее дочерние геообъекты. ### remove {#remove} ```javascript {GeoObjectCollection} remove(child) ``` Удаляет геообъект из коллекции. **Возвращает** ссылку на коллекцию. **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || [`child`](#remove-param-child)[*](*star) | — | Тип: [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md) Дочерний геообъект. || |# \* Обязательный параметр/опция. ### removeAll {#removeAll} ```javascript {GeoObjectCollection} removeAll() ``` Удаляет из коллекции все геообъекты. **Возвращает** ссылку на коллекцию. ### set {#set} ```javascript {GeoObjectCollection} set(index, child) ``` Записывает в коллекцию новый дочерний геообъект. **Возвращает** ссылку на себя. **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || [`index`](#set-param-index)[*](*star) | — | Тип: Integer Индекс. || || [`child`](#set-param-child)[*](*star) | — | Тип: [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md) Дочерний геообъект. || |# \* Обязательный параметр/опция. ### splice {#splice} ```javascript {GeoObjectCollection} splice(index, number) ``` Удаляет геообъекты из коллекции. Если необходимо, вставляет на их место другие. Объекты, которые будут вставлены вместо удаляемых, передаются как дополнительные параметры (после параметра number). **Возвращает** коллекцию удаленных геообъектов. **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || [`index`](#splice-param-index)[*](*star) | — | Тип: Integer Индекс геообъекта, с которого начинается удаление. || || [`number`](#splice-param-number)[*](*star) | — | Тип: Integer Количество удаляемых геообъектов. || |# \* Обязательный параметр/опция. **Пример:** ```javascript // Удаляет второй объект. myGeoObjects.splice(1, 1); // Вставляет новый объект obj во вторую позицию. myGeoObjects.splice(1, 0, obj); // Заменяет второй объект на новый объект obj. myGeoObjects.splice(1, 1, obj); ``` ### toArray {#toArray} ```javascript {IGeoObject[]} toArray() ``` **Возвращает** массив, содержащий все геообъекты коллекции на момент вызова. [*star]: Обязательный параметр.