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

В разделе Геометрические и географические данные перечислены элементы, с помощью которых определяются геометрические свойства географических объектов. Каждому элементу соответствует геометрическая фигура и геообъект, использующийся для отображения этой фигуры на карте.

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

Координаты точек и вершин ломаных задаются с помощью элементов gml:pos и gml:posList. Для указания координат, определяющих область показа и описанный прямоугольник, используются элементы gml:lowerCorner и gml:upperCorner.

Для задания координат точки последовательно указываются её долгота и широта, разделённые пробелом. Например, <gml:pos>55.0298 82.9197</gml:pos>. Таким образом задаются координаты точек, описываемых с помощью элементов gml:pos, gml:lowerCorner и gml:upperCorner. При задании координат последовательности точек с помощью элемента gml:posList пары координат точек также разделяются пробелом. Например, <gml:posList>55.0298 82.9197 55.0496 82.9694</gml:posList>.

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

Для определения координат геометрической точки используется элемент gml:pos.

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

Пример:

YMapsML-файл: http://api.yandex.ru/maps/ymapsml/examples/xml/geopoint.xml.

HTML-страница: http://api.yandex.ru/maps/ymapsml/examples/geopoint.html.

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

Для задания вершин ломаной используются два или более элементов gml:pos или элемент gml:posList.

<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>

Пример:

YMapsML-файл: http://api.yandex.ru/maps/ymapsml/examples/xml/linestring.xml.

HTML-страница: http://api.yandex.ru/maps/ymapsml/examples/linestring.html.

<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>

Пример:

YMapsML-файл: http://api.yandex.ru/maps/ymapsml/examples/xml/linearring.xml.

HTML-страница: http://api.yandex.ru/maps/ymapsml/examples/linearring.html.

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

Внешняя граница многоугольника представляет собой замкнутую ломаную, для описания которой используется элемент gml:LinearRing.

<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 находится внутри контейнера gml:exterior. Это отражает тот факт, что многоугольник может иметь не только внешнюю, но и внутреннюю границу (полость внутри многоугольника). Причём количество внутренних полостей неограничено.

Внутренняя граница многоугольника также задаётся с помощью замкнутой ломаной. При этом элемент gml:LinearRing заключается в контейнер gml:interior. В текущей версии API Яндекс.Карт содержимое элемента gml:interior не интерпретируется. Обработку внутренних границ многоугольников предполагается включить в одну из следующих версий API.

Пример:

YMapsML-файл: http://api.yandex.ru/maps/ymapsml/examples/xml/lpolygon.xml.

HTML-страница: http://api.yandex.ru/maps/ymapsml/examples/polygon.html.

Область показа и описанный прямоугольник

Область показа карты и описанный прямоугольник географического объекта или коллекции описываются с помощью элемента gml:boundedBy. Данные области определяются с помощью задания координат вершин левого нижнего и правого верхнего углов.

Для задания координат вершины левого нижнего угла используется элемент gml:lowerCorner, правого верхнего — gml:upperCorner.

<ymaps:GeoObject>
    <gml:name>Ломаная линия</gml:name>
    <gml:description>Для географического объекта и коллекции можно задать описанный прямоугольник</gml:description>
    <gml:boundedBy>
        <gml:Envelope>
            <gml:lowerCorner>45 60</gml:lowerCorner>
            <gml:upperCorner>30 50</gml:upperCorner>
        </gml:Envelope>
    </gml:boundedBy>
    <gml:LineString>
        <gml:pos>32.199411 58.601185</gml:pos>
        <gml:pos>32.189411 58.595185</gml:pos>
    </gml:LineString>
</ymaps:GeoObject>

Пример задания области показа карты приведён в разделе Карта и её параметры.