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

# map.Hint

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

Менеджер хинта карты. У каждой карты уже есть собственный менеджер хинта, доступный как map.hint. В один момент на карте может быть открыт только один хинт, управляемый менеджером. Не создавайте экземпляры этого класса без необходимости.

**См.:** Map.hint

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

```javascript
map.Hint(map)
```

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `map`[*](*parametr) | — | Тип: [Map](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Map.md)

Ссылка на объект карты. ||
|#

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

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

#|
|| **Имя** | **Описание** ||
|| [hide](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Hint.md#hide) | Событие, возникающее после скрытия hint-а. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). ||
|| [show](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Hint.md#show) | Событие, возникающее после отображения hint-а на карте. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• hint - ссылка на экземпляр класса [Hint](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Hint.md). ||

|#

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

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [hide](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Hint.md#hide)([callback](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Hint.md#hide-param-callback), [urgently](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Hint.md#hide-param-urgently)) |  | Скрывает хинт. ||
|| **Имя:** [isShown](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Hint.md#isShown)() | Boolean | Проверяет состояние хинта. ||
|| [show](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Hint.md#show)([position](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Hint.md#show-param-position)[, [data](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Hint.md#show-param-data)[, [options](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Hint.md#show-param-options)]]) | [Hint](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Hint.md) | Показывает хинт на карте в заданной точке. Возвращает экземпляр класса [Hint](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Hint.md) ||
|#

## Описание событий {#description-events}

### hide

Событие, возникающее после скрытия hint-а. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md).
### show

Событие, возникающее после отображения hint-а на карте. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• hint - ссылка на экземпляр класса [Hint](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Hint.md).

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

### hide

```javascript
{} hide(callback, urgently)
```

Скрывает хинт.

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

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

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

### isShown

```javascript
{Boolean} isShown()
```

Проверяет состояние хинта.

**Returns** true - если хинт в данный момент открыт, false - в обратном случае.

**Пример:**

```javascript
// Открываем хинт (по таймауту в 1 сек.)
var hint = myMap.hint.show(myMap.getCenter(), { content: 'loading' }, { showTimeout: 1000 });

// Выполняем AJAX-запрос:
$.getJSON('hint-data.json')
    .success(function (data) {
        // Обновляем данные если хинт открыт, иначе вешаемся на событие открытия.
        if (myMap.hint.isShown()) {
            hint.setData(data);
        } else {
            myMap.hint.events.add('show', function () {
                hint.setData(data);
            });
        }
    });
```

### show

```javascript
{Hint} show(position[, data[, options]])
```

Показывает хинт на карте в заданной точке. Возвращает экземпляр класса [Hint](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Hint.md)

**Returns** экземпляр хинта.

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

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

Позиция привязки хинта. ||
|| `data` | — | Тип: Object\|String

Данные для отображения. ||
|| `options` | — | Тип: Object

Опции хинта. ||
|#


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

**Пример:**

```javascript
// Показываем в хинте координаты клика на карте.
geoMap.events.add('click', function (e) {
    geoMap.hint.show(e.get('coordPosition'), e.get('coordPosition').join(', '), {
        showTimeout: false,
        hideTimeout: 500
    });
});
```

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