Введение
Омни Карты — это data-инфраструктура, которая переводит физический мир Москвы в структуру, понятную ИИ-агентам и классическим интеграциям. Пять живых слоев данных — POI, пеший трафик, автомобильный трафик, коммерческая недвижимость и демография — доступны через единый ключ и три ветки доступа.
Документация описывает, как подключиться, как устроены запросы и ответы, сколько это стоит в кредитах и что вернется по каждому слою.
Базовый адрес
Заголовок раздела «Базовый адрес»Все запросы идут на один хост по HTTPS.
https://api.omnimaps.ruТекущая версия API — v1. Версия зашита в путь, поэтому ломающие изменения не затронут уже написанный код:
https://api.omnimaps.ru/v1/poi/searchВерсия релиза — 2.3.1. Она отделена от версии пути и отражает функциональность и исправления; история — в Changelog.
Три способа доступа
Заголовок раздела «Три способа доступа»Слои одни и те же, но дотянуться до них можно по-разному. Выбор зависит не от моды на протокол, а от того, кто на вашей стороне формирует запрос.
| Ветка | Для чего | Кто формирует запрос |
|---|---|---|
| MCP | ИИ-агенты, которые сами решают, какой инструмент вызвать | LLM (Claude, ChatGPT, GigaChat, YandexGPT, собственный стек) |
| REST и GraphQL | Классические интеграции: бэкенды, BI, скрипты по расписанию | Ваш код |
| SQL и выгрузка датасетов | Хранилища, офлайн-аналитика, дообучение моделей | Ваш аналитик или пайплайн |
MCP-сервер отдает агенту не только данные, но и описания инструментов, поэтому модель подключается без кода-посредника. REST и GraphQL применяются там, где LLM в цепочке нет. SQL и выгрузка — когда нужен не запрос в реальном времени, а весь слой целиком.
Что дальше
Заголовок раздела «Что дальше»- Быстрый старт — ключ и первый ответ за пять минут, по REST и через MCP.
- Аутентификация — как устроен ключ и где его взять.
- Базовые понятия — кредиты, лимиты, пагинация, координаты, форматы, свежесть данных.
- Ошибки — единый формат ошибки и коды.
- MCP — подключение агента и список инструментов.
- REST-справочник по слоям: POI, пеший трафик, автомобильный трафик, недвижимость, демография.
- Объект POI — все 28+ полей записи.
- Спецификация — OpenAPI 3.1 и MCP-манифест.
- Changelog — история версий.
- Гайд: подбор локации — сквозной пример на нескольких слоях.
Принципы, на которые опирается API
Заголовок раздела «Принципы, на которые опирается API»Данные о Москве, не о людях. Все слои мобильности агрегированы и обезличены на источнике. Идентификаторы устройств и индивидуальные траектории не хранятся и не отдаются. Обработка соответствует требованиям 152-ФЗ.
Каждая запись несет оценку качества. У объектов есть флаг verified и числовая confidence. API не делает вид, что данные идеальны, — он отдает агенту честную оценку, чтобы тот сам решал, насколько на нее опираться.
История сохраняется. Каждое состояние слоя фиксируется. Срез на конкретную дату запрашивается параметром as_of.
Один ключ на все. MCP, REST, GraphQL, SQL и выгрузка работают через один и тот же ключ и один общий счетчик кредитов.