Яндекс Геокодер: ИИ-агент для проверки адресов

API Геокодера Яндекса переводит адрес в координаты и обратно. Материал для администратора и офис-менеджера, у которого в таблицах адреса клиентов и точек доставки написаны кто как смог.

Агент — программа, которая делает дело целиком, а не отвечает на вопрос. Вы ставите задачу словами, а возвращается результат: сверка, пакет документов, список расхождений.

Три признака. Он работает в ваших сервисах, а не в отдельном окне чата. Доводит дело до конца: сам заходит в систему и сам кладёт итог туда, где вы его ждёте. И работает без вас — по расписанию или по событию.

Отличие от чат-бота: бот вернёт текст, который вы переносите в работу руками, а агент вернётся с результатом.

Коннектор — описанное подключение агента к сервису по выданному доступу, а не плагин в вашу таблицу.

Ключ выдаётся в кабинете разработчика и идёт в запрос параметром apikey: в документации сказано, что он активируется в течение пятнадцати минут после получения. Связь проверяется одним адресом — если вернулся объект с координатами, подключение живо. Пароль кабинета агент не хранит.

Интерфейс умеет прямое и обратное геокодирование: узнать координаты по адресу или названию и, наоборот, получить адрес по координатам. В прямом режиме учитываются распространённые опечатки и предлагается несколько подходящих вариантов, в обратном можно выбрать тип топонима. Запрос идёт на geocode-maps.yandex.ru, среди параметров есть язык, вид объекта, границы, число результатов и пропуск.

### Пересчёт чужой таблицы: найти ошибку

Агент берёт таблицу с адресами, прогоняет каждую строку через геокодер и сравнивает полученные координаты с теми, что уже стоят в файле. Помечает строки, где координаты не совпали, где адрес распознан как другой объект и где найдено несколько вариантов. Возвращает файл с пометками и список правок к внесению, по строке на каждую ошибку и с датой проверки файла.

### Своя система по API: чтение и запись

Агент подключает геокодер к вашей системе: при вводе адреса подтягивает координаты и подсказывает варианты, а при сохранении карточки проверяет, что объект существует. Ошибки распознавания складывает в журнал, чтобы их было видно. Работает с параметрами запроса из документации: язык ответа, тип объекта, число результатов. Ответы с несколькими вариантами агент помечает отдельно, чтобы человек выбрал нужный вариант без повторного запроса.

### Индексация и техошибки: список правок

Агент проходит по страницам сайта с адресами и находит места, где адрес написан так, что геокодер его не распознаёт или распознаёт как другой объект. Собирает список правок с адресом страницы и ожидаемым результатом, чтобы правку можно было проверить. Отдельно отмечает страницы без координат, если они нужны для карты. Правки собираются в один список с адресами страниц и ожидаемым результатом.

Решение. Какой из нескольких найденных вариантов адреса верный, решает человек: агент показывает кандидатов и уверенность, но не выбирает за вас. Правку в справочник адресов он тоже не вносит.

Доступ берётся в кабинете разработчика Яндекс Карт: там создаётся ключ для Геокодера и указывается ограничение по адресам сайта. Ключ активируется за пятнадцать минут. Лимиты запросов и условия использования уточняются при подключении.

Агент не выдумывает координаты, если адрес не распознан: он помечает строку как проблемную. Он не заменяет кадастровый учёт и не подтверждает юридический адрес объекта.

Что такое агент, если коротко? Программа, которая получает задачу словами и возвращает готовое дело: сама ходит в интерфейс, собирает адреса, кладёт список правок. Чат-бот отвечает текстом, агент приносит результат.

Что такое коннектор? Описанное подключение к сервису по выданному доступу. Здесь это ключ из кабинета разработчика: агент шлёт адреса в геокодер, пароль кабинета не хранит.