---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/traffic.provider.Actual.md
---
# traffic.provider.Actual

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

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

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

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

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

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

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

Опции провайдера. Опции для слоев провайдера задаются через опции глобальной коллекции слоев [Map.layers](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Map.md#layers).

• Опции для картиночного слоя [Layer](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Layer.md) задаются с префиксом 'trafficImage';

• Опции для слоя хотспотов [hotspot.Layer](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/hotspot.Layer.md) задаются с префиксом 'trafficJam';

• Опции для слоя инфоточек задаются с префиксом 'trafficInfo'. Слой инфоточек является экземпляром класса hotspot.Layer. ||
|| `options.autoUpdate` | true | Тип: Boolean

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

Состояние провайдера. ||
|| `state.infoLayerShown` | false | Тип: Boolean

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

**Пример:**

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

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

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

## Поля {#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). ||
|| [options](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#options) | [IOptionManager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IOptionManager.md) | Менеджер опций.

Унаследовано от [ICustomizable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#options). ||
|| [state](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/traffic.provider.Actual.md#state) | [data.Manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/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}

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

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

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

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

Унаследован от [ITrafficProvider](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ITrafficProvider.md#getMap). ||
|| [setMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ITrafficProvider.md#setMap)([map](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ITrafficProvider.md#setMap-param-map)) |  | Устанавливает карту.

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

## Описание полей {#description-fields}

### 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('Провайдер готов предоставлять данные.');
    }
});
```
## Описание методов {#description-methods}

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