Задание геометрических и географических данных
В разделе Геометрические и географические данные перечислены элементы, с помощью которых определяются геометрические свойства географических объектов. Каждому элементу соответствует геометрическая фигура и геообъект, использующийся для отображения этой фигуры на карте.
Привязка геометрической фигуры к местности осуществляется с помощью задания координат соответствующих точек. Для геометрической точки задаются её координаты, для ломаной — координаты её вершин, для многоугольника — координаты вершин замкнутых ломаных, являющихся его внешней и внутренними границами.
Координаты точек и вершин ломаных задаются с помощью элементов 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>
Ломаная и замкнутая ломаная
Для задания вершин ломаной используются два или более элементов 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>
<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>
Многоугольник
Внешняя граница многоугольника представляет собой замкнутую ломаную, для описания которой используется элемент 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.