---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.2
alternate:
  - https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/map.action.Single.md
  - https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.action.Single.md
  - href: https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/map.action.Single.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.com/dev/jsapi-v2-1/doc/en/llms.txt?revision=r21950234
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/jsapi-v2-1/doc/en/llms.txt?revision=r21950234

# map.action.Single

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

Simple map movement. The movement is made immediately after it is passed to map.action.Manager.

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

## Constructor {#constructor-summary}

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

Creates a simple (single step) map movement.

**Parameters:**

#|
|| **Parameter** | **Default value** | **Description**  ||
|| [`tick`](#param-tick)[*](*star) | — | Type: Object

Movement parameters. ||
|| [`tick.callback`](#param-tick.callback) | — | Type: Function

Function that will be called after performing the action. Accepts an error or null as a parameter, if the action was not successful. ||
|| [`tick.center`](#param-tick.center) | — | Type: Number[]

The new map center in geo coordinates. ||
|| [`tick.checkZoomRange`](#param-tick.checkZoomRange) | false | Type: Boolean

Flag showing whether the new map zoom needs to be checked. If the flag is set to true, the range of allowable zoom levels at the new point will be requested before performing the action. If the specified zoom does not fall within the allowable values, it will be corrected. In addition, the value of the new map center in global pixel coordinates will be changed. ||
|| [`tick.duration`](#param-tick.duration) | 0 | Type: Number

Duration of making the move, in milliseconds. ||
|| [`tick.globalPixelCenter`](#param-tick.globalPixelCenter) | — | Type: Number[]

The new map center in global pixels. When the "center" and "globalPixelCenter" parameters are set simultaneously, the "center" parameter is ignored. ||
|| [`tick.timingFunction`](#param-tick.timingFunction) | 'linear' | Type: String

Timing function. ||
|| [`tick.zoom`](#param-tick.zoom) | — | Type: Number

The new map zoom. ||
|#

\* Mandatory parameter/option.

**Example:**

```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
    });

// The action is performed immediately after calling "execute".
myMap.action.execute(myAction);
```

## 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). ||
|#

## Events {#events-summary}

#|
|| **Name** | **Description** ||
|| [end](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IMapAction.md#event-end) | Event that notifies the map that movement has finished.

Inherited from [IMapAction](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IMapAction.md#event-end). ||
|| [tick](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IMapAction.md#event-tick) | Event that notifies the map of the next step. Contains the fields: 
- globalPixelCenter - The new map center, in global pixels.
- zoom - The new map zoom.
- duration - The time that is allowed for performing the step.
- timingFunction - Function describing the type of movement.

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

## Methods {#methods-summary}

#|
|| **Name** | **Returns** | **Description** ||
|| [begin](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IMapAction.md#begin)([mapActionManager](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IMapAction.md#begin-param-mapActionManager)) | | Starts the movement to be performed by the map. This method is called automatically by the map movement manager. From the moment when [IMapAction.begin](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IMapAction.md#begin) is called, the movement manager listens for [IMapAction.event:tick](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IMapAction.md#event-tick) and [IMapAction.event:end](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IMapAction.md#event-end) and executes them.

Inherited from [IMapAction](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IMapAction.md#begin). ||
|| [end](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IMapAction.md#end)() | | Stops movement.

Inherited from [IMapAction](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IMapAction.md#end). ||
|| [isActive](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/map.action.Single.md#isActive)() | Boolean | Checks whether map movement is being performed at this moment.||
|#

## Methods details {#method_detail}

### isActive {#isActive}

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

Checks whether map movement is being performed at this moment.

**Returns** true if the movement is currently being performed by the map, otherwise false.

[*star]: Mandatory parameter/option.