Начало работы
Ключи и базовая схема
Прямая ссылка на раздел: /docs#getting-started/registration
Для начала работы зарегистрируйтесь, войдите в личный кабинет и выберите продукт: Maps API или Routing API для онлайн-интеграции, либо SDK-карты для приложения, если нужен мобильный runtime ProMaps.
- Для публичного старта создайте
mapsилиroutingkey в разделе «API-ключи». - Если вам нужны SDK-карты для приложения, используйте runtime ProMaps и endpoint-ы
/api/mobile-map/*. - Сохраните его в переменной окружения или секретах вашего проекта.
- Выберите сценарий интеграции:
/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 не является публичным способом интеграции.