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

# map.action.Single

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

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

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

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

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

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

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

Параметры движения. ||
|| `tick.callback` | — | Тип: Function

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

Новый центр карты в геокоординатах. ||
|| `tick.checkZoomRange` | false | Тип: Boolean

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

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

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

Тайминг-функция. ||
|| `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);
```

## Поля {#fields}

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

Унаследовано от [IEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IEventEmitter.md#events). ||
|#

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

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

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

• zoom - новый коэффициент масштабирования карты;

• duration - время, которое отводится на выполнение шага;

• timingFunction - функция, описывающая вид движения.

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

## Методы {#method}

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

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

## Описание методов {#description-methods}
### isActive

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

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

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

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