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

Raster Tiles API

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

Для работы с растровыми тайлами в зависимости от ваших задач вы можете использовать:

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

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

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

Примечание

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

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

Использование endpoint-а​

При использовании сторонних библиотек укажите endpoint, по которому будут загружаться изображения тайлов:

https://tile{n}.maps.2gis.com/v2/tiles/{tileset}/{z}/{x}/{y}.png?key={key}

Здесь:

  • n — номер хоста. Может иметь значение от 0 до 4. Вы можете использовать один хост, если у вас небольшой объём трафика, или распределять запросы между несколькими хостами самостоятельно.
  • tileset — набор тайлов. Например, online_hd для тайлов в высоком разрешении или online_sd для тайлов в стандартном разрешении.
  • z — масштаб карты. Чем больше число, тем подробнее карта.
  • x, y — координаты тайла.
  • key — ваш API-ключ.

Пример запроса:

https://tile0.maps.2gis.com/v2/tiles/online_hd/16/47851/20734.png?key=YOUR_KEY

Интеграция библиотеки RasterJS API​

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

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

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

Статистика​

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

Тарифы​

  • Тариф для сервиса включает фиксированное количество тарифицируемых событий за период. Безлимитный доступ к библиотеке RasterJS API предоставляется бесплатно.
  • Тарифицируемое событие для Raster Tiles API — успешный запрос, который возвращает растровый тайл в формате PNG.
  • Актуальные тарифы можно посмотреть в Менеджере Платформы.

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

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