# Задание геометрических и географических данных

В разделе [Геометрические и географические данные](https://yandex.ru/dev/maps/ymapsml/doc/ru/guide/concepts/geodata.md) перечислены элементы, с помощью которых определяются геометрические свойства географических объектов. Каждому элементу соответствует геометрическая фигура и геообъект, использующийся для отображения этой фигуры на карте.

Привязка геометрической фигуры к местности осуществляется с помощью задания координат соответствующих точек. Для геометрической точки задаются её координаты, для ломаной — координаты её вершин, для многоугольника — координаты вершин замкнутых ломаных, являющихся его внешней и внутренними границами.

Координаты точек и вершин ломаных задаются с помощью элементов [gml:pos](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-pos.md) и [gml:posList](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-posList.md). Для указания координат, определяющих область показа и описанный прямоугольник, используются элементы [gml:lowerCorner](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-lowerCorner.md) и [gml:upperCorner](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-upperCorner.md).

Для задания координат точки последовательно указываются её долгота и широта, разделённые пробелом. Например, `<gml:pos>55.0298 82.9197</gml:pos>`. Таким образом задаются координаты точек, описываемых с помощью элементов [gml:pos](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-pos.md), [gml:lowerCorner](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-lowerCorner.md) и [gml:upperCorner](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-upperCorner.md). При задании координат последовательности точек с помощью элемента [gml:posList](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-posList.md) пары координат точек также разделяются пробелом. Например, `<gml:posList>55.0298 82.9197 55.0496 82.9694</gml:posList>`.

### Геометрическая точка

Для определения координат геометрической точки используется элемент [gml:pos](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-pos.md).

```
<ymaps:GeoObject>
    <gml:name>Точка на карте</gml:name>
    <gml:description>Здесь был Вася</gml:description>
    <gml:Point>
        <gml:pos>-119.755992 34.406958</gml:pos>
    </gml:Point>
</ymaps:GeoObject>
```

[Посмотреть пример в песочнице](https://tech.yandex.ru/maps/jsbox/2.1/ymapsml_simpleobject)

### Ломаная и замкнутая ломаная

Для задания вершин ломаной используются два или более элементов [gml:pos](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-pos.md) или элемент [gml:posList](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-posList.md).

```
<ymaps:GeoObject>
    <gml:name>Ломаная линия</gml:name>
    <gml:description>Координаты вершин ломаной можно определить с помощью двух или более элементов gml:pos</gml:description>
    <gml:LineString>
        <gml:pos>32.199411 58.601185</gml:pos>
        <gml:pos>32.189411 58.595185</gml:pos>
    </gml:LineString>
</ymaps:GeoObject>
```

[Посмотреть пример в песочнице](https://tech.yandex.ru/maps/jsbox/2.1/ymapsml_linestring)

```
<ymaps:GeoObject>
    <gml:name>Замкнутая ломаная линия</gml:name>
    <gml:description>Координаты вершин ломаной можно также определить и с помощью элемента gml:posList</gml:description>
    <gml:LinearRing>
        <gml:posList>37.178027 55.486953 38.040535 55.486953 38.040535 56.018499 37.178027 56.018499</gml:posList>
    </gml:LinearRing>
</ymaps:GeoObject>
```

[Посмотреть пример в песочнице](https://tech.yandex.ru/maps/jsbox/2.1/ymapsml_linearring)

### Многоугольник

Внешняя граница многоугольника представляет собой замкнутую ломаную, для описания которой используется элемент [gml:LinearRing](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-LinearRing.md).

```
<ymaps:GeoObject>
    <gml:name>Многоугольник</gml:name>
    <gml:description>Внешняя граница многоугольника представляет собой замнутую ломаную линию</gml:description>
    <gml:Polygon>
        <gml:exterior>
            <gml:LinearRing>
                <gml:posList>37.178027 55.486953 38.040535 55.486953 38.040535 56.018499 37.178027 56.018499</gml:posList>
            </gml:LinearRing>
        </gml:exterior>
    </gml:Polygon>
</ymaps:GeoObject>
```

В данном примере элемент [gml:LinearRing](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-LinearRing.md) находится внутри контейнера [gml:exterior](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-exterior.md). Это отражает тот факт, что многоугольник может иметь не только внешнюю, но и внутреннюю границу (полость внутри многоугольника). Причём количество внутренних полостей не ограничено.

Внутренняя граница многоугольника также задаётся с помощью замкнутой ломаной. При этом элемент [gml:LinearRing](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-LinearRing.md) заключается в контейнер [gml:interior](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-interior.md). В текущей версии API Яндекс.Карт содержимое элемента [gml:interior](https://yandex.ru/dev/maps/ymapsml/doc/ru/ref/reference/gml-interior.md) не интерпретируется. Обработку внутренних границ многоугольников предполагается включить в одну из следующих версий API.

[Посмотреть пример в песочнице](https://tech.yandex.ru/maps/jsbox/2.1/ymapsml_polygon)