---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/en/v2-1/examples/cases/ymapsml_simpleobject.md
  - https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/examples/cases/ymapsml_simpleobject.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/ymapsml_simpleobject/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/8jmq9f?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/geoXml.load">geoXml.load</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/GeoObjectCollection">GeoObjectCollection</a>
</div>
<p>
    <a href="https://yandex.ru/dev/maps/ymapsml/doc/ru/guide/concepts/About">YMapsML</a> - язык описания географических объектов.
</p>
<p>
    Каждому географическому объекту в YMapsML ставятся в соответствие геометрическая фигура и геообъект, используемый для
    отображения этой фигуры на карте. Описание фигур и их привязка к географическим координатам задаются
    в соответствующих YMapsML-элементах. Для описания фигуры "точка" предназначен элемент <a href="https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-Point">gml:Point</a>.
    Для отображения точки на карте используется геообъект Placemark.
</p>
<p>
    Для загрузки YMapsML-данных предназначена функция <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/geoXml.load">geoXml.load</a>. После того как данные загрузятся, функция преобразует их в
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection">GeoObjectCollection</a> и затем передает в качестве параметра функции-обработчику. Коллекцию геообъектов GeoObjectCollection можно отобразить
    на карте.
</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>
    ```

-   ymapsml_simpleobject.js

    ```js
    ymaps.ready(init);

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

        // После того как данные YmapsMl-файла загрузятся, вызывается callback-функция.
        ymaps.geoXml.load("data.xml").then(
            function (res) {
                // Добавляем коллекцию геообъектов на карту.
                myMap.geoObjects.add(res.geoObjects);
            },
            function (error) {
                alert("При загрузке YMapsML-файла произошла ошибка: " + error);
            }
        );
    }
    ```

{% endlist %}
