> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/maps/ymapsml/doc/ru/llms.txt

# Обзор YMapsML

YMapsML представляет собой XML-язык, предназначенный для описания и отображения различных географических объектов в сервисе Яндекс.Карты.

Для получения сведений о работе с YMapsML средствами JavaScript API Яндекс.Карт см. [Отображение объектов из KML, GPX и YMapsML](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/geoxml). YMapsML также используется в ответе HTTP-геокодера, см. [Ответ геокодера](https://yandex.ru/dev/geocode/doc/ru/response?).

YMapsML основан на стандарте XML и является расширением стандарта GML.

![](../_images/ymaps.png)

Корневым элементом YMapsML-документа является [ymaps:ymaps](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/ymaps-ymaps.md). В атрибутах этого элемента описываются пространства имен XML и используемые XSD-схемы.

Элемент [ymaps:ymaps](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/ymaps-ymaps.md), в свою очередь, может содержать в себе несколько тегов, служащих контейнерами для различных данных или групп данных, отображаемых на карте.

#### [attr:Attribution](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/attribution-Attribution.md)
 
:   Является контейнером для тега [attr:Source](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/attribution-Source.md).
    #### [attr:Source](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/attribution-Source.md)
     
    :   Содержит информацию о поставщике сведений, представленных в YMapsML-документе.

#### [repr:Representation](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/representation-Representation.md)
 
:   Является контейнером для тегов [repr:View](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/representation-View.md), [repr:Style](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/representation-Style.md) и [repr:Template](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/representation-Template.md).

    #### [repr:View](../reference/representation-View.md)
     
    :   Предназначен для задания начального состояния карты. С его помощью можно задать центр карты, ее тип и начальный масштаб. Элемент [repr:View](../reference/representation-View.md) может присутствовать в YMapsML-документе не более одного раза.
    
    #### [repr:Style](../reference/representation-Style.md)
     
    :   Описывает стили отображаемых на карте объектов. С помощью стилей, в частности, можно описать то, как будут выглядеть на карте метки, линии и другие объекты. Элементы [repr:Style](../reference/representation-Style.md) могут присутствовать в YMapsML-документе в любом количестве.
    
    #### [repr:Template](../reference/representation-Template.md)
     
    :   Предназначен для описания шаблонов, на основе которых строится HTML-верстка различных объектов карты. Элементы [repr:Template](../reference/representation-Template.md) могут присутствовать в YMapsML-документе в любом количестве.

#### [ymaps:GeoObjectCollection](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/ymaps-GeoObjectCollection.md)
 
:   Является контейнером, содержащим в себе описания объектов, помещаемых на карту. С помощью данного элемента можно задавать общие для набора географических объектов свойства, например, стили. Элемент [ymaps:GeoObjectCollection](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/ymaps-GeoObjectCollection.md) может содержать вложенные элементы [ymaps:GeoObjectCollection](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/ymaps-GeoObjectCollection.md), но в элементе [ymaps:ymaps](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/ymaps-ymaps.md) может присутствовать не более одного раза.

В общем виде, YMapsML-документ выглядит следующим образом:

```xml
<?xml version="1.0" encoding="utf-8"?>
<ymaps:ymaps xmlns:ymaps="https://maps.yandex.ru/ymaps/1.x"
             xmlns:gml="http://www.opengis.net/gml"
             xmlns:repr="https://maps.yandex.ru/representation/1.x"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="https://maps.yandex.ru/schemas/ymaps/1.x/ymaps.xsd">
    <repr:Representation>
         <repr:View>
            <repr:mapType>HYBRID</repr:mapType>
            <gml:boundedBy>
                <gml:Envelope>
                    <gml:lowerCorner>37.63 45.75</gml:lowerCorner>
                    <gml:upperCorner>47.63 55.75</gml:upperCorner>
                </gml:Envelope>
            </gml:boundedBy>
        </repr:View>

        <repr:Style gml:id="customStyle">
            <repr:parentStyle>default#greenPoint</repr:parentStyle>
            <repr:iconStyle>
                <repr:href>https://info.maps.yandex.net/api/i/steelblue/dot.png</repr:href>
                <repr:size x="26" y="46"/>
                <repr:offset x="-22" y="-46"/>
                <repr:shadow>
                    <repr:href>https://info.maps.yandex.net/api/i/dot_shadow.png</repr:href>
                    <repr:size x="25" y="23"/>
                    <repr:offset x="0" y="-25"/>
                </repr:shadow>
            </repr:iconStyle>

            <repr:lineStyle>
                <repr:strokeColor>12345678</repr:strokeColor>
                <repr:strokeWidth>5</repr:strokeWidth>
            </repr:lineStyle>

            <repr:balloonContentStyle>
                <repr:template>#customTemplate</repr:template>
            </repr:balloonContentStyle>
        </repr:Style>

        <repr:Template gml:id="customTemplate">
            <repr:text><![CDATA[<div style="color:green">$[description]</div>]]></repr:text>
        </repr:Template>
    </repr:Representation>
    <Attribution>
        <Source id="novosib">
            <author>
                <name>Поисковая система по товарам и услугам БИС 077</name>
                <uri>http://www.bis077.ru</uri>
            </author>
         </Source>
     </Attribution>
    <ymaps:GeoObjectCollection>
        <ymaps:style>#customStyle</ymaps:style>
        <gml:featureMembers>
            <ymaps:GeoObject>
                <gml:description>Описание</gml:description>
                <gml:Point>
                    <gml:pos>37.63 55.75</gml:pos>
                </gml:Point>
            </ymaps:GeoObject>

            <ymaps:GeoObject>
                <gml:LineString>
                    <gml:pos>70 55</gml:pos>
                    <gml:pos>80 70</gml:pos>
                    <gml:pos>120 30</gml:pos>
                </gml:LineString>
            </ymaps:GeoObject>
        </gml:featureMembers>
    </ymaps:GeoObjectCollection>
</ymaps:ymaps>
```