Заведения: OpenStreetMap и отдельный слой Overture Maps Foundation, Places. Релиз 2026-09-23.1, порог уверенности Meta ≥ 0.7. Источник каждого результата указан в source; OSM приоритетнее при равном счёте. Недостающие заведения можно добавить в OpenStreetMap.
Overture: данные Meta, Microsoft, PinMeTo — CDLA-Permissive-2.0; Foursquare — Apache-2.0; AllThePlaces — CC0-1.0. Источники и лицензии. Copyright 2024 Foursquare Labs, Inc. All rights reserved. NOTICE Foursquare.
Доступ по ключу; заявка — на странице карты /about. Демо без гарантий доступности. Ключ карты публичен и ограничен по Origin; для curl с таким ключом добавьте -H 'Origin: https://almaty-routing.vercel.app'. Атрибуция OpenStreetMap и ODbL обязательна.
Документ OpenAPI 3.1 · Метаданные · Работоспособность
Демонстрационный сервис маршрутизации Алматы на данных OpenStreetMap. Координаты запросов {lat, lon}, геометрии ответов [lon, lat]; расстояния в метрах, время в секундах; departAtMin — минуты от полуночи по Алматы (UTC+5), без него — «сейчас». Каждый ответ маршрута несёт доли источников скоростей model / heuristic / observed и источник по каждому линку: это модель, а не измерение. Там, где скорость линка берётся из эвристики (вне зоны модели), к времени добавляется ожидаемая задержка на регулируемых перекрёстках, 10–20 с на перекрёсток.
Примеры для всех ручек (Аэропорт → Абая/Достык в 08:00) с адресом этого сервиса.
# Уточнение полос и разметки
curl -X POST https://api.ainalma.kz/v1/corrections -H "X-ATL-Key: $ATL_KEY" -H 'Content-Type: application/json' -d '{"linkId":"w4489474_0_f","osmWayId":4489474,"direction":"forward","attribute":"layout","ours":{"lanes":{"forward":2,"backward":null},"bus_lane":{"present":false}},"proposed":{"lanes":{"forward":2,"backward":2},"bus_lane":{"present":true,"direction":"forward","side":"right"}},"installationId":"11111111-1111-4111-8111-111111111111","consent":true,"website":"","formElapsedMs":5000}'
# Статистика уточнений
curl https://api.ainalma.kz/v1/corrections/stats -H "X-ATL-Key: $ATL_KEY"
# Камеры контроля скорости
curl https://api.ainalma.kz/v1/cameras -H "X-ATL-Key: $ATL_KEY"
# Сообщение о камере
curl -X POST https://api.ainalma.kz/v1/camera-reports -H "X-ATL-Key: $ATL_KEY" -H 'Content-Type: application/json' -d '{"lat":43.238,"lon":76.957,"bearingDeg":90,"kind":"present","installationId":"11111111-1111-4111-8111-111111111111","consent":true}'
# Метаданные загруженной сети
curl https://api.ainalma.kz/v1/meta -H "X-ATL-Key: $ATL_KEY"
# Место остановки автомобиля
curl -X POST https://api.ainalma.kz/v1/snap -H "X-ATL-Key: $ATL_KEY" -H 'Content-Type: application/json' -d '{"point":{"lat":43.352,"lon":77.04}}'
# Маршрут между двумя точками
curl -X POST https://api.ainalma.kz/v1/route -H "X-ATL-Key: $ATL_KEY" -H 'Content-Type: application/json' -d '{"from":{"lat":43.352,"lon":77.04},"to":{"lat":43.238,"lon":76.957},"departAtMin":480,"traffic":"traffic","alternatives":2,"transport":"car"}'
# Матрица времени и расстояний
curl -X POST https://api.ainalma.kz/v1/matrix -H "X-ATL-Key: $ATL_KEY" -H 'Content-Type: application/json' -d '{"origins":[{"lat":43.352,"lon":77.04}],"destinations":[{"lat":43.238,"lon":76.957}],"departAtMin":480}'
# Поиск по адресу, зданию и заведению OSM и Overture на русском, казахском и английском, с опечатками
curl -X POST https://api.ainalma.kz/v1/geocode -H "X-ATL-Key: $ATL_KEY" -H 'Content-Type: application/json' -d '{"query":"Traveler's","limit":5,"near":{"lat":43.238,"lon":76.957}}'
# Адрес рядом с точкой
curl -X POST https://api.ainalma.kz/v1/geocode/reverse -H "X-ATL-Key: $ATL_KEY" -H 'Content-Type: application/json' -d '{"point":{"lat":43.238,"lon":76.957}}'
# Приём GPS-трека
curl -X POST https://api.ainalma.kz/v1/probes -H "X-ATL-Key: $ATL_KEY" -H 'Content-Type: application/json' -d '{"vehicleId":"demo-vehicle","points":[{"lat":43.352,"lon":77.04,"tsMs":1791788400000},{"lat":43.351,"lon":77.039,"tsMs":1791788410000}]}'
# Статистика наблюдений
curl https://api.ainalma.kz/v1/observed/stats -H "X-ATL-Key: $ATL_KEY"
# Заявка на доступ к API
curl -X POST https://api.ainalma.kz/v1/access-requests -H 'Content-Type: application/json' -d '{"name":"Тестовый заявитель","email":"test@example.com","purpose":"Проверить интеграцию маршрутов","consent":true}'
# Проверка работоспособности HTTP-сервиса
curl https://api.ainalma.kz/healthz
Ошибки — JSON {"error": {"code", "message"}} со статусами 400 / 401 / 404 / 429 / 500; при 429 ждите Retry-After секунд. Лимиты: 120 запросов/мин с IP, по ключу 300/мин по умолчанию; заявки — 5/час с IP. Заголовок X-ATL-Graph — идентификатор загруженного графа. Данные: © OpenStreetMap contributors, ODbL; производная база выдаётся по запросу под ODbL.