---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.ru/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/map.GeoObjects.md
  - https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/jsapi-v2-1/doc/ru/llms.txt

# map.GeoObjects

Расширяет [IGeoObjectCollection](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md).

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

**См.:** [Map.geoObjects](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#geoObjects)

[Конструктор](#constructor-summary) | [Поля ](#properties-summary) | [События ](#events-summary) | [Методы ](#methods-summary)

## Конструктор {#constructor-summary}

```javascript
map.GeoObjects(map[, options])
```

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`map`](#param-map)[*](*star) | — | Тип: [Map](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md)

Карта. ||
|| [`options`](#param-options) | — | Тип: Object

Опции коллекции геообъектов. Через опции map.geoObjects можно задавать настройки геообъектов, добавленных на карту:
- опции [кластеров](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Clusterer.md) с префиксом `cluster`.
- опции [кластеров](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ClusterPlacemark.md) с префиксом `cluster`. ||
|#

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

## Поля {#properties-summary}

#|
|| **Имя** | **Тип** | **Описание** ||
|| [events](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventEmitter.md#events) | [IEventManager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventManager.md) | Менеджер событий.

Унаследовано от [IEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventEmitter.md#events). ||
|| [options](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#options) | [IOptionManager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IOptionManager.md) | Менеджер опций.

Унаследовано от [ICustomizable](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#options). ||
|#

## События {#events-summary}

#|
|| **Имя** | **Описание** ||
|| [add](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#event-add) | Добавлен (вставлен) дочерний геообъект. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- index: Integer - индекс добавленного геообъекта;
- child: [IGeoObject](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md) - ссылка на добавленный геообъект.

Унаследовано от [IGeoObjectCollection](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#event-add). ||
|| [boundschange](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#event-boundschange) | Изменение координат географической области, охватывающей коллекцию и ее дочерние геообъекты. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md).

Унаследовано от [IGeoObjectCollection](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#event-boundschange). ||
|| [mapchange](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md#event-mapchange) | Сменилась карта. Поля данных:
- oldMap - старая карта;
- newMap - новая карта.

Унаследовано от [IParentOnMap](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md#event-mapchange). ||
|| [optionschange](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#event-optionschange) | Изменение в опциях объекта.

Унаследовано от [ICustomizable](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#event-optionschange). ||
|| [pixelboundschange](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#event-pixelboundschange) | Изменение пиксельных координат области, охватывающей коллекцию и ее дочерние геообъекты. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md).

Унаследовано от [IGeoObjectCollection](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#event-pixelboundschange). ||
|| [remove](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#event-remove) | Удален дочерний геообъект. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- index: Integer — индекс удаленного геообъекта;
- child: [IGeoObject](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md) — ссылка на удаленный геообъект.

Унаследовано от [IGeoObjectCollection](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#event-remove). ||
|| [set](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#event-set) | В коллекцию записан новый дочерний геообъект. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- index: Integer - индекс геообъекта;
- child:[IGeoObject](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md) - ссылка на новый геообъект;
- prevChild: [IGeoObject](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md) — ссылка на предыдущее значение для данного индекса.

Унаследовано от [IGeoObjectCollection](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObjectCollection.md#event-set). ||
|#


## Методы {#methods-summary}

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [add](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#add)([child](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#add-param-child)[, [index](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#add-param-index)]) | [map.GeoObjects](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md) | Добавляет (вставляет) дочерний геообъект в коллекцию. ||
|| [each](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#each)([callback](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#each-param-callback)[, [context](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#each-param-context)]) | | Для каждого дочернего геообъекта, вызывает функцию-обработчик. ||
|| [get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#get)([index](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#get-param-index)) | [IGeoObject](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md) | Возвращает дочерний геообъект с заданным индексом. ||
|| [getBounds](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#getBounds)() | Number[][]\|null | Возвращает географические координаты области, охватывающей коллекции и ее дочерние геообъекты. ||
|| [getIterator](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#getIterator)() | [IIterator](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IIterator.md) | Возвращает итератор по коллекции. ||
|| [getLength](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#getLength)() | Integer | Возвращает длину коллекции. ||
|| [getMap](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md#getMap)() | [Map](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md) | Возвращает ссылку на карту.

Унаследован от [IParentOnMap](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md#getMap). ||
|| [getPixelBounds](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#getPixelBounds)() | Number[][]\|null | Возвращает глобальные пиксельные координаты области, охватывающей коллекцию и ее дочерние геообъекты. ||
|| [indexOf](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#indexOf)([object](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#indexOf-param-object)) | Integer | Возвращает индекс дочернего геообъекта. Если геообъект в коллекции не найден, возвращается -1. ||
|| [remove](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#remove)([child](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#remove-param-child)) | [map.GeoObjects](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md) | Удаляет дочерний геообъект из коллекции. ||
|| [removeAll](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#removeAll)() | [map.GeoObjects](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md) | Очищает коллекцию. ||
|| [set](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#set)([index](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#set-param-index), [child](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#set-param-child)) | [map.GeoObjects](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md) | Записывает в коллекцию новый дочерний геообъект. ||
|| [splice](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#splice)([index](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#splice-param-index), [number](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects.md#splice-param-number)) | [GeoObjectCollection](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection.md) | Удаляет геообъекты из коллекции. Если необходимо, вставляет на их место другие. Объекты, которые будут вставлены вместо удаляемых, передаются как дополнительные параметры (после параметра number). ||
|#

## Описание методов {#method_detail}

### add {#add}

```javascript
{map.GeoObjects} add(child[, index])
```

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

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

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`child`](#add-param-child)[*](*star) | — | Тип: [IGeoObject](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md)

Дочерний геообъект. ||
|| [`index`](#add-param-index) | — | Тип: Integer

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

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

### each {#each}

```javascript
{} each(callback[, context])
```

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

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`callback`](#each-param-callback)[*](*star) | — | Тип: Function

Функция-обработчик. ||
|| [`context`](#each-param-context) | — | Тип: Object

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

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

**Пример:**

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

### get {#get}

```javascript
{IGeoObject} get(index)
```

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

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`index`](#get-param-index)[*](*star) | — | Тип: Integer

Индекс. ||
|#

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

### getBounds {#getBounds}

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

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

### getIterator {#getIterator}

```javascript
{IIterator} getIterator()
```

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

### getLength {#getLength}

```javascript
{Integer} getLength()
```

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

### getPixelBounds {#getPixelBounds}

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

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

### indexOf {#indexOf}

```javascript
{Integer} indexOf(object)
```

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

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`object`](#indexOf-param-object)[*](*star) | — | Тип: Object

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

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

### remove  {#remove}

```javascript
{map.GeoObjects} remove(child)
```

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

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

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`child`](#remove-param-child)[*](*star) | — | Тип: [IGeoObject](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeoObject.md)

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

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

**Пример:**

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

### removeAll {#removeAll}

```javascript
{map.GeoObjects} removeAll()
```

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

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

### set {#set}

```javascript
{map.GeoObjects} set(index, child)
```

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

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

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`index`](#set-param-index)[*](*star) | — | Тип: Integer

Индекс. ||
|| [`child`](#set-param-child)[*](*star) | — | Тип: [IGeoObject](https://yandex.ru/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);
```

<!-- XLIFF_FARM_YmViMDE1_CACHING -->

[*star]: Обязательный параметр.