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

Map Tiles API

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

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

Также вы можете добавлять карты в мобильные приложения с помощью мобильных SDK для iOS, Android и Flutter.

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

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

1. Получите ключ доступа​

  1. Зарегистрируйтесь в личном кабинете Менеджер Платформы.

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

    подсказка

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

Подробнее о работе с ключами и подписками см. в документации личного кабинета.

2. Интегрируйте библиотеку MapGL JS API​

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

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

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

Песочница

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

Статистика​

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

Тарифы​

  • Стоимость сервиса рассчитывается исходя из количества успешных запросов в месяц. Один запрос соответствует загрузке одного векторного тайла 256×256 пикселей.

  • Чтобы определить точное количество тайлов для отображения карты:

    1. Определите размер карты для отображения в пикселях (ширина и высота).
    2. Разделите ширину и высоту карты на 256 (размер одного тайла) и округлите полученные значения до ближайшего целого числа в большую сторону.
    3. Умножьте количество тайлов по горизонтали на количество тайлов по вертикали.

    Полученное число — минимальное количество тайлов, необходимое для отображения видимой области карты. Рекомендуется добавить по одному тайлу с каждой стороны, чтобы обеспечить плавную прокрутку и масштабирование.

    Например, чтобы отобразить область карты размером 800×600 пикселей, нужно минимум 12 тайлов (4 по горизонтали и 3 по вертикали), а оптимально — 30 тайлов (6 по горизонтали и 5 по вертикали).

  • Безлимитный доступ к библиотеке MapGL JS API предоставляется бесплатно.

  • Актуальную стоимость и лимиты см. в разделе Тарифы.

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

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

Помощь​

  • Если у вас возникли вопросы при работе с API, задайте их AI-ассистенту (в правом нижнем углу cайта), воспользуйтесь поиском по документации или отправьте электронное письмо на api@2gis.ru.

  • Если вы хотите обсудить возможности API или его интеграцию с вашим продуктом, обратитесь к менеджеру.