Перейти к основному содержимому

Сервисы карт

Сервисы карт позволяют отображать карты 2ГИС на сайтах, а также в веб- и мобильных приложениях.

В этой статье описывается, как установить и настроить сервисы карт в вашем окружении. Чтобы узнать, как использовать API, предоставляемые сервисами карт, обратитесь к документации MapGL JS API.

Архитектура​

Архитектура сервисов карт

Сервис MapGL JS API​

Предоставляет файлы библиотеки MapGL JS API для использования на сайтах и в веб-приложениях.

Прокси для API пробок​

Предоставляет данные о пробках в реальном времени с серверов 2ГИС. Конечные пользователи и приложения затем могут с помощью MapGL JS API или Mobile SDK отобразить пробки в виде цветных линий на отдельном слое карты.

Tiles API​

Предоставляет API для получения и отображения тайлов карты — квадратных изображений, соответствующих участку карты (пример тайлированной карты). С помощью тайлов можно отображать только видимую часть карты и загружать необходимые тайлы при перемещении по карте или при изменении её уровня масштабирования. Это помогает потреблять меньше памяти при работе с картой.

Тайлы, предоставляемые Tiles API:

Вид тайловПотребители
ВекторныеMapGL JS API, Mobile SDK
МобильныеMobile SDK
РастровыеMapGL JS API, Static API, Mobile SDK

Подробнее об архитектуре программного комплекса 2ГИС см. в разделе Архитектура.

Tilegen API​

Предоставляет API для создания векторных тайлов из пользовательских данных.

Static API​

Предоставляет API для генерации статических изображений карты в формате PNG. Сервис получает растровые тайлы от Tiles API, на их основе формирует изображение заданной области с указанным масштабом и наносит на него переданную в запросе информацию — области, линии, метки и другие объекты.

Styles API​

Предоставляет API для подключения пользовательских стилей карты. Вы можете создать собственный стиль в Редакторе стилей, загрузить его в контур On-Premise через интерфейс Менеджера Платформы и подключить к своей карте в настройках MapGL JS API. Подробнее см. в инструкции Загрузка и применение стиля карты.

Если Styles API не установлен, к карте применится стиль по умолчанию.

Сервис лицензий​

Предоставляет лицензию для доступа к сервису карт. Подробнее см. архитектуру сервиса лицензий.

Сервис сбора статистики​

Собирает статистику использования API-ключей для доступа к сервисам карт. Подробнее см. архитектуру сервиса сбора статистики.

Сервис API-ключей​

Предоставляет API-ключ для доступа к сервису карт. Подробнее см. архитектуру сервиса API-ключей.

Зависимости​

Зависимости, обязательные для всех конфигураций:

  • Сервис лицензий.
  • Сервис API-ключей.
  • Хранилище данных Apache Cassandra для тайлов. Конфигурации с MapGL JS API и с Mobile SDK используют отдельные наборы тайлов.
Можно использовать аналог из реестра Минцифры

Доступные аналоги Apache Cassandra, включённые в реестр Минцифры, см. в разделе Системные требования.

Опциональные зависимости, включение которых зависит от выбранной конфигурации:

  • Прокси для API пробок. Конфигурации с MapGL JS API и с Mobile SDK используют отдельные экземпляры.
  • Веб-сервер nginx, необходимый для загрузки стилей и иконок.
  • Сервис Styles API, необходимый для загрузки пользовательских стилей, созданных в Редакторе стилей. Для работы Styles API необходимо настроить PostgreSQL и S3-совместимое хранилище.
  • Сервис Tilegen API, необходимый для создания векторных тайлов из пользовательских данных. Для работы Tilegen API необходимо настроить Redis.

Подробнее о том, как проверить требования для каждого сервиса, см. в документе Системные требования.

Что дальше?​