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

Сервисы карт

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

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

Архитектура

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

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

  • MapGL JS API + Векторный Tiles API

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

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

  • Растровый Tiles API

    Эта конфигурация предназначена в первую очередь для работы вместе с сервисом GIS-платформы, но может быть также использована с любым приложением, которое будет получать растровые тайлы напрямую от Tiles API.

Каждая из этих конфигураций требует наличия сервиса Tiles API. Он предоставляет API для получения и отображения тайлов карты. Тайл - квадратное изображение, соответствующее участку карты (пример тайлированной карты). С помощью тайлов становится возможным рендерить только видимую часть карты, подгружая необходимые тайлы при перемещении по карте или при изменении масштаба карты. Таким образом, работая с картой, приложение потребляет меньше памяти.

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

Зависимости

  • Для конфигурации с MapGL JS API и Tiles API

    • Хранилище данных Apache Cassandra для тайлов.
    • Прокси для API пробок, настроенный на использование серверов обновлений, предоставляющих данные о пробках в векторном формате.

  • Для конфигурации с Tiles API

    • Сервис лицензий.
    • Сервис API-ключей.
    • Хранилище данных Apache Cassandra для тайлов.

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

Что дальше?