Перейти к основному содержимому

Map Tiles API

Сервис Map Tiles API предоставляет векторные тайлы для карт.

Для работы с векторными тайлами используйте JavaScript-библиотеку MapGL JS API и размещайте на сайтах и в веб-приложениях трёхмерную интерактивную карту 2ГИС на WebGL-движке. При оформлении подписки на Map Tiles API безлимитный доступ к библиотеке MapGL JS API предоставляется бесплатно.

Также вы можете добавлять карты в мобильные приложения с помощью мобильных SDK для iOS, Android и Flutter. Для доступа к мобильным SDK оформите заявку: подробнее см. в разделе Получение ключей доступа документации нужной платформы.

Прямая интеграция векторных тайлов без использования библиотеки или SDK 2ГИС не поддерживается.

Начало работы

Получение ключа доступа

  1. Зарегистрируйтесь в личном кабинете Менеджер Платформы.
  2. Создайте демо-ключ или купите подписку для доступа к API. Подробнее о стоимости сервиса см. в разделе Тарифы.

Примечание

Если у вас уже есть действующий API-ключ, полученный для MapGL JS API, вы можете использовать его для доступа к Map Tiles API до истечения срока действия подписки. Срок действия можно посмотреть в личном кабинете, на вкладке Главная.

Работать с ключами можно в Менеджере Платформы: подробнее см. в документации личного кабинета.

Интеграция библиотеки MapGL JS API

MapGL JS API — это бесплатная JavaScript-библиотека для работы с трёхмерными интерактивными картами 2ГИС. Содержит готовый набор инструментов для взаимодействия с картой, автоматически запрашивает векторные тайлы и отображает их на странице.

Чтобы использовать с библиотекой MapGL JS API тайлы, предоставленные сервисом Map Tiles API, сначала получите ключ доступа, затем подключите библиотеку к вашему проекту. Подробнее см. в инструкции Начало работы.

Пример использования

Вы также можете поработать с готовой картой в песочнице (авторизация не требуется).

Статистика

При исчерпании лимитов сервис станет недоступен. Вы можете отслеживать расходование лимитов в подписке и статистику распределения запросов к сервису в личном кабинете. Подробнее об инструментах статистики см. в разделе Статистика.

Тарифы

  • Стоимость сервиса рассчитывается исходя из количества запросов в месяц. Один запрос соответствует загрузке одного векторного тайла. Безлимитный доступ к библиотеке MapGL JS API предоставляется бесплатно.
  • Актуальные тарифы можно посмотреть в Менеджере Платформы.

Варианты размещения

  • Облако: Map Tiles API доступен через публичные endpoint-ы 2ГИС.
  • On-Premise: для получения векторных тайлов установите Tiles API в составе API-платформы 2ГИС в закрытом контуре. Подробнее см. в разделе API-платформа для сервера.