Сервисы карт
Сервисы карт позволяют отображать карты 2ГИС в веб-приложениях и на сайтах.
В этой статье описывается, как установить и настроить сервисы карт в вашем окружении. Чтобы узнать, как использовать API, предоставляемые сервисами карт, обратитесь к документации Map JS API.
Архитектура

Сервисы карт могут быть установлены в двух разных конфигурациях:
-
MapGL JS API + Векторный Tiles API
Чтобы использовать API, необходимо загрузить с веб-сервера основной файл библиотеки (
api.js
) и светлый стиль карты, который используется по умолчанию (находится в директорииstyle
).Дополнительные возможности:
- Чтобы получать данные о пробках в реальном времени с серверов 2ГИС, настройте прокси для API пробок. Конечные пользователи и приложения затем могут с помощью MapGL JS API отобразить пробки в виде цветных линий на отдельном слое карты.
- Чтобы показывать на карте трёхмерные этажные планы зданий, установите сервис Floors API, чтобы MapGL JS API мог получать данные этажей и отображать их.
-
Растровый Tiles API
Эта конфигурация предназначена в первую очередь для работы вместе с сервисом GIS-платформы, но может быть также использована с любым приложением, которое будет получать растровые тайлы напрямую от Tiles API.
Каждая из этих конфигураций требует наличия сервиса Tiles API. Он предоставляет API для получения и отображения тайлов карты. Тайл - квадратное изображение, соответствующее участку карты (пример тайлированной карты). С помощью тайлов становится возможным рендерить только видимую часть карты, подгружая необходимые тайлы при перемещении по карте или при изменении масштаба карты. Таким образом, работая с картой, приложение потребляет меньше памяти.
Детали архитектуры программного комплекса 2ГИС приведены в документе Архитектура решения.
Зависимости
-
Для конфигурации с MapGL JS API и Tiles API
- Хранилище данных Apache Cassandra для тайлов.
- Прокси для API пробок, настроенный на использование серверов обновлений, предоставляющих данные о пробках в векторном формате.
- Сервис Floors API.
-
Для конфигурации с Tiles API
- Сервис лицензий.
- Сервис API-ключей.
- Хранилище данных Apache Cassandra для тайлов.
Детальные требования для каждого сервиса описаны в документе Системные требования.
Что дальше?
-
Узнайте, как установить или обновить сервис:
-
Узнайте больше о программном комплексе 2ГИС: