API карт | On‑Premise | 2GIS Documentation
On‑Premise
Личный кабинет

Сервисы карт

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

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

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

NGINX Web Server

Предоставляет статические файлы (шрифты, иконки) для MapGL JS API – фактически, для сайтов и веб-приложений. Чтобы использовать API, необходимо загрузить с веб-сервера основной файл библиотеки (api.js) и светлый стиль карты, который используется по умолчанию (находится в директории style).

Floors API

Предоставляет трёхмерные этажные планы зданий для MapGL JS API.

Примечание

Мобильные приложения (Android и iOS) используют Catalog API для получения этажных планов зданий.

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

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

Tiles API

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

Детали архитектуры программного комплекса 2ГИС приведены в документе Архитектура решения.

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

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

Styles API

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

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

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

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

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

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

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

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

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

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

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

Что дальше?