---
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_ajax.md
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/examples/cases/balloon_ajax.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_ajax/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/7fgrcq?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/Placemark">Placemark</a>
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/geocode">geocode</a>
</div>
<p>
    Содержимое балуна может подгружаться динамически. Для этого в callback-функции AJAX-запроса нужно всего лишь
    переопределить свойство геообъекта, отвечающее за содержимое балуна.
    Балун автоматически обновит своё содержимое и размеры.
</p>
<p>
    В качестве примера AJAX-запроса использован механизм <a href="https://yandex.ru/maps-api/docs/geocoder-api/index.html">геокодирования</a> в API.
</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_ajax.js

    ```js
    ymaps.ready(init);

    function init() {
        var myMap = new ymaps.Map(
                "map",
                {
                    center: [54.83, 37.11],
                    zoom: 5,
                },
                {
                    searchControlProvider: "yandex#search",
                }
            ),
            // Метка, содержимое балуна которой загружается с помощью AJAX.
            placemark = new ymaps.Placemark(
                [55.8, 37.72],
                {
                    iconContent: "Узнать адрес",
                    hintContent:
                        "Перетащите метку и кликните, чтобы узнать адрес",
                },
                {
                    // Запретим замену обычного балуна на балун-панель.
                    balloonPanelMaxMapArea: 0,
                    draggable: "true",
                    preset: "islands#blueStretchyIcon",
                    // Заставляем балун открываться даже если в нем нет содержимого.
                    openEmptyBalloon: true,
                }
            );

        // Обрабатываем событие открытия балуна на геообъекте:
        // начинаем загрузку данных, затем обновляем его содержимое.
        placemark.events.add("balloonopen", function (e) {
            placemark.properties.set(
                "balloonContent",
                "Идет загрузка данных..."
            );

            // Имитация задержки при загрузке данных (для демонстрации примера).
            setTimeout(function () {
                ymaps
                    .geocode(placemark.geometry.getCoordinates(), {
                        results: 1,
                    })
                    .then(function (res) {
                        var newContent = res.geoObjects.get(0)
                            ? res.geoObjects.get(0).properties.get("name")
                            : "Не удалось определить адрес.";

                        // Задаем новое содержимое балуна в соответствующее свойство метки.
                        placemark.properties.set("balloonContent", newContent);
                    });
            }, 1500);
        });

        myMap.geoObjects.add(placemark);
    }
    ```

{% endlist %}
