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

# map.action.Single

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

Простое движение карты. Движение выполняется сразу после передачи его в map.action.Manager.

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

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

```javascript
map.action.Single(tick)
```

Создаёт простое (один шаг) движение карты.

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

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

Параметры движения. ||
|| [`tick.callback`](#param-tick.callback) | — | Тип: Function

Функция, которая будет вызвана после выполнения действия. Принимает в качестве параметра ошибку или null, если действие выполнилось успешно. ||
|| [`tick.center`](#param-tick.center) | — | Тип: Number[]

Новый центр карты в геокоординатах. ||
|| [`tick.checkZoomRange`](#param-tick.checkZoomRange) | false | Тип: Boolean

Флаг, показывающий, нужно ли проверять новый коэффициент мастабирования карты. Если значение флага true, то перед выполнением действия будет запрошен интервал допустимых коэффициентов масштабирования в новой точке. Если указанный коэффициент выходит за интервал допустимых значений, он будет скорректирован. При этом будет изменено значение нового центра карты в глобальных пиксельных координатах. ||
|| [`tick.duration`](#param-tick.duration) | 0 | Тип: Number

Время исполнения движения, в миллисекундах. ||
|| [`tick.globalPixelCenter`](#param-tick.globalPixelCenter) | — | Тип: Number[]

Новый центр карты в глобальных пикселах. При одновременном задании параметров center и globalPixelCenter, параметр center игнорируется. ||
|| [`tick.timingFunction`](#param-tick.timingFunction) | 'linear' | Тип: String

Тайминг-функция. ||
|| [`tick.zoom`](#param-tick.zoom) | — | Тип: Number

Новый коэффициент масштабирования карты. ||
|#

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

**Пример:**

```javascript
var myCallback = function(err) {
        if (err) {
            throw err;
        }
    },
    myAction = new ymaps.map.action.Single({
          center: [0, 0],
          zoom: 4,
          duration: 1000,
          timingFunction: 'ease-in',
          checkZoomRange: true,
          callback: myCallback
    });

// Действие выполнится сразу после вызова метода execute.
myMap.action.execute(myAction);
```

## Поля {#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). ||
|#

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

#|
|| **Имя** | **Описание** ||
|| [end](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IMapAction.md#event-end) | Событие, оповещающее карту об окончании движения.

Унаследовано от [IMapAction](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IMapAction.md#event-end). ||
|| [tick](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IMapAction.md#event-tick) | Событие, оповещающее карту о следующем шаге движения. Содержит поля:
- globalPixelCenter - новый центр карты в глобальных пикселах;
- zoom - новый коэффициент масштабирования карты;
- duration - время, которое отводится на выполнение шага;
- timingFunction - функция, описывающая вид движения.

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


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

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [begin](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IMapAction.md#begin)([mapActionManager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IMapAction.md#begin-param-mapActionManager)) | | Запускает движение на исполнение картой. Этот метод автоматически вызывается менеджером движений карты. С момента вызова [IMapAction.begin](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IMapAction.md#begin) менеджер движений слушает события [IMapAction.tick](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IMapAction.md#event-tick) и [IMapAction.end](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IMapAction.md#event-end) и исполняет их.

Унаследован от [IMapAction](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IMapAction.md#begin). ||
|| [end](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IMapAction.md#end)() | | Останавливает движение.

Унаследован от [IMapAction](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IMapAction.md#end). ||
|| [isActive](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.action.Single.md#isActive)() | Boolean | Проверяет, исполняется ли движение картой в данный момент. ||
|#

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

### isActive {#isActive}

```javascript
{Boolean} isActive()
```

Проверяет, исполняется ли движение картой в данный момент.

**Возвращает** true - движение в данный момент исполняется, false - нет.

<!-- XLIFF_FARM_M2E4Yjc4_CACHING -->

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