Сервисы карт
Сервисы карт позволяют отображать карты 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-совместимое хранилище.
Подробнее о том, как проверить требования для каждого сервиса, см. в документе Системные требования.
Что дальше?
-
Узнайте, как установить или обновить сервис:
-
Узнайте больше о программном комплексе 2ГИС: