Документация

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

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

  1. gml:Point — геометрическая точка. Используется в том случае, когда форма и размеры географического объекта неважны. Местоположение точки задаётся географическими координатами.
  2. gml:LineString — ломаная (линия). Определяется с помощью задания географических координат её вершин.
  3. gml:LinearRing — замкнутая ломаная (линия). Определяется с помощью задания географических координат её вершин. Автоматически достраивается до замкнутой линии путём соединения последней и первой вершин.
    Примечание. Стандарт GML предполагает, что координаты последней и первой вершин замкнутых ломаных должны совпадать. Автоматическое замыкание ломаных является особенностью JavaScript API Яндекс.Карт.
  4. gml:Polygon — многоугольник. Фигура, внешняя и внутренние границы которой являются замкнутыми ломаными. Определяется с помощью задания географических координат вершин ломаных линий, являющихся границами многоугольника. Все ломаные автоматически достраиваются до замкнутых путём соединения первых и последних вершин.

Примечание. Координаты точек указываются в последовательности «долгота, широта».

Все перечисленные элементы могут быть отображены встроенными средствами JavaScript API.

Ещё одним видом географических данных является описанный прямоугольник. Описанным прямоугольником объекта (коллекции) называется прямоугольник, внутри которого находится географический объект (все объекты коллекции).

Для задания такого прямоугольника используется элемент gml:boundedBy. Если этот элемент находится внутри элементов ymaps:GeoObject и ymaps:GeoObjectCollection, он несёт чисто информационную нагрузку и непосредственно не влияет на отображение объектов на карте. Если элемент gml:boundedBy находится внутри элемента repr:View, он определяет область показа карты.