---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/examples/cases/geoxml_display.md
---
# Отображение YMapsML, KML

<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-0/examples/1/out/s3-cases/ru/geoxml_display/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/ry5lpq?file=index.html">Open in CodeSandbox</a>

<div id="doc">
<div id="references">
    <a href="https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ready">ready</a>,
    <a href="https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Map">Map</a>,
    <a href="https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.SmallZoomControl">control.SmallZoomControl</a>,
    <a href="https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.GeoObjects">map.GeoObjects</a>,
    <a href="https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoXml.load">geoXml.load</a>
</div>
<p>
    API Яндекс.Карт позволяет <a href="https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/dg/concepts/geoxml">загружать XML-файлы
    с географическими данными</a> в форматах YMapsML и KML.
</p>
<p>
    Для загрузки данных используется функция <a href="https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoXml.load">geoXml.load</a>.
</p>
<p>
    Обратите внимание, что функция <a href="https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geoXml.load">geoXml.load</a> не входит в стандартный пакет package.standard,
    для её использования необходимо подключить <a href="https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/packages#package.geoXml">package.geoXml</a>.
</p>
</div>

{% list tabs %}

-   index.html

    ```html
    <!DOCTYPE html>

    <html>
        <head>
            <title>Примеры. Отображение YMapsML, KML на карте</title>
            <meta
                http-equiv="Content-Type"
                content="text/html; charset=utf-8"
            />
            <!-- Обратите внимание на подключение пакета package.geoXml -->
            <!--
                Укажите свой API-ключ. Тестовый ключ НЕ БУДЕТ работать на других сайтах.
                Получить ключ можно в Кабинете разработчика: https://developer.tech.yandex.ru/keys/
            -->
            
            

            
        </head>

        <body>
            <div id="map" style="width:400px; height:300px"></div>
            <input
                type="button"
                value="Показать пример YMapsML"
                class="load-ymapsml"
            />
            <input type="button" value="Показать пример KML" class="load-kml" />
        </body>
    </html>
    ```

-   geoxml_display.js

    ```js
    ymaps.ready(init);

    function init() {
        var myMap = new ymaps.Map("map", {
                center: [55.76, 37.64], // Москва
                zoom: 2,
            }),
            ymapsmlButton = $(".load-ymapsml"),
            kmlButton = $(".load-kml");

        // Отключение кеширования атрибута disabled в Firefox.
        ymapsmlButton.get(0).disabled = false;
        kmlButton.get(0).disabled = false;

        myMap.controls.add("smallZoomControl");

        // При нажатии на кнопку загружаем соответствующий XML-файл.
        // и отображаем его данные на карте.
        ymapsmlButton.click(function (e) {
            ymaps.geoXml
                .load(
                    "http://maps.yandex.ru/export/usermaps/93jfWjoXws37exPmKH-OFIuj3IQduHal/"
                )
                .then(onGeoXmlLoad);
            e.target.disabled = true;
        });
        kmlButton.click(function (e) {
            ymaps.geoXml
                .load("http://openflights.org/demo/openflights-sample.kml")
                .then(onGeoXmlLoad);
            e.target.disabled = true;
        });

        // Обработчик загрузки XML-файлов.
        function onGeoXmlLoad(res) {
            myMap.geoObjects.add(res.geoObjects);
            if (res.mapState) {
                res.mapState.applyToMap(myMap);
            }
        }
    }
    ```

{% endlist %}
