Пример запроса
Стиль карты#
В качестве стиля карты вы можете использовать любой из стилей, созданных вами в личном кабинете. Либо, использовать один из двух стилей по умолчанию - bright или dark.
Структура запроса#
Например, мы хотим сгенерировать центр Санкт-Петербурга в формате 512x512 пикселей в стандартном стиле карты. В таком случае запрос будет выглядеть примерно так:
https://maps.starline.ru/api/static_map/v2/render?height=512&width=512¢er=30.315389%2C59.939313&zoom=13&token=ВАШ_ТОКЕН_ДОСТУПА
Давайте разберем использованные параметры:
| Тип | Описание |
|---|---|
height | Высота изображения в пикселях. Максимум 1024. |
width | Ширина изображения в пикселях. Максимум 1024. |
center | Координаты центра карты (долгота/широта) |
zoom | Уровень зума от 0 до 21 |
format | В каком формате будет сгенерировано изображение (JPG или PNG) |
token | Ваш персональный токен доступа |
Кастомизация#
Для случаев, когда необходимо использовать custom-стиль карты или необходимо нарисовать поверх карты geoJSON, существует метод /render_custom. Он отличается от метода /render дополнительными полями:
| Тип | Описание |
|---|---|
style | Стиль карты. Либо UUID вашего стиля (в личном кабинете), либо стандартные темы bright или dark |
overlay | Дополнительные данные в формате GeoJSON, которые необходимо отрисовать поверх карты. Для маркеров каждый элемент должен содержать свойство icon = "marker". |
Пример запроса:
https://maps.starline.ru/api/static_map/v2/render_custom?style=XXX&height=512&width=512¢er=30.315389%2C59.939313&zoom=13&overlay=%7B%22type%22%3A%22FeatureCollection%22%2C%22features%22%3A%5B%7B%22type%22%3A%22Feature%22%2C%22properties%22%3A%7B%22icon%22%3A%22marker%22%7D%2C%22geometry%22%3A%7B%22coordinates%22%3A%5B30.315389%2C59.939313%5D%2C%22type%22%3A%22Point%22%7D%7D%5D%7D&token=ВАШ_ТОКЕН_ДОСТУПА