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

# IGeoObjectSequence

Extends [ICustomizable](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ICustomizable.md), [IEventEmitter](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IEventEmitter.md), [IParentOnMap](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IParentOnMap.md).

Interface of an unchangeable collection of geo objects.

[Constructor](#constructor-summary) | [Fields](#properties-summary) | [Events](#events-summary) | [Methods](#methods-summary)

## Constructor {#constructor-summary}

```javascript
IGeoObjectSequence()
```

## Fields {#properties-summary}

#|
|| **Name** | **Type** | **Description** ||
|| [events](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IEventEmitter.md#events) | [IEventManager](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IEventManager.md) | Event manager.

Inherited from [IEventEmitter](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IEventEmitter.md#events). ||
|| [options](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ICustomizable.md#options) | [IOptionManager](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IOptionManager.md) | Options manager.

Inherited from [ICustomizable](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ICustomizable.md#options). ||
|#

## Events {#events-summary}

#|
|| **Name** | **Description** ||
|| [boundschange](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IGeoObjectSequence.md#event-boundschange) | Change to coordinates of the geographical area that spans the collection and its child geo objects. Instance of the [Event](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/Event.md) class. ||
|| [mapchange](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IParentOnMap.md#event-mapchange) | Map reference changed. Data fields: 
- oldMap - Old map.
- newMap - New map.

Inherited from [IParentOnMap](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IParentOnMap.md#event-mapchange). ||
|| [optionschange](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ICustomizable.md#event-optionschange) | Change to the object options.

Inherited from [ICustomizable](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ICustomizable.md#event-optionschange). ||
|| [pixelboundschange](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IGeoObjectSequence.md#event-pixelboundschange) | Change to pixel coordinates of the area that includes the collection and its child geo objects. Instance of the [Event](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/Event.md) class. ||
|#

## Methods {#methods-summary}

#|
|| **Name** | **Returns** | **Description** ||
|| [each](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IGeoObjectSequence.md#each)([callback](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IGeoObjectSequence.md#each-param-callback)[, [context](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IGeoObjectSequence.md#each-param-context)]) | | Calls a handler function for each child geo object. ||
|| [get](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IGeoObjectSequence.md#get)([index](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IGeoObjectSequence.md#get-param-index)) | [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IGeoObject.md) | Returns a child geo object with the specified index. ||
|| [getBounds](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IGeoObjectSequence.md#getBounds)() | Number[][]\|null | Returns geographical coordinates of the area that covers the collection and its child geo objects. ||
|| [getIterator](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IGeoObjectSequence.md#getIterator)() | [IIterator](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IIterator.md) | Returns iterator for child geo objects in the collection. ||
|| [getLength](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IGeoObjectSequence.md#getLength)() | Integer | Returns length of the collection. ||
|| [getMap](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IParentOnMap.md#getMap)() | [Map](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/Map.md) | Returns reference to the map.

Inherited from [IParentOnMap](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IParentOnMap.md#getMap). ||
|| [getPixelBounds](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IGeoObjectSequence.md#getPixelBounds)() | Number[][]\|null | Returns global pixel coordinates of the area that spans the collection and its child geo objects. ||
|| [indexOf](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IGeoObjectSequence.md#indexOf)([object](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IGeoObjectSequence.md#indexOf-param-object)) | Integer | Returns index of the child geo object. If the geo object cannot be found in the collection, -1 is returned. ||
|#

## Events details {#event_detail}

### boundschange {#boundschange}

Change to coordinates of the geographical area that spans the collection and its child geo objects. Instance of the [Event](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/Event.md) class.

### pixelboundschange {#pixelboundschange}

Change to pixel coordinates of the area that includes the collection and its child geo objects. Instance of the [Event](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/Event.md) class.

## Methods details {#method_detail}

### each {#each}

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

Calls a handler function for each child geo object.

**Parameters:**

#|
|| **Parameter** | **Default value** | **Description**  ||
|| [`callback`](#each-param-callback)[*](*star) | — | Type: Function

Handler function. ||
|| [`context`](#each-param-context) | — | Type: Object

Context for the handler function. ||
|#

\* Mandatory parameter/option.

### get {#get}

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

**Returns** a child geo object with the specified index.

**Parameters:**

#|
|| **Parameter** | **Default value** | **Description**  ||
|| [`index`](#get-param-index)[*](*star) | — | Type: Integer

Index. ||
|#

\* Mandatory parameter/option.

### getBounds {#getBounds}

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

**Returns** geographical coordinates of the area that covers the collection and its child geo objects.

### getIterator {#getIterator}

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

**Returns** iterator for child geo objects in the collection.

### getLength {#getLength}

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

**Returns** length of the collection.

### getPixelBounds {#getPixelBounds}

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

**Returns** global pixel coordinates of the area that spans the collection and its child geo objects.

### indexOf {#indexOf}

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

**Returns** index of the child geo object. If the geo object cannot be found in the collection, -1 is returned.

**Parameters:**

#|
|| **Parameter** | **Default value** | **Description**  ||
|| [`object`](#indexOf-param-object)[*](*star) | — | Type: [IGeoObject](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IGeoObject.md)

Child object. ||
|#

\* Mandatory parameter/option.

[*star]: Mandatory parameter/option.