---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/examples/cases/polygon.md
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/examples/cases/polygon.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/polygon/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/2j8fr6?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/GeoObject">GeoObject</a>,
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Polygon">Polygon</a>,
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects">map.GeoObjects</a>
</div>
<p>
    Многоугольник представляет собой замкнутую фигуру, состоящую из набора последовательно соединенных вершин. Многоугольник может иметь внутренние контуры.
</p>
<p>
   Многоугольник может быть создан двумя способами: с помощью класса
   <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/geoobjects">GeoObject</a> с указанием типа геометрии "Многоугольник"
   либо с помощью вспомогательного класса <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/geoobjects#geometry">Polygon</a>.
</p>
<p>
    При создании многоугольника необходимо указать координаты его вершин. Также могут быть заданы <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject#constructor-summary">свойства</a> (например содержимое балуна или хинта) и <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject#constructor-summary">опции</a> (например цвет заливки или стиль контура) многоугольника.
</p>
<p>
    Для многоугольников доступен <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/geoobjects#visual_editing">визуальный редактор</a>. Ссылка на редактор содержится в поле <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObject#editor">editor</a> объекта-многоугольника.
</p>
<p>
    Многоугольники, наряду с другими геообъектами, можно объединять в <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/geoobjects#geoobject_collections">коллекции</a>.
</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>
    ```

-   polygon.js

    ```js
    ymaps.ready(init);

    function init() {
        var myMap = new ymaps.Map(
            "map",
            {
                center: [55.73, 37.75],
                zoom: 10,
            },
            {
                searchControlProvider: "yandex#search",
            }
        );

        // Создаем многоугольник, используя класс GeoObject.
        var myGeoObject = new ymaps.GeoObject(
            {
                // Описываем геометрию геообъекта.
                geometry: {
                    // Тип геометрии - "Многоугольник".
                    type: "Polygon",
                    // Указываем координаты вершин многоугольника.
                    coordinates: [
                        // Координаты вершин внешнего контура.
                        [
                            [55.75, 37.8],
                            [55.8, 37.9],
                            [55.75, 38.0],
                            [55.7, 38.0],
                            [55.7, 37.8],
                        ],
                        // Координаты вершин внутреннего контура.
                        [
                            [55.75, 37.82],
                            [55.75, 37.98],
                            [55.65, 37.9],
                        ],
                    ],
                    // Задаем правило заливки внутренних контуров по алгоритму "nonZero".
                    fillRule: "nonZero",
                },
                // Описываем свойства геообъекта.
                properties: {
                    // Содержимое балуна.
                    balloonContent: "Многоугольник",
                },
            },
            {
                // Описываем опции геообъекта.
                // Цвет заливки.
                fillColor: "#00FF00",
                // Цвет обводки.
                strokeColor: "#0000FF",
                // Общая прозрачность (как для заливки, так и для обводки).
                opacity: 0.5,
                // Ширина обводки.
                strokeWidth: 5,
                // Стиль обводки.
                strokeStyle: "shortdash",
            }
        );

        // Добавляем многоугольник на карту.
        myMap.geoObjects.add(myGeoObject);

        // Создаем многоугольник, используя вспомогательный класс Polygon.
        var myPolygon = new ymaps.Polygon(
            [
                // Указываем координаты вершин многоугольника.
                // Координаты вершин внешнего контура.
                [
                    [55.75, 37.5],
                    [55.8, 37.6],
                    [55.75, 37.7],
                    [55.7, 37.7],
                    [55.7, 37.5],
                ],
                // Координаты вершин внутреннего контура.
                [
                    [55.75, 37.52],
                    [55.75, 37.68],
                    [55.65, 37.6],
                ],
            ],
            {
                // Описываем свойства геообъекта.
                // Содержимое балуна.
                hintContent: "Многоугольник",
            },
            {
                // Задаем опции геообъекта.
                // Цвет заливки.
                fillColor: "#00FF0088",
                // Ширина обводки.
                strokeWidth: 5,
            }
        );

        // Добавляем многоугольник на карту.
        myMap.geoObjects.add(myPolygon);
    }
    ```

{% endlist %}
