---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/examples/cases/object_manager.md
  - https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/examples/cases/object_manager.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/object_manager/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/gfxl5v?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/ObjectManager">ObjectManager</a>,
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/objectManager.ObjectCollection">objectManager.ObjectCollection</a>,
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/objectManager.ClusterCollection">objectManager.ClusterCollection</a>,
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/objectManager.OverlayCollection">objectManager.OverlayCollection</a>
</div>
<p>
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ObjectManager">ObjectManager</a> - класс, позволяющий добавить на карту большое количество объектов
    без необходимости создавать и добавлять на карту метки по отдельности.
</p>
<p>
    Объекты, добавленные в ObjectManager, располагаются в коллекции ObjectManager.objects. Кластеры, образованные из
    добавленных меток, добавляются в коллекцию ObjectManager.clusters.
    Визуальное отображение меток создается по требованию асинхронно. Визуальным отображением меток и кластеров
    являются объекты, реализующие интерфейс <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IOverlay">IOverlay</a>. В частности, <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/overlay.Placemark">overlay.Placemark</a>.
    Оверлеи помещаются в коллекции ObjectManager.objects.overlays и ObjectManager.clusters.overlays соответственно.
</p>
<p>
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ObjectManager">ObjectManager</a> принимает описания меток в JSON формате. Метки могут кластеризоваться или показываться как есть.
    Если вы не используете кластеризацию, то метки будут показаны только в видимой области карты.
    Поскольку объекты хранятся в менеджере в виде JSON описаний и их визуальное отображение создается только по необходимости,
    этот способ добавления точек на карту работает быстрее, чем добавление меток на карту напрямую или через кластеризатор.
</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>
    ```

-   object_manager.js

    ```js
    ymaps.ready(init);

    function init() {
        var myMap = new ymaps.Map(
                "map",
                {
                    center: [55.76, 37.64],
                    zoom: 10,
                },
                {
                    searchControlProvider: "yandex#search",
                }
            ),
            objectManager = new ymaps.ObjectManager({
                // Чтобы метки начали кластеризоваться, выставляем опцию.
                clusterize: true,
                // ObjectManager принимает те же опции, что и кластеризатор.
                gridSize: 32,
                clusterDisableClickZoom: true,
            });

        // Чтобы задать опции одиночным объектам и кластерам,
        // обратимся к дочерним коллекциям ObjectManager.
        objectManager.objects.options.set("preset", "islands#greenDotIcon");
        objectManager.clusters.options.set(
            "preset",
            "islands#greenClusterIcons"
        );
        myMap.geoObjects.add(objectManager);

        $.ajax({
            url: "data.json",
        }).done(function (data) {
            objectManager.add(data);
        });
    }
    ```

{% endlist %}
