Документация Atasu Maps
Карты, поиск адресов с подъездами и маршруты для Казахстана — SDK, справочник API и лицензии данных.
На этой странице
Atasu Maps — картографическая платформа для Казахстана: открытая базовая карта (OpenStreetMap и Overture Maps), поиск адресов, который знает подъезды и диапазоны квартир, маршруты до конкретного подъезда и слой правок пользователей, проверенных модераторами. Подписи на казахском, русском и английском.
С чего начать
- Быстрый старт — получить ключ, показать карту, найти адрес и построить маршрут примерно за 10 минут.
- Web SDK —
@atasu/maps-glдля браузера, на MapLibre GL JS. - Android SDK —
com.atasumaps:atasu-maps-android(внутренняя предварительная версия). - Справочник API — все HTTP-методы, собранные из спецификации OpenAPI.
Как устроен доступ
- Ключи. Каждая организация создаёт ключи в консоли: веб-ключ (публичный, привязан к адресам ваших сайтов), мобильный ключ (публичный, привязан к имени пакета приложения) или серверный ключ (секретный, привязан к IP-адресам ваших серверов — никогда не кладите его на веб-страницу или в приложение).
- Продукты и тарифы. Ключ получает только те продукты, которые входят в тариф (карта, поиск, маршруты, …). См. лимиты и бюджеты.
- Сессии карты. SDK открывает сессию карты по вашему ключу и получает короткоживущий токен тайлов; тайлы запрашиваются с этим токеном, а не с ключом.
- Ошибки — в формате RFC 9457 (
application/problem+json) со стабильнымcode, см. коды ошибок.
Адреса
| Хост | Что |
|---|---|
https://api.atasumaps.com | REST API (/v1/…) и поток событий в реальном времени |
https://tiles.atasumaps.com | векторные тайлы, шрифты и спрайты (токен тайлов) |
https://atasumaps.com/console | ключи, использование, бюджеты, участники |
Все данные хранятся и обрабатываются в Казахстане. Атрибуция видна на каждой карте — см. атрибуцию и лицензии данных.