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

Ключи и базовая схема

Прямая ссылка на раздел: /docs#getting-started/registration

Для начала работы зарегистрируйтесь, войдите в личный кабинет и выберите продукт: Maps API или Routing API для онлайн-интеграции, либо SDK-карты для приложения, если нужен мобильный runtime ProMaps.

  1. Для публичного старта создайте maps или routing key в разделе «API-ключи».
  2. Если вам нужны SDK-карты для приложения, используйте runtime ProMaps и endpoint-ы /api/mobile-map/*.
  3. Сохраните его в переменной окружения или секретах вашего проекта.
  4. Выберите сценарий интеграции: /embed для быстрого встраивания или MapLibre для собственной интерактивной карты.

Рекомендуемая практика

Для Карты API используйте отдельный maps key. Для Routing API используйте отдельный продуктовый ключ.

Если у вас отдельно настраиваются светлая и тёмная темы карты, это не требует разных типов продукта: достаточно одного или нескольких maps key по вашей operational-схеме.

Лимиты и условия

Публичный self-serve сейчас действует для Maps API и Routing API. SDK-карты для приложений выдаются через отдельный runtime-доступ.

  • Карты API / Maps API: 5 000 запросов в месяц на ключ
  • Построение маршрутов API / Routing API: 100 запросов в месяц на ключ, пакеты от 299 ₽ за 1 000 запросов
  • SDK-карты: приложение работает через защищённый runtime, без скачивания raw-файлов карты в обычном пользовательском сценарии

Платные пакеты для Maps API и Routing API покупаются на конкретный ключ. Для SDK-карт стартовые условия согласуются отдельно.

Публичный контракт ProMaps строится вокруг /api/styles, /api/vector-tiles, /api/fonts, /api/sprites, /embed и mobile runtime /api/mobile-map/*. Raw archive download не является публичным способом интеграции.