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

RasterJS API

RasterJS API — это JavaScript-библиотека, с помощью которой вы можете добавить двумерную карту 2ГИС на ваш сайт.

Библиотека позволяет:

  • создавать интерактивные карты на веб-странице;
  • показывать на карте маркеры, попапы и геометрические объекты;
  • определять координаты геообъектов по их названиям и названия по координатам.

Вы можете посмотреть примеры использования библиотеки в документации RasterJS API.

Исходный код RasterJS API доступен на GitHub, проект открыт к предложениям и пулл-реквестам.

Тарифы​

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

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

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

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

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

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

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

Использование с Raster Tiles API​

Вы можете использовать библиотеку RasterJS API с сервисом Raster Tiles API в зависимости от варианта его размещения:

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

Помощь​

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

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

Что дальше?​