Координаты по адресу
Введите адрес строкой, разложите его по полям или пришлите пакетом до тысячи строк — получите широту и долготу, уровень точности координаты и административную иерархию из государственного реестра адресов. Покрытие — Россия. Не нашли адрес — не берём денег: пустой результат и результат грубее уровня улицы не тарифицируются.
Платите только за найденный адрес
Сервис доступен с бесплатным лимитом для базовых сценариев, дальше — оплата по факту (pay-as-you-go), без подписок и скрытых комиссий.
Тарификация идёт по результату, а не по факту обращения. Ответ «адрес не найден» и ответ «найдено, но грубее уровня улицы» не тарифицируются — как и некорректный ввод и недоступность сервиса. Оплачивается только тот результат, с которым можно работать: координата конкретного дома или, как минимум, участка нужной улицы.
В пакетном режиме это правило работает построчно: за пакет из тысячи адресов, из которых нашлось семьсот, спишется семьсот единиц, а не тысяча. Ненайденная строка внутри пакета бесплатна ровно так же, как поодиночке.
Преимущества сервиса
Координаты, которым можно верить, — и честная разметка того, чему верить нельзя
Три способа спросить
Адрес свободной строкой, разложенный по полям или пакетом до 1000 строк за один вызов.
Уровень точности в ответе
У каждого варианта видно, чья это координата: самого дома, вычисленная или центра улицы. Догадка не выдаётся за факт.
Официальная иерархия
Регион, район, населённый пункт и улица — как они записаны в государственном реестре адресов.
REST API
Простой HTTP GET с JSON-ответом — для массового геокодирования и интеграций.
Что важно понимать: чья это координата
Одна и та же пара чисел означает совершенно разное — смотрите на уровень точности
Дом найден
Дом есть в данных ровно такой, какой спрашивали, и координата принадлежит именно ему. Это результат, на который можно опираться в доставке «до подъезда» и в расчёте расстояний.
Номер получен с оговоркой
Либо положение дома вычислено между координатами соседей на улице, либо совпадение оказалось неполным: спрашивали «13к2», а в реестре дом заведён одной записью «13». Попасть в нужный квартал и на нужную сторону улицы такой результат позволяет, указать конкретное здание — нет. Нужны только буквальные попадания — включите режим «только точные».
Дома в реестре нет
Улица найдена, дом за ней не заведён — отдан центр улицы. Осмысленный ответ для маршрута до квартала, непригодный для навигации до подъезда. Это самый грубый уровень, который сервис вообще отдаёт: «где-то в этом городе» и «центр района» до вас не доходят и не тарифицируются.
Почему уровень точности, а не «достоверность» одним числом
Одно число выглядит удобнее: поставил порог — и не разбираешься в уровнях. Но нового знания в нём нет, за ним стоит всё тот же уровень точности, переведённый в шкалу. Отбирая «достоверность выше 0,8», вы на самом деле отбираете координаты домов — просто не знаете этого наверняка. Уровень точности говорит то же самое прямо, и слова у него те же, что у распространённых геокодеров: переучиваться при переходе не придётся.
Как это работает
Два способа получить координаты: руками в браузере или запросом из своей программы
Графический интерфейс
Введите адрес — получите список вариантов с координатами, уровнем точности и административной иерархией из реестра.
- Свободная строка или ввод по полям — переключателем
- Флаг «только точные попадания в дом»
- Копирование координат в один клик
REST API
Встройте геокодирование в свои процессы: разовая проверка адреса при вводе или массовая обработка накопленной базы.
-
/api/geocodeforward— координаты по строке -
/structured— координаты по разложенным полям -
/batch— пакет до 1000 адресов за один вызов -
/place— карточка объекта по идентификатору и его граница -
/postcode— что относится к почтовому индексу
Пакет, идентификатор и индекс
Три режима, которые превращают геокодинг из проверки одного адреса в обработку базы
Пакет до 1000 адресов
Типовая задача — прогнать выгрузку из своей системы, десятки тысяч строк. Поодиночке это десятки тысяч отдельных запросов, и основное время уходит не на сам поиск. Пакет отдаёт ответ строго в порядке запроса и возвращает исходную строку рядом с результатом, поэтому сопоставить его со своей таблицей можно не только по позиции. Счёт — по числу найденных строк.
Карточка и граница
Идентификатор объекта присвоен государственным реестром и не меняется никогда, в том числе при обновлении наших данных. Сохранив его один раз, вы позже получите ТОТ ЖЕ объект, тогда как повторный поиск по строке может дать другой вариант. У административных образований — региона, района, города — по тому же идентификатору доступна граница в GeoJSON: нарисовать на своей карте или самостоятельно проверять попадание точек внутрь.
Что относится к индексу
Обратная задача к геокодингу и на удивление частая: по индексу из платёжки, анкеты или выгрузки понять, какому населённому пункту и каким улицам он принадлежит. Пригодится для автозаполнения формы и для проверки, что индекс в присланных данных не противоречит городу. Дома в ответ не попадают: их на один индекс десятки тысяч, и такой список не отвечает на заданный вопрос.
Границы сервиса
Что сервис делает и, главное, чего он не делает
Только Россия
Данные загружены по территории Российской Федерации. Запрос по зарубежному адресу вернёт «адрес не найден» — и, по общему правилу тарификации, не будет оплачен. Планировать на сервисе международную логистику нельзя.
Координаты, а не адресный справочник
Сервис отвечает на вопрос «где это находится». Он не выдаёт официальный адресный текст, не присваивает коды и не подтверждает существование адреса в государственном реестре — и не пытается заменить те сервисы, которые это умеют.
Нужен официальный адрес по РФ — это ГАР/ФИАС и Стандартизация адреса. Связка обычно и нужна: адрес приводят к официальному виду там, координаты берут здесь.
Приблизительный результат помечен, а не спрятан
Вычисленное положение дома и неполное совпадение номера («13к2» против
записи «13» в реестре) отдаются с уровнем точности range —
и это осознанный выбор: «найдено с оговоркой» полезнее, чем «не найдено».
Если приблизительная координата хуже её отсутствия — расчёт доставки до
подъезда, привязка объекта к зданию, — включите режим «только точные
попадания»: он оставит лишь буквальные совпадения, а всё остальное
превратит в бесплатное «не найдено».
Граница есть не у всего и упрощена
Границу в GeoJSON имеют административные образования — регионы, районы, города. У дома и улицы её нет: запрос не станет ошибкой, поле границы просто останется пустым, и дополнительная единица работы не спишется. Сама геометрия упрощена — иначе граница субъекта весила бы десятки мегабайт, — поэтому точка у самого края может оказаться не на той стороне линии. Нужен точный ответ о принадлежности точки — это обратный геокодинг, он считает по неупрощённой границе.
Часто задаваемые вопросы
Короткие ответы про геокодинг адресов
Примеры использования
Четыре задачи, в которых адрес строкой не работает, а координата работает
Доставка и логистика
Адреса заказов становятся точками, по которым считаются маршрут, зона обслуживания и стоимость выезда. Дневная выгрузка уходит одним пакетным вызовом, а не тысячей отдельных.
Точки на карте
Филиалы, склады и пункты выдачи попадают на карту по своим адресам — вместе с уровнем точности, чтобы центр улицы не оказался подписан как конкретное здание.
Геоаналитика
Клиенты и заявки раскладываются по территории: плотность спроса, расстояние до ближайшей точки продаж, сравнение районов. Разрезы «регион — район — город» приходят готовыми из реестра.
Проверка ввода
Адрес из формы проверяется до оформления заказа: найден ли он на карте и насколько точно. Приблизительный уровень точности — повод показать клиенту варианты на выбор, а не сохранять адрес молча.
Проверьте на своих адресах
Возьмите десяток строк из своей базы — самых неудобных — и посмотрите, сколько из них найдётся с точностью до дома. В веб-интерфейсе это минута, в API — один пакетный запрос на всю выгрузку.
Координаты
Широта и долгота (WGS 84)
Россия
Область покрытия карты
По результату
Не найдено — не оплачено
REST API
JSON + Swagger