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

# Структура YMapsML

YMapsML-документы состоят из элементов, принадлежащих пяти пространствам имён: [https://maps.yandex.ru/ymaps/1.x](https://geocode-maps.yandex.ru/docs/schemas/ymaps/1.x), [https://maps.yandex.ru/representation/1.x](https://geocode-maps.yandex.ru/docs/schemas/representation/1.x), [http://www.opengis.net/gml](http://www.opengis.net/gml), [https://maps.yandex.ru/attribution/1.x](https://geocode-maps.yandex.ru/docs/schemas/attribution/1.x) и [http://www.w3.org/2005/Atom](http://www.w3.org/2005/Atom). Будем полагать, что этим пространствам имён соответствуют префиксы `ymaps`, `repr`, `gml`, `attr` и `atom` соответственно, и в дальнейшем будем идентифицировать пространства имён по их префиксам.

Ниже приведена таблица исходных пространств имён:

#|
|| **Namespace** | **URL схемы** | **Определение** ||
|| ymaps | [https://geocode-maps.yandex.ru/docs/schemas/ymaps/1.x](https://geocode-maps.yandex.ru/docs/schemas/ymaps/1.x) | Язык для представления географических данных в виде абстрактных географических объектов и их совокупностей — коллекций. ||
|| gml | [http://www.opengis.net/gml](http://www.opengis.net/gml) | GML – стандарт для описания географии. ||
|| repr | [https://geocode-maps.yandex.ru/docs/schemas/representation/1.x](https://geocode-maps.yandex.ru/docs/schemas/representation/1.x) | Содержит правила отображения географических объектов на картах Яндекса. ||
|| attr | [https://geocode-maps.yandex.ru/docs/schemas/attribution/1.x](https://geocode-maps.yandex.ru/docs/schemas/attribution/1.x) | Содержит информацию о поставщиках сведений об организациях, показываемых на картах Яндекса. ||
|| atom | [http://www.w3.org/2005/Atom](http://www.w3.org/2005/Atom) | Atom - формат синдикации, позволяющий описывать наборы веб-ресурсов. ||
|#

Каждый элемент YMapsML содержит в себе один или несколько элементов из указанных пространств имён либо текст, который в общем случае может включать в себя HTML-код. HTML-разметка всегда «экранируется», то есть отображается в браузере в виде текста. Исключение составляет HTML-код, содержащийся в элементе [gml:description](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-description.md) и элементе [repr:text](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/representation-text.md), находящимся внутри [repr:Template](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/representation-Template.md). Такой код интерпретируется браузером и выводится в форматированном виде.

Рассмотрим структуру YMapsML-документа.

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

Корневым элементом документа является элемент [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), один элемент [ymaps:GeoObjectCollection](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/ymaps-GeoObjectCollection.md) и один элемент [repr:Representation](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/representation-Representation.md). Любой из этих элементов может отсутствовать, как могут отсутствовать, впрочем, и все три элемента. Последний случай несколько экзотичен. «Пустой» документ используется обычно в виде заготовки, предполагающей наполнение в дальнейшем.

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

YMapsML-документ, приведённый в качестве примера в разделе [Использование YMapsML](https://yandex.ru/dev/maps/ymapsml/doc/ru/guide/concepts/usage.md), содержит элемент [ymaps:GeoObjectCollection](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/ymaps-GeoObjectCollection.md), но не содержит элемента [repr:Representation](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/representation-Representation.md). Таким образом, при отображении этого документа средствами JavaScript API параметры отображения карты и внешний вид географических объектов будут определены автоматически.