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

# Задание фигуры активной области HTML макету метки

<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_shape/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/q57k55?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/Placemark">Placemark</a>,
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/templateLayoutFactory">templateLayoutFactory</a>
</div>
    В данном примере создаются три метки со своими HTML макетами. <br/>
    Создание своих макетов происходит при помощи фабрики макетов. <br/>
    Всем меткам задаются разные фигуры активных областей: прямоугольник, круг и полигон. <br/>
<br/>
    Метка, чтобы ловить события мышки, использует <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/about-hotspots">активную область</a>. <br/>
    По умолчанию при задании своего HTML макета фигура активной области не задается, и её нужно задать самостоятельно.<br/>
    Это можно сделать при помощи опции метки iconShape в виде <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometryJson">JSON описания геометрии</a>.

{% list tabs %}

-   index.html

    ```html
    <!DOCTYPE html>
    <html>
        <head>
            <title>Задание фигуры активной области HTML макету метки</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>
    ```

-   placemark_shape.js

    ```js
    ymaps.ready(function () {
        var map = new ymaps.Map("map", {
            center: [55.7, 37.6],
            zoom: 10,
            controls: [],
        });

        // Создание метки с квадратной активной областью.
        var squareLayout = ymaps.templateLayoutFactory.createClass(
            '<div class="placemark_layout_container"><div class="square_layout">$</div></div>'
        );

        var squarePlacemark = new ymaps.Placemark(
            [55.725118, 37.682145],
            {
                hintContent: "Метка с прямоугольным HTML макетом",
            },
            {
                iconLayout: squareLayout,
                // Описываем фигуру активной области "Прямоугольник".
                iconShape: {
                    type: "Rectangle",
                    // Прямоугольник описывается в виде двух точек - верхней левой и нижней правой.
                    coordinates: [
                        [-25, -25],
                        [25, 25],
                    ],
                },
            }
        );
        map.geoObjects.add(squarePlacemark);

        // Создание метки с круглой активной областью.
        var circleLayout = ymaps.templateLayoutFactory.createClass(
            '<div class="placemark_layout_container"><div class="circle_layout">#</div></div>'
        );

        var circlePlacemark = new ymaps.Placemark(
            [55.783202, 37.605584],
            {
                hintContent: "Метка с круглым HTML макетом",
            },
            {
                iconLayout: circleLayout,
                // Описываем фигуру активной области "Круг".
                iconShape: {
                    type: "Circle",
                    // Круг описывается в виде центра и радиуса
                    coordinates: [0, 0],
                    radius: 25,
                },
            }
        );
        map.geoObjects.add(circlePlacemark);

        // Создание метки со сложной фигурой активной области.
        var polygonLayout = ymaps.templateLayoutFactory.createClass(
            '<div class="placemark_layout_container"><div class="polygon_layout">!</div></div>'
        );

        var polygonPlacemark = new ymaps.Placemark(
            [55.662693, 37.558416],
            {
                hintContent: "HTML метка сложной формы",
            },
            {
                iconLayout: polygonLayout,
                // Описываем фигуру активной области "Полигон".
                iconShape: {
                    type: "Polygon",
                    // Полигон описывается в виде трехмерного массива. Массив верхнего уровня содержит контуры полигона.
                    // Первый элемента массива - это внешний контур, а остальные - внутренние.
                    coordinates: [
                        // Описание внешнего контура полигона в виде массива координат.
                        [
                            [-28, -76],
                            [28, -76],
                            [28, -20],
                            [12, -20],
                            [0, -4],
                            [-12, -20],
                            [-28, -20],
                        ],
                        // , ... Описание внутренних контуров - пустых областей внутри внешнего.
                    ],
                },
            }
        );
        map.geoObjects.add(polygonPlacemark);
    });
    ```

{% endlist %}
