Две геокодированные точки, расположенные на карте в нескольких метрах друг от друга, могут представлять принципиально разные виды совпадения, и разница между ними, геокодирование до уровня здания (rooftop) или до уровня улицы, является одним из самых важных различий, скрытых за одной точкой на экране.
Геокодирование до уровня здания помещает возвращаемую координату в фактическое местоположение конкретного здания, сопоставленного с адресом, и обычно опирается на реальные данные о зданиях или земельных участках, которые фиксируют, где именно стоит это строение. Это самая точная категория совпадения из доступных, и именно её должен обозначать уровень точности house в ответе: координату, соответствующую установленному физическому зданию, а не оценку того, где оно, вероятно, находится.
Геокодирование до уровня улицы работает иначе. Вместо сопоставления с конкретным известным зданием оно интерполирует положение вдоль участка дороги, исходя из того, где запрошенный номер дома статистически должен находиться в известном диапазоне номеров на этом участке, при допущении примерно равномерного распределения адресов по длине улицы. В результате получается координата, которая лежит на нужной дороге или рядом с ней и примерно на нужном её отрезке, но по сути это оценка, основанная на типичных схемах нумерации, а не подтверждённое местоположение конкретного здания.
Разница между ними важнее, чем может показаться сначала, потому что интерполяция по улице предполагает, что нумерация на участке достаточно равномерна и последовательна, а это допущение выполняется не всегда. Там, где улица застраивалась неравномерно, где в нумерации есть пропуски или где длинный участок охватывает широкий диапазон адресов, неравномерно распределённых по его длине, интерполированная точка может оказаться на заметном расстоянии от реального строения, иногда на целое здание или больше, хотя сам метод работает именно так, как задуман.
Именно это различие призвано показывать поле precision, поэтому его всегда следует проверять, а не делать выводы по одной лишь координате: совпадение до уровня здания и интерполяция по улице могут давать на карте визуально похожие точки, но с существенно разной реальной точностью. Для любого сценария, где разница действительно важна, например при отправке выездного специалиста к конкретному зданию, а не к соседнему, проверка именно точности house, а не принятие любого результата, найденного где-то на нужной улице, и есть разница между опорой на подтверждённое совпадение и опорой на статистическую оценку.
Наш эндпоинт прямого геокодирования сообщает фактически достигнутую точность для каждого совпадения, именно для того, чтобы ваше приложение могло отличить подтверждённый результат до уровня здания от интерполяции по улице, прежде чем решать, насколько ему доверять в вашем конкретном сценарии.