---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/examples/cases/balloon_and_hint.md
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/examples/cases/balloon_and_hint.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/llms.txt

# Балун и хинт

<iframe id="LIVE-EXAMPLE" style="width:100%;height: 400px;border-radius: 8px;border: 1px solid rgba(92, 94, 102, 0.14);" frameBorder="0" src="https://yastatic.net/s3/front-maps-static/maps-front-jsapi-v2-1/examples/2/out/s3-cases/ru/balloon_and_hint/index.html" allow="fullscreen"></iframe>

<a target="_blank" rel="noopener noreferrer" style="display: inline-block;margin-top: 10px;cursor: pointer;border-radius: 4px;padding: 9px 12px;background: #151515;color: white;text-decoration: none;font-weight: 500" href="https://codesandbox.io/p/sandbox/gn7xmx?file=index.html">Open in CodeSandbox</a>

<div id="references">
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ready">ready</a>,
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map">Map</a>,
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Balloon">map.Balloon</a>,
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Hint">map.Hint</a>,
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Placemark">Placemark</a>
</div>
<p>
   На карте можно отобразить
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/map#balloon_and_hint">балун и хинт</a>.
</p>
<p>
    Ссылки на менеджеры балуна и хинта содержатся в полях <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map#balloon">balloon</a>
    и <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map#hint">hint</a> объекта карты.
    Менеджеры реализованы в виде классов <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Balloon">map.Balloon</a> и <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Hint">map.Hint</a>,
    но <strong>создавать экземпляры этих классов самостоятельно не следует</strong>&#160;&#8212;
    используйте соответствующие поля объекта карты.
</p>
<p>
    Доступ к балуну и хинту имеют <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/geoobjects">геообъекты</a> и другие сущности на карте.
    C помощью <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject#constructor-summary">соответствующих свойств и опций</a>
    (префиксы <code>balloon</code> и <code>hint</code>) можно описать балун и хинт геообъекта/активной области.
    При этом координаты балуна и хинта будут вычисляться автоматически.
</p>

{% list tabs %}

-   index.html

    ```html
    <!DOCTYPE html>
    <html>
        <head>
            <title>Балун и хинт</title>
            <meta
                http-equiv="Content-Type"
                content="text/html; charset=utf-8"
            />
            <!--
            Укажите свой API-ключ. Тестовый ключ НЕ БУДЕТ работать на других сайтах.
            Получить ключ можно в Кабинете разработчика: https://developer.tech.yandex.ru/keys/
        -->
            
            
            
        </head>
        <body>
            <div id="map"></div>
        </body>
    </html>
    ```

-   balloon_and_hint.js

    ```js
    ymaps.ready(init);

    function init() {
        var myMap = new ymaps.Map(
                "map",
                {
                    center: [54.83, 37.11],
                    zoom: 5,
                },
                {
                    searchControlProvider: "yandex#search",
                }
            ),
            myPlacemark = new ymaps.Placemark([55.907228, 31.260503], {
                // Чтобы балун и хинт открывались на метке, необходимо задать ей определенные свойства.
                balloonContentHeader: "Балун метки",
                balloonContentBody: "Содержимое <em>балуна</em> метки",
                balloonContentFooter: "Подвал",
                hintContent: "Хинт метки",
            });

        myMap.geoObjects.add(myPlacemark);

        // Открываем балун на карте (без привязки к геообъекту).
        myMap.balloon.open([51.85, 38.37], "Содержимое балуна", {
            // Опция: не показываем кнопку закрытия.
            closeButton: false,
        });

        // Показываем хинт на карте (без привязки к геообъекту).
        myMap.hint.open(myMap.getCenter(), "Одинокий хинт без метки", {
            // Опция: задержка перед открытием.
            openTimeout: 1500,
        });
    }
    ```

{% endlist %}
