Сколько стоит?

Метод тарифицируется как обычный запрос к адресам. Бесплатного объёма хватает, чтобы проверить на своём потоке.

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

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

Формат ответа отличается от подсказок адреса?

Нет, он тот же: компоненты, коды и индекс приходят в одинаковом виде, поэтому отдельная обработка не нужна.

геолокация

Адрес
по координатам

Обратное геокодирование: ближайший адрес ГАР/ФИАС по широте и долготе — с индексом, кодами и разбором на части.

Документация →

123,5 млн

адресов

КЛАДР·ФИАС

коды

~15мс

ответ

POST

↵ enter

200 OKapplication/json · 7ms

{ "query": "55.7558, 37.6173", "suggestions": [ { "value": "г Москва, пр-д Воскресенские Ворота, д 1А", "full": "109012, г Москва, пр-д Воскресенские Ворота, д 1А", "level": "house", "country": { "name": "Россия", "iso": "RU" }, "federal_district": "Центральный", "address": { "region": "Москва г", "city": "Москва", "street": "Воскресенские Ворота", "house": "1А" }, "components": { "region": { "name": "Москва", "type": "г", "fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5", "kladr_id": "7700000000000" }, "city": { "name": "Москва", "type": null, "fias_id": null, "kladr_id": null }, "city_district": { "name": "Тверской", "type": "р-н", "fias_id": null, "kladr_id": null }, "street": { "name": "Воскресенские Ворота", "type": "пр-д", "fias_id": "74824c4b-ef74-424b-a3d5-f2e9904f85d4", "kladr_id": "77000000000702300" }, "house": { "name": "1А", "type": "д", "block": null, "fias_id": "ca0b76a7-0f15-4365-83c0-7eb9643d97a8", "kladr_id": "7700000000070230001", "flat_count": null } }, "codes": { "postal": "109012", "kladr": "7700000000070230001", "region_kladr": "7700000000000", "region_iso": "RU-MOW", "okato": "45286585000", "oktmo": "45382000", "tax_office": "7710", "tax_office_legal": "7710" }, "fias_id": "ca0b76a7-0f15-4365-83c0-7eb9643d97a8", "fias_level": 8, "geo": { "lat": 55.755714, "lon": 37.617902, "precision": "exact" }, "timezone": "UTC+3", "metro": [ { "name": "Охотный Ряд", "line": "Сокольническая", "distance": 0.22 }, { "name": "Площадь Революции", "line": "Арбатско-Покровская", "distance": 0.23 }, { "name": "Театральная", "line": "Замоскворецкая", "distance": 0.34 } ], "beltway_hit": "IN_MKAD", "cadastral_num": "77:01:0001008:1011", "cadastre": { "type": "Здание", "object_name": "нежилое здание", "area": 404.3, "year_built": 1995, "year_commissioned": 1995, "floors": 4, "wall_material": "Кирпичные", "registered_at": "2012-05-22" }, "cadastral_cost": 24187469.87, "cadastral_cost_per_unit": 59825.55 } ] }

что вы получаете

Возможности адрес по координатам

Ближайший адрес

Дом, улица и населённый пункт по точке на карте.

Тот же разбор

Ответ как у подсказок адреса: компоненты, коды, индекс.

Радиус поиска

Несколько ближайших объектов, а не один.

Поля ответа 64

Нативный формат — структурированный JSON: каждый уровень отдельным полем, коды и координаты рядом со значением. Переключать ничего не нужно.

Адрес одной строкойАдрес одной строкой с индексомУровеньСтранаФедеральный округАдресЧасти адресаКоды классификаторовИдентификатор в ФИАСУровень адреса в ФИАСКоординатыЧасовой поясБлижайшее метроВнутри или снаружи МКАДКадастровый номерКадастровые сведенияКадастровая стоимостьКадастровая стоимость за единицу

Страна — название, код по iso

Адрес — регион, город, улица, дом, населённый пункт

Части адреса — регион, город, район города, улица, дом, населённый пункт

Коды классификаторов — почтовый индекс, код кладр, код региона в кладр, код региона по iso, код окато, код октмо, налоговая инспекция, налоговая инспекция для организаций

Координаты — широта, долгота, точность координат

Кадастровые сведения — тип, наименование объекта, район, год постройки, год ввода в эксплуатацию, этажей, материал стен, дата регистрации

Источник: ГАР/ФИАС ФНС России — государственный адресный реестр.

о сервисе

Что такое обратное геокодирование

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

Как подключить обратное геокодирование

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

Что важно знать про обратное геокодирование

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

тарификация

Подсказки

Подсказки входят в дневной лимит тарифа и доступны на всех планах, включая бесплатный.

в подпискепо дневному лимиту

Все тарифы и цены →

сценарии

Где это полезно

// delivery

Доставка

Точка на карте превращается в адрес с индексом.

// field

Выездные работы

Адрес объекта по координатам из приложения мастера.

// geo

Аналитика

Привязка событий с координатами к адресной иерархии.

вопросы

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

Сколько стоит?: Метод тарифицируется как обычный запрос к адресам. Бесплатного объёма хватает, чтобы проверить на своём потоке.
Насколько точно определяется дом?: В городской застройке возвращается конкретный дом. Чем реже застройка, тем крупнее ближайший объект — вплоть до населённого пункта.
Формат ответа отличается от подсказок адреса?: Нет, он тот же: компоненты, коды и индекс приходят в одинаковом виде, поэтому отдельная обработка не нужна.

по теме