Линии и многоугольники

С помощью ломаных линий и многоугольников на статической карте можно обозначить маршруты следования или границы объектов.

Ломаная линия состоит из набора вершин, последовательно соединенных отрезками прямой. Ломаная может иметь самопересечения. Если координаты первой и последней вершин ломаной совпадают, то эта ломаная называется замкнутой.

Многоугольник задается одной или несколькими замкнутыми ломаными.

Static API позволяет одновременно отобразить на карте не более 5 ломаных и многоугольников, при этом совокупное количество вершин фигур не должно превышать 100.

Внешний вид геометрической фигуры задается с помощью специального описания. Описание ломаной содержит данные о толщине и цвете линии, а описание многоугольника - данные о толщине и цвете линий обводки и цвете заливки (см. ниже).

Вершины всех фигур привязаны к географическим координатам.

Координаты вершин и внешний вид линий и многоугольников задаются с помощью параметра pl. Параметр содержит набор описаний всех фигур, отображаемых на карте. Описания фигур перечисляются через тильду (~):

pl = ОписаниеФигуры1~ОписаниеФигуры2~ОписаниеФигуры3

Описание ломаной имеет следующий формат:

с:{цвет линии},w:{толщина},{вершины}

Описание многоугольника дополнительно может содержать цвет заливки (параметр f):

с:{цвет линии},f:{цвет заливки},w:{толщина},{вершины}

Цвет линии

Шестнадцатиричное представление цвета линии в формате RGBA (вида 0xFFFFFFFF). Первые 6 символов задают цвет в системе RGB, последующие два - прозрачность линии. Значение прозрачности лежит в диапазоне от 00 (прозрачная) до FF (непрозрачная).

Например:

с:8822DDС0

Цвет заливки многоугольника

Используется тот же самый формат, что и для цвета ломаной (см. выше). Например:

f:00FF00A0

Для заливки многоугольника применяется алгоритм even-odd. То есть верно следующее правило: точка закрашивается, если луч, проведенный в бесконечность из этой точки, имеет нечетное количество пересечений с ребрами многоугольника.

Область пересечения нескольких многоугольников закрашивается всегда.

Толщина

Толщина линии (в пикселах).

w:8 

Если цвет и толщина не заданы, то используется сиреневая полупрозрачная линия толщиной 5 пикселов (8822DDС0).

Вершины

Координаты вершин ломаной задаются одним из следующих способов:

1. перечислением через запятую: Долгота1,Широта2,...,ДолготаN,ШиротаN;
2. в виде Base64-последовательности (требуется кодирование координат вершин).

Координаты вершин многоугольника, заданного одной замкнутой ломаной (первая и последняя вершины совпадают), указываются аналогичными способами.

Для того, чтобы задать многоугольник набором замкнутых ломаных, необходимо разделять последовательности вершин для каждой ломаной точкой с запятой: КоординатыВершинЛоманой1;...КоординатыВершинЛоманой2.

Примеры

• Ломаная
• Многоугольник, заданный одной ломаной
• Многоугольник, заданный набором ломаных
• Пересечение многоугольников

Ломаная

Ниже приведен пример запроса фрагмента карты Москвы с изображением пешеходного маршрута от станции метро "Марксистская" до здания по ул. Станиславского 21, строение 3. Вершины ломаной заданы перечислением координат вершин, цвет и ширина взяты по умолчанию:

http://static-maps.yandex.ru/1.x/?l=map&pl=37.656577,55.741176, \ 
37.656748,55.741419,37.655131,55.741814,37.658257,55.742524, \ 
37.659811,55.743066,37.659667,55.743233,37.659551,55.743603,37.659775, \ 
55.743928,37.662398,55.745281&key=API-ключ

Многоугольник, заданный одной ломаной

Ниже приведен пример запроса фрагмента карты Санкт-Петербурга с изображением границы стен Петропавловской крепости. Для обозначения границ использован многоугольник с красной линией обводки и светло-зеленой полупрозрачной заливкой. Вершины многоугольника заданы Base64-последовательностью, см. Кодирование вершин ломаной:

http://static-maps.yandex.ru/1.x/?l=30.315311,59.949641&z=15&l=map&size=470,450 \
&pl=c:ec473fFF,f:00FF00A0,w:7,coDOAVe-kgM2AgAAHQIAAOr8__-fAgAA5QkAALICAAC8AAAAuP \
___73-__9H____VQEAAHT____CBwAAvAMAAHD___-QAAAAFv___9z____c____MQAAAAEEAAAHAwAAX \
gUAADH____c____uP___8b-___3____YgAAAD7___8XCQAA6v___2MAAAC9AAAA1_7__x8AAAAAAAAA \
SQAAAC4KAAB-AQAAr____zT9__8WBQAA1_7__6b9__9P_v__dQIAAN_9__-H9v__qf3__-79__-9AAAA \
Xvv__wz-__8JAAAA0____3n___-8____yv___wkAAACi_v__dP___3kBAADb_v__yv3__wj-___z-v_ \
_XgAAAF7____vAAAAY_b__9z____3____Ov___6____9D____xfb__9v-__-HAAAAkgIAAJ37__9nAA \
AA&key=API-ключ

Многоугольник, заданный набором ломаных

Ниже приведен пример карты, на которой отображен многоугольник, заданный набором ломаных линий. Последовательности координат вершин ломаных разделены точкой с запятой.

http://static-maps.yandex.ru/1.x/?ll=37.620070,55.753630& \
pl=f:00FF00A0,37.610000,55.743630,37.610070,55.763630,37.630070,55.763630, \
37.630070,55.743630,37.610000,55.743630;37.600070,55.733630,37.600070, \
55.773630,37.640070,55.773630,37.640070,55.733630,37.600070, \
55.733630&l=map&key=API-ключ

Пересечение многоугольников

Ниже приведен пример карты, на которой отображены два пересекающихся многоугольника. Наборы параметров для каждого многоугольника разделены тильдой (~).

Область пересечения многоугольников закрашивается.

http://static-maps.yandex.ru/1.x/?l=map&pl=c:cd5b45,f:2222DDC0,  \
w:5,37.656705,55.741092,37.653551,55.742387,37.663805,55.744318, \
37.656705,55.741092~c:dc143c,f:8822DDC0,w:5,37.660286,55.743301, \
37.661831,55.745165,37.662947,55.743108,37.660286,55.743301&key=API-ключ