API карт | On-Premise | 2GIS Documentation
On-Premise
Карты
Поиск
Навигация
On-Premise
2ГИС Про
ру
en

Сервисы карт

Сервисы карт позволяют отображать карты 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

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

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

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

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

Зависимости

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

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

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

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

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

Что дальше?