Сценарии использования

Проверка адреса компании для размещения в справочнике

Кто угодно может ввести адрес в форму отправки, и не каждый введённый адрес существует. Местный бизнес-справочник, который позволял компаниям самостоятельно добавлять карточки, убедился в этом на собственном горьком опыте: он получал жалобы от пользователей, которые приезжали по указанному адресу и ничего там не находили. Иногда причиной была честная опечатка, а иногда карточка, добавленная недобросовестно, чтобы накрутить позиции в поиске за счёт фиктивного местного присутствия.

Справочник добавил этап проверки перед публикацией любой присланной карточки. Присланный адрес отправлялся в /v1/forward, который пытается найти совпадение и сообщает, насколько уверенно адрес распознан, отличая чистое совпадение от частичного или от полного отсутствия результата. Отдельно почтовый индекс из формы проверялся через /v1/postcode, чтобы убедиться, что он соответствует городу и региону, также указанным в форме. Так выявлялся конкретный и на удивление частый случай, когда отправитель скопировал почтовый индекс совсем другого места, по ошибке или намеренно.

Заявки, не прошедшие одну из проверок, не отклонялись автоматически, поскольку плохое совпадение не то же самое, что фиктивный адрес: у множества законных компаний адреса распознаются неидеально из-за новой застройки или необычного расположения в сельской местности. Вместо этого отмеченные заявки попадали в очередь ручной проверки, где сотрудник быстро просматривал их перед публикацией. Раньше такого же ручного внимания требовала каждая заявка, независимо от того, насколько она была чистой.

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

Внутри справочника прямо говорили об ограничениях этого подхода. Чистое совпадение при геокодировании подтверждает, что адрес правильно составлен и географически существует. Оно не подтверждает, что компания действительно там работает, что её название указано верно или что карточка не вводит в заблуждение каким-то иным образом, не связанным с полем адреса. Этап проверки решал ровно одну часть проблемы доверия, а именно вопрос о том, существует ли само место и правильно ли оно описано, а для всего остального справочник сохранил другие методы модерации.

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

Документация по обоим эндпоинтам, включая то, как представлена уверенность совпадения, находится на /docs/forward-geocoding/ и /docs/postal-code-lookup/.