API карт | On-Premise | 2GIS Documentation
On-Premise

Сервисы карт

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

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

Что дальше?