Адрес по координатам и объекты рядом
Пришлите пару чисел — широту и долготу — и получите ближайший адрес с расстоянием до него и уровнем точности координаты. По требованию к ответу добавляются соседние дома, административные образования, внутри границ которых лежит точка, и ориентиры вокруг. Второй режим отвечает на отдельный вопрос: какие объекты-ориентиры есть вокруг точки в радиусе до десяти километров.
Платите только за найденное: адрес не найден, ближайший объект дальше пяти километров, пустой список «что рядом» — эти ответы не тарифицируются. Обогащение, не давшее данных, тоже не оплачивается.
Бесплатный лимит и оплата по результату
Сервис доступен с бесплатным лимитом для базовых сценариев. Дальше — оплата по факту (pay-as-you-go) по прозрачной цене, без подписок и скрытых комиссий. Тарифицируется не запрос, а результат.
- Адрес не найден — списания нет.
- Ближайший объект дальше пяти километров — списания нет. Населённый пункт в получасе езды не является адресом точки посреди леса, поэтому такой ответ не отдаётся и не оплачивается.
- Пустой список «что рядом» — списания нет: пустой ответ не результат.
- Некорректные координаты и сбой на нашей стороне — списания нет.
- Обогащение, не давшее данных — не оплачивается. Попросили адрес и ориентиры вокруг, ориентиров в радиусе не нашлось — заплатите за одну единицу работы, а не за две.
«Где дом числится» и «где лежит точка» — разные вопросы
Вместе с адресом сервис умеет возвращать административную принадлежность — и делает это двумя способами, потому что вопроса тоже два. Для дома в городе ответы обычно совпадают, для точки в поле — расходятся, и расхождение содержательно. Склеивать их нельзя.
- Отвечает на вопрос «в каком регионе, районе, городе и на какой улице ЧИСЛИТСЯ найденный дом».
- Откуда — выписка из государственного реестра адресов, где иерархия записана за каждым объектом.
- Приходит всегда, вместе с базовым ответом, дополнительной единицы работы не стоит.
Это выписка из официального источника, а не оценка и не расчёт по карте: так адрес объекта записан в государственном реестре.
- Отвечает на вопрос «внутри границ каких образований физически ЛЕЖИТ эта точка».
- Откуда — геометрический расчёт: попадание точки в полигон границы, а не наследование от ближайшего дома.
- Приходит по запросу и стоит одну дополнительную единицу работы.
Ради этого расчёта опция и существует: иначе точка посреди поля унаследовала бы район ближайшей деревни за двадцать километров.
Преимущества сервиса
Точка на входе — понятный и проверяемый ответ на выходе
Разобранный адрес
Готовая строка адреса плюс отдельные поля: улица, номер дома, индекс, населённый пункт.
Расстояние и уровень точности
Видно, насколько далеко найденный объект от точки и чья это координата — самого дома или центра улицы.
Режим «что рядом»
Объекты-ориентиры вокруг точки в радиусе до десяти километров, ближайший первым.
REST API
Обычный HTTP GET с JSON-ответом — встраивается в трекинг, логистику и аналитику.
Как это работает
Два способа превратить координаты в осмысленный ответ
Графический интерфейс
Введите широту и долготу, выберите режим и нужные обогащения — и получите карточку результата: адрес, расстояние, уровень точности и всё запрошенное прямо в списке.
- Переключатель «адрес» / «что рядом» в один клик
- Счётчик единиц работы виден ДО запроса, списанное число — в результате
- Радиус поиска для режима «что рядом» — до 10 км
REST API
Два GET-эндпоинта с одинаковым входом — точкой. Ответ в JSON, с расстоянием, уровнем точности, числом списанных единиц работы и обязательной строкой указания источника данных.
-
/api/geocodereverse— адрес по координатам -
/api/geocodereverse/nearby— объекты в радиусе точки - Ненайденное и сбои отвечают 404 и 503 — и не тарифицируются
Обогащения ответа
Базовый ответ — одна единица работы. Каждое включённое обогащение добавляет ещё одну, и только если оно действительно вернуло данные
Соседние дома +1 единица
Ответом на вопрос «какой здесь адрес» служит один объект — ближайший. Но точка нередко стоит между двумя зданиями или у торца длинного дома, и автоматический выбор спорный. Соседи дают возможность разрешить сомнение вручную, не делая второй запрос с другим радиусом.
Принадлежность точки +1 единица
Административные образования, внутри границ которых физически лежит точка, — от общего к частному. Считается попаданием в полигон, а не выводится из найденного дома, поэтому годится и для точки, у которой ближайший адрес в двадцати километрах.
Ориентиры вокруг +1 единица
То же, что режим «что рядом», но в одном ответе с адресом — и дешевле, чем отдельным запросом: единица считается по цене базового сервиса. Это сознательная скидка за то, что всё приходит одним ответом.
Режим «что рядом»: что это и чем оно не является
Ориентиры вокруг точки полезны — при условии, что понятно, откуда они берутся
- Ориентиры вокруг координаты: магазины, остановки, аптеки, заправки, парки и прочие нанесённые на карту места.
- Способ описать точку человеку: «в двухстах метрах от такой-то остановки» понятнее, чем пара чисел.
- Подсказка курьеру или монтажнику, что искать на месте.
- Черновая оценка окружения адреса для отчёта.
- Не справочник организаций: ни ИНН, ни режима работы, ни телефона здесь нет и не будет.
- Не источник вывода «поблизости нет ни одной аптеки»: отсутствие объекта в ответе не означает, что его нет в действительности.
- Не гарантия, что найденный объект до сих пор работает.
- Не инструмент проверки контрагента.
Часто задаваемые вопросы
Короткие ответы про обратный геокодинг
Примеры использования
Четыре ситуации, в которых у вас есть точка, а нужен понятный человеку ответ
Логистика и доставка
Координаты курьера или заказа превращаются в адрес для накладной и для клиента. Расстояние в ответе показывает, насколько близко к точке стоит найденный дом.
Мобильные приложения
Адрес подставляется по геопозиции вместо ручного ввода, а соседние дома дают выбор, когда человек стоит между двумя подъездами.
Аналитика по регионам
Массив точек раскладывается по субъектам и муниципалитетам попаданием в границы, а не по ближайшему дому: точка в поле не унаследует район соседней деревни.
Выездные работы
Наряд дополняется ориентирами вокруг точки — остановка, магазин, заправка, — и бригада находит объект, не перезванивая диспетчеру.
Начните с одной точки
Возьмите координаты из трека, фотографии или заявки и посмотрите, какой адрес за ними стоит и что находится вокруг. В веб-интерфейсе — руками и с ценой запроса перед глазами, в API — потоком.
Точка → адрес
С расстоянием и уровнем точности
До 10 км
Радиус режима «что рядом»
Россия
Данные загружены только по РФ
REST API
JSON + Swagger