Геокодирование адресов через API: координаты и обратно

Прямое геокодирование: координаты по адресу

Координаты приходят вместе с адресом — отдельного запроса не нужно. Человек выбрал подсказку, вы получили строку, разбор на части, индекс, коды и широту с долготой в одном ответе. Этого достаточно, чтобы поставить точку на карту, посчитать зону доставки или найти ближайший пункт выдачи.

Обратное геокодирование: адрес по координатам

Обратная задача интереснее. По широте и долготе возвращается ближайший адресный объект из реестра ГАР/ФИАС — не приблизительная точка, а полноценный адрес с индексом, кодами КЛАДР и ФИАС и разбором на регион, город, улицу и дом. Точка, которую поставил курьер в приложении, превращается в то, что можно положить в договор или накладную.

Ответ приходит в том же виде, что и у подсказок адресов, — разбирать его отдельным кодом не нужно. Можно запросить несколько ближайших объектов и дать человеку выбрать нужный: в плотной застройке это заметно точнее, чем брать первый.

Типичные сценарии

Частые вопросы про геокодирование

Сколько стоит геокодирование?

Тарифицируется как обычный запрос к адресам и идёт по дневному объёму — 10 000 в сутки бесплатно.

Насколько точен адрес по координатам?

В городской застройке возвращается конкретный дом. Вне населённых пунктов — ближайший объект реестра, потому что более точного адреса там просто не существует.

Можно получить несколько вариантов?

Да, метод отдаёт несколько ближайших объектов — удобно, когда точка стоит между двумя домами и выбор лучше оставить человеку.

Приходят ли коды и индекс?

Приходят: ответ такой же, как у подсказок, — с индексом, КЛАДР, ФИАС и разбором на части.

Что хранить у себя — адрес или координаты?

Разумнее и то и другое: координаты для карты и логистики, код ФИАС для документов и отчётности. Почему именно код — в статье про ФИАС и ГАР.