Стандартизация адресов
API проверяет адреса по актуальной базе ФИАС. Добавляет почтовый индекс, ФИАС-ID, координаты, коды ОКАТО/ОКТМО. Обновление базы — еженедельно.
Вход
"москва ленинский 42"Результат
{
"result": "г Москва, пр-кт Ленинский",
"region": "г Москва",
"street": "пр-кт Ленинский",
"house": "42",
"fias_id": "5f2a1243-...",
"geo_lat": 55.7034,
"geo_lon": 37.5659,
"qc_geo": 0,
"qc": 0
}Проблема
Адреса в базах данных — хаос:
- «Ленинский пр-т» vs «Ленинский проспект» vs «пр. Ленинский»
- Устаревшие названия улиц и районов
- Опечатки и сокращения
- Отсутствие индекса или неверный индекс
- Несуществующие адреса (ошибки ввода)
Результат: возвраты посылок, письма на несуществующие адреса, проблемы с геолокацией. По статистике логистических компаний, до 8% посылок возвращаются из-за ошибок в адресе.
Попробуйте сами
Что делает API
- ✓Разбирает адрес на компоненты (регион, город, улица, дом)
- ✓Проверяет по базе ФИАС/ГАР и возвращает fias_id
- ✓Определяет почтовый индекс
- ✓Геокодирование (координаты по адресу)
- ✓Подсказки при вводе
- ✓Обрабатывает транслит: Moskovskaya obl → Московская обл
- ✓Переводит английские названия: Moscow → Москва
- ✓Нормализует сокращения: г. Мск → г. Москва
- ✓Возвращает код качества (QC) для оценки результата
В планах (TODO)
- ○Обратное геокодирование (адрес по координатам)
- ○Определение часового пояса
- ○Проверка актуальности адреса
Как работает
Двухэтапная обработка:
- NER-разметка: модель на базе RuBERT определяет, где регион, город, улица, дом
- Проверка по ФИАС: сверка с официальной базой адресов России
- Дополнение данных: индекс, координаты, коды классификаторов
- Валидация: проверка существования адреса
База ФИАС обновляется еженедельно из официального источника ФНС. Содержит 60+ млн адресных объектов.
Возможности
Проверка по ФИАС
Валидация существования адреса в официальной базе
Почтовый индекс
Автодополнение или проверка существующего
ФИАС-идентификаторы
Уникальные ID для интеграции с госсервисами
ОКАТО/ОКТМО
Коды для налоговой и статистической отчётности
Координаты
Широта и долгота для геолокации
Стандартизация
Единый формат написания адреса
Batch-обработка
До 100 адресов в одном запросе
Альтернативы
Варианты при неточном совпадении
Примеры кода
curl
curl -X POST https://api.humandata.ru/api/v1/clean/address \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "москва ленинский 42"}'Python
import requests
response = requests.post(
"https://api.humandata.ru/api/v1/clean/address",
headers={"Authorization": "Token YOUR_API_KEY"},
json={"query": "москва ленинский 42"}
)
result = response.json()
print(result["result"]["geo_lat"]) # 55.7034
print(result["result"]["qc"]) # 0JavaScript
const response = await fetch("https://api.humandata.ru/api/v1/clean/address", {
method: "POST",
headers: {
"Authorization": "Token YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({ query: "москва ленинский 42" })
});
const result = await response.json();
console.log(result.result.geo_lat); // 55.7034Кейсы использования
Частые вопросы
Как часто обновляется база ФИАС?
Еженедельно. Мы загружаем дельта-обновления из официального источника ФНС каждый понедельник.
Что если адрес существует, но его нет в ФИАС?
Такое бывает с новостройками и недавно присвоёнными адресами. API вернёт is_valid: false, но попытается разобрать структуру. Рекомендуем проверить адрес через 1-2 недели после присвоения.
Поддерживаются ли адреса СНГ?
Только Россия. ФИАС — это база адресов РФ. Для других стран используйте специализированные сервисы.
Насколько точны координаты?
Координаты берутся из OpenStreetMap. Точность зависит от детализации: для домов — до дома (qc_geo=0), для улиц — центр улицы (qc_geo=2), для городов — центр города (qc_geo=3). Поле qc_geo в ответе показывает уровень точности.
Попробуйте бесплатно
1000 запросов в месяц — без оплаты. Достаточно для тестирования и небольших проектов.