Примеры Static API | 2GIS Documentation

Примеры Static API

Чтобы просто отобразить область карты достаточно указать её размер, центр и масштаб.

Если на карте будут дополнительные объекты, то можно не указывать центр и масштаб, карта подстроится автоматически.

https://static.maps.2gis.com/1.0?s=880x300&c=55.05888,82.91118&z=15

Пустая карта


На карте можно отобразить точки в виде кругов или пинов, использовать нумерацию или различные цвета и размеры, а также собственные маркера.

Виды маркеров

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

https://static.maps.2gis.com/1.0?s=880x300&pt=55.71433,37.56050~k:p~c:rd~s:s&pt=55.70433,37.57050~k:c~c:gn~s:l

Предустановленные стили маркеров

Стили с нумерацией используют числа от 1 до 99, можно также выбрать пин или круг, но только в синем цвете и предустановленном размере.

https://static.maps.2gis.com/1.0?s=880x300&pt=55.71433,37.56050~n:1&pt=55.70433,37.57050~k:c~n:2

Стили маркеров с нумерацией

Можно использовать собственные маркера и указать адрес доступной картинки.

https://static.maps.2gis.com/1.0?s=880x300&pt=55.70433,37.57050~u:https%3A%2F%2Fimg.icons8.com%2Foffices%2F1x%2Fsound-recording-copyright.png

Кастомный маркер с URL

Также можно передать собственный маркер в base64.

https://static.maps.2gis.com/1.0?s=880x300&pt=55.70433,37.57050~b:iVBORw0KGgoAAAANSUhEUgAAAB4AAAAeCAMAAAAM7l6QAAABQVBMVEUAAAAAAP9Pe7lNd7NKe7VQeLdLeLRPfbVOerdMd7NQerVOeLZNerNPe7ROebZPebRPe7ZOebRNebZPe7NOebRNe7VQfLdRe7ZQe7dQfbdPfLhSfrlTf7pTfrlRfrlSf7lSfbhSfrpRfbhRfLdQfbhQfblRfblSfblRfrlSfrlRfrlSfbhQfbdRfbhQfLdQfbdRfblVgbtVgbxXhL5YhL5YhMBZhMBRfbhTgbtUgLtUgbtUgbxXhL9RfbhPe7dPe7ZPe7dpldBqlNBqltFQe7Zpls9pl9BrltBrl9BxnddyntdxndZxnddynddyntd6puB6p%2BF8p%2BF8qOF8qOJ8qeJ8qeN9qOKBreaCrueHtO2ItO2ItO6KtvCLt%2FCOufCQuvGRu%2FGpyvSqyvTG3Pjm7%2Fzv9f3w9f3w9v38%2Ff%2F%2B%2Fv%2F%2F%2F%2F%2BT0lLZAAAAT3RSTlMAAR0eHyAiLS4vMDEyOjs9TU5QUVJTgIGDg4TLy8zNzc7O0ODh4eLk5eXm5%2B3t7u7v8fHx8fHx8vLy8vLy8%2Ff4%2BPj4%2BPn5%2Bfn5%2Bvr7%2B%2Fv790vtUwAAAAFiS0dEaiVilQ4AAAFRSURBVCjPY2AgFnBLKWq6uGjKS3BjyjGKqBm5BURER4cHuFurCqPJsiqZBsfCQZCJAjOyLL%2BuV0wsEojx1edDkjUPi0UDIeZweRa9oFgMEGrABnWVkl8sFuAjB5EWNYHamwUCmWnJ8RD7zYTAmtVgbs6CghSIfKAKSJrHMBYuDSTiEtOzkiF8S06gtJQHinRsbGJWKoTvJgmUVgxAk07IyoDw%2FWWB0toRaNJJMN0RGkBp%2B2hUu5PgdkfbA6UdomKxuzw20g4orRWBIp2ZCvV3bGy4BjanwYG%2FDFBawhmXtJMYUJrLGpe0BTso2FSCsEsHKIOjRBgRJShJwkYAEmUKvtgi1FMamhyY9QKxJAddJlhy4bMNRpcNMudFJDY%2BHU%2FUpOitz4ucVFnkTJAsCDCWZkJL6UIqVq7%2B4cBs4O9opSyIJRNxSspq2tury4pzEJ3vAFWY0vzr8IKOAAAAAElFTkSuQmCC

Кастомный маркер в base64


На карте можно отобразить ломанные линии, управлять их цветом и толщиной.

https://static.maps.2gis.com/1.0?s=880x300&ls=55.73740,37.52284,55.74033,37.53542,55.72481,37.55050~w:5&ls=55.72481,37.55050,55.71790,37.56943,55.72634,37.58097~c:a23fb5~w:5

Линии


На карте можно отобразить полигоны, управлять их цветом и толщиной контура, а также цветом заливки.

https://static.maps.2gis.com/1.0?size=880x300&pn=59.99051,30.19207,59.99284,30.20503,59.98907,30.20292~c:22fe46~f:22fe46a1~w:2&pn=59.99233,30.20822,59.99121,30.21735,59.98738,30.21537,59.98856,30.20592~w:5&pn=59.99054,30.21812,59.98655,30.22571,59.98773,30.21646~c:ed3125~f:ed3125

Полигоны


Для отображения на экранах Retina и прочих с высокой плотностью пикселей можно использовать режим HD - в этом случае карта и все её объекты, кроме кастомных, будут увеличены вдвое, что увеличит чёткость изображения при том же визуальном размере.

https://static.maps.2gis.com/1.0?s=880x450@2x&z=14&pt=55.03652,82.91871&ls=55.03652,82.91871,55.02711,82.92131,55.02470,82.92698~w:5&pt=55.02470,82.92698~k:c~n:1&ls=55.03652,82.91871,55.03758,82.93058,55.04042,82.92996~c:ff0000&pt=55.04042,82.92996~k:c~n:2&pn=55.03687,82.89827,55.04067,82.90925,55.03636,82.91355,55.03264,82.91062,55.03489,82.90021~c:03ee10~f:03ee10a0&pt=55.03484,82.92290~k:c~c:pe

Карта в HD