Static API карт 2ГИС

Static API позволяет показывать на веб-страницах и в приложениях статическую карту 2ГИС без использования JavaScript. Через параметры URL можно указать размер карты, её центр, уровень масштабирования и маркеры.

URL*: http://static.maps.2gis.com/1.0?

* — Есть поддержка https

Параметры

ИмяТипПримерОбязательныйОписание
center float,float center=37.632618,
55.7368		 Да, если на карте отсутствуют маркеры Долгота и широта центра карты (в градусах).
zoom integer zoom=14 Да, если на карте отсутствуют маркеры Уровень масштабирования карты (1—17).
size integer,
integer		 size=250,250 Да Ширина и высота запрашиваемого изображения карты (в пикселах) через запятую. Ограничения: от 100×100 до 1280×1280 пикселей.
markers

 float,float markers=
37.64272,55.7368,99
~37.632618,55.7361		 Нет Содержит описание одного или нескольких маркеров, которые требуется отобразить на карте.

Описания маркеров перечисляются через тильду (~).

Описание каждого маркера составляется по следующей схеме: {стиль},{долгота},{широта},{число 1-99}.

Если на карте присутствуют маркеры и отсутствует параметр center или zoom, тогда центр карты и уровень масштабирования подбираются автоматически так, чтобы все маркеры попали в видимую область карты.

Если параметры center и zoom указаны пользователем, тогда учитываются они и карта автоматически не позиционируется.

Описание стиля маркера

Название параметра Возможные значения Описание
тип маркера

rm - текущий стиль маркеров. Красные маленькие балунчики с цифрами от 1 до 100 (полный стиль для него rmrdm)

pm - новый стиль пин-маркера. Без цифр, но с различным размером и цветом.

 markers=pmgrs,37.62007,55.75363~38.62007,56.75 рисуем маркер типа nm
размер маркера

m - средние маркеры

l - большие маркеры

markers=pmgrm,37.62007,55.75363~38.62007,56.75 - рисуем маркер типа nm с размером m в заданных координатах

markers=pmgrl,37.62007,55.75363~38.62007,56.75 - рисуем маркер типа pm с размером l в заданных координатах
цвет маркера

bk - черный

bl - голубой

db - темно-голубой

dg - темно-зеленый

gn - зеленый

gr - серый

or - оранжевый

rd - красный

wh - белый

ye - желтый

markers=pmdbm,37.62007,55.75363~38.62007,56.75 - рисуем маркер типа pm с размером m и цветом db в заданных координатах

markers=pmgrm,37.62007,55.75363~38.62007,56.75 - рисуем маркер типа pm с размером m и цветом gr в заданных координатах

Примеры использования

Интерактивный пример

Карта без маркеров

Запрос: http://static.maps.2gis.com/1.0?center=82.911182,55.058883&zoom=15&size=500,350

Результат:

Маркер по умолчанию с уровнем масштабирования и без центра

Запрос: http://static.maps.2gis.com/1.0?zoom=15&size=500,350&markers=37.560504,55.714333

Результат:

Несколько маркеров красного цвета

Запрос: http://static.maps.2gis.com/1.0?size=500,400&markers=rmrdm,37.632618,55.7361~37.702618,55.7631~37.562618,55.7331~37.692618,55.7131

Результат:

Несколько маркеров красного цвета с номерами

Запрос: http://static.maps.2gis.com/1.0?size=500,400&markers=rmrdm,37.632618,55.7361,1~37.702618,55.7631,2~37.562618,55.7331,3~37.692618,55.7131,4

Результат: