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

# traffic.provider.Actual

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

Провайдер актуальных пробок. Доступен в хранилище провайдеров под ключом 'traffic#actual'.

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

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

```javascript
traffic.provider.Actual([options[, state]])
```

Создает провайдер актуальных пробок.

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

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

Опции провайдера. Опции для слоев провайдера задаются через опции глобальной коллекции слоев [Map.layers](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#layers).
- Опции для картиночного слоя [Layer](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Layer.md) задаются с префиксом 'trafficImage';
- Опции для картиночного слоя [hotspot.Layer](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/hotspot.Layer.md) задаются с префиксом 'trafficJam';
- Опции для слоя инфоточек задаются с префиксом 'trafficInfo'. Слой инфоточек является экземпляром класса [hotspot.Layer](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/hotspot.Layer.md). ||
|| [`options.autoUpdate`](#param-options.autoUpdate) | true | Тип: Boolean

Флаг, включающий автоматическое обновление данных о пробках. Автоматическое обновление происходит только в том случае, если на карте каждые 4 минуты возникает событие mousemove. Если событие не возникает, пробки перестают обновляться до появления нового события. ||
|| [`state`](#param-state) | — | Тип: Object

Состояние провайдера. ||
|| [`state.infoLayerShown`](#param-state.infoLayerShown) | false | Тип: Boolean

Флаг, включающий отображение слоя дорожных событий. ||
|#


**Пример:**

```javascript
// Создадим провайдер пробок "сейчас" с включенным слоем дорожных событий
// и разместим его на карте.
var actualProvider = new ymaps.traffic.provider.Actual({}, {infoLayerShown: true});
actualProvider.setMap(myMap);

// Запретим показ балунов по клику для слоя инфоточек.
myMap.layers.options.set({
    // Название опции сформировано из опции хотспотного слоя
    // 'openBalloonOnClick' путем добавления префикса 'trafficInfo'.
    trafficInfoOpenBalloonOnClick: false
});

// ...
// Удаление провайдера с карты.
actualProvider.setMap(null);
```

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

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

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

Унаследовано от [ICustomizable](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#options). ||
|| [state](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/traffic.provider.Actual.md#state) | [data.Manager](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/data.Manager.md) | Состояние провайдера. Имена полей, доступных через метод data.Manager.get:
- isInited - признак, готов ли провайдер предоставлять данные;
- infoLayerShown - признак, показан ли слой дорожных событий;
- timestamp - текущее время во временной зоне UTC+0 в секундах;
- localtime - локальное время, для которого сервер в текущий момент отдает данные, в формате 'ЧЧ:ММ';
- level - уровень загруженности дорог в баллах - от 0 до 10.
- isotime - строка, содержащая текущую дату в формате "YYYY-MM-DDThh:mm:ss±hhmm". ||
|#

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

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

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

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

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [getMap](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ITrafficProvider.md#getMap)() | [Map](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md)\|null | Возвращает ссылку на карту.

Унаследован от [ITrafficProvider](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ITrafficProvider.md#getMap). ||
|| [setMap](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ITrafficProvider.md#setMap)([Reference](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ITrafficProvider.md#setMap-param-Reference)) ||
|| [update](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/traffic.provider.Actual.md#update)() | Шлёт запрос на обновление пробок. ||
|#

## Описание полей {#field_detail}

### state {#state}

```javascript
{data.Manager} state
```

Состояние провайдера. Имена полей, доступных через метод data.Manager.get:
- isInited - признак, готов ли провайдер предоставлять данные;
- infoLayerShown - признак, показан ли слой дорожных событий;
- timestamp - текущее время во временной зоне UTC+0 в секундах;
- localtime - локальное время, для которого сервер в текущий момент отдает данные, в формате 'ЧЧ:ММ';
- level - уровень загруженности дорог в баллах - от 0 до 10.
- isotime - строка, содержащая текущую дату в формате "YYYY-MM-DDThh:mm:ss±hhmm".

**Пример:**

```javascript
var actualProvider = new ymaps.traffic.provider.Actual();
actualProvider.setMap(myMap);
actualProvider.state.events.add('change', function () {
    if (actualProvider.state.get('isInited')) {
        alert('Провайдер готов предоставлять данные.');    }});
```

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

### update {#update}

```javascript
{} update()
```

Шлёт запрос на обновление пробок.

**Пример:**

```javascript
var trafficControl = new ymaps.control.TrafficControl({shown: true});
map.controls.add(trafficControl);
function updateProvider () {
     trafficControl.getProvider('traffic#actual').update();
}
// Будем слать запрос на обновление данных каждые 4 минуты.
window.setInterval(updateProvider, 4 * 60 * 1000);
```

<!-- XLIFF_FARM_Y2YxZTJk_CACHING -->