ПроКартыПроКарты
ГлавнаяВойти

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

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

Для начала работы зарегистрируйтесь, войдите в личный кабинет и выберите продукт: 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 не является публичным способом интеграции.

Как передавать API-ключ

Поддерживаются три способа авторизации. Для браузерной карты и iframe чаще всего используют query-параметр.

  • ?key=YOUR_API_KEY — удобно для style URL, iframe и browser-side MapLibre.
  • Authorization: Bearer YOUR_API_KEY — удобно для server-to-server и CLI.
  • X-API-Key: YOUR_API_KEY — запасной вариант, если библиотеке проще передать кастомный заголовок.

Style URL

https://promaps.online/api/styles/color-ru-pmtiles.json?key=YOUR_API_KEY

HTTP заголовок

fetch('https://promaps.online/api/route', {
  method: 'POST',
  headers: { Authorization: 'Bearer YOUR_API_KEY' }
});

Важно: ключ должен соответствовать endpoint. Например, maps key подходит для styles/vector tiles/fonts/sprites, но не для /api/route.