---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/examples/cases/placemark_balloon.md
  - https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/examples/cases/placemark_balloon.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/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/placemark_balloon/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/l967q9?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/option.presetStorage">option.presetStorage</a>
</div>
<p>
    В данном примере на карту добавлена метка, при клике на которой открывается балун-панель с заданным содержимым.
</p>
<p>
    Для задания стиля метки из <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/option.presetStorage">набора встроенных стилей</a> используется опция <b>preset</b>.
    В API предустановлено пять различных стилей для меток (в скобках указаны соответствующие ключи):
    <ul>
       <li>Метки с текстом ('islands#icon');</li>
       <li>метки, тянущиеся под текст ('islands#stretchyIcon');</li>
       <li>метки с точкой в центре ('islands#dotIcon');</li>
       <li>метки в виде кругов ('islands#circleIcon');</li>
       <li>метки в виде кругов с точкой в центре ('islands#circleDotIcon').</li>
    </ul>
</p>
<p>
    Для каждого стиля на выбор предоставлено 16 цветов. API позволяет задавать меткам также собственные цвета для всех стилей, кроме 'islands#stretchyIcon'.
    Как задавать меткам собственные цвета см. в следующем <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/examples/cases/icon_customImage">примере</a>.
</p>

{% list tabs %}

-   index.html

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

-   placemark_balloon.js

    ```js
    ymaps.ready(function () {
        var myMap = new ymaps.Map("YMapsID", {
            center: [55.733835, 37.588227],
            zoom: 12,
            // Обратите внимание, что в API 2.1 по умолчанию карта создается с элементами управления.
            // Если вам не нужно их добавлять на карту, в ее параметрах передайте пустой массив в поле controls.
            controls: [],
        });

        var myPlacemark = new ymaps.Placemark(
            myMap.getCenter(),
            {
                balloonContentBody: [
                    "<address>",
                    "<strong>Офис Яндекса в Москве</strong>",
                    "<br/>",
                    "Адрес: 119021, Москва, ул. Льва Толстого, 16",
                    "<br/>",
                    'Подробнее: <a href="https://company.yandex.ru/">https://company.yandex.ru</a>',
                    "</address>",
                ].join(""),
            },
            {
                preset: "islands#redDotIcon",
            }
        );

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

{% endlist %}
