Normalização de endereços para a América do Sul.
Os nomes de estado e abreviações variam por país. Os códigos postais seguem formatos diferentes. A Normadata faz parse da estrutura, resolve o estado para ISO 3166-2 e nunca toca um geocoder. O endereço viaja como campo address dentro de um record em /v1/validate/records.
Os geocoders cobram dinheiro que você não precisa gastar
Se a sua meta é dado de endereço estruturado — não um pin num mapa — as APIs de geocoding cobram por valor que você não usa. Os nomes de estado sozinhos já são uma bagunça: "buenos aires" vs "Buenos Aires" vs "AR-B", "São Paulo" vs "SP", "Amazonas" existe em BR, CO, PE e VE. A Normadata faz parse do input livre em componentes, normaliza nomes de estado para ISO 3166-2 e desambígua com o country do record.
Estrutura sem geocoder
Como o campo address é normalizado dentro de um record.
Parsing de componentes
Rua, número, andar, unidade, localidade, estado e país. Sem geocoding, sem lookup externo.
Normalização de estado
Nome completo, sufixo ISO 3166-2 ou alias comum resolvidos contra a tabela de estados por país.
Dicionário de cidades
Lookup de top-cities por país. Devolve um aviso em vez de um falso negativo para inputs long-tail.
Campo de um record
O endereço é enviado como campo address de um record; volta dentro de fields.address.
Mercados sul-americanos · dicionários de estado e cidade
As tabelas de estado abrangem cada mercado sul-americano vivo. O country do record desambígua nomes compartilhados (Amazonas, Córdoba, San Juan).
O endereço, como campo de um record
Mande o endereço no campo address de um record em /v1/validate/records. Volta normalizado dentro de fields.address, com o estado em ISO 3166-2.
$ curl -X POST https://api.normadata.io/v1/validate/records \
-H "X-API-Key: nd_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5" \
-H "Content-Type: application/json" \
-d '{"items":[
{"reference_id":"prov-001","country":"AR","address":"Av. Corrientes 1234, Piso 5, Buenos Aires"}
]}'{
"results": [
{
"reference_id": "prov-001",
"country": "AR",
"fields": {
"address": {
"normalized": "Av. Corrientes 1234, Piso 5",
"components": {
"street": "Av. Corrientes",
"number": "1234",
"floor": "5",
"locality": "Buenos Aires"
},
"state": { "normalized": "Buenos Aires", "iso_3166_2": "AR-B" },
"valid": true
}
},
"consistency": [],
"readiness": {
"payment": { "status": "blocked", "reason": "tax_id is missing" },
"billing": { "status": "blocked", "reason": "tax_id is missing" }
}
}
]
}Como a Normadata se compara?
Comparações honestas contra as alternativas que mais nos perguntam.
Normadata vs. AbstractAPI
Plataforma global de APIs — e uma proposta mais leve de estrutura de endereços para LATAM.
Normadata vs. Loqate
A biblioteca NPM open-source de fato cobre alguns helpers de address — e onde fica aquém com estados LATAM.
Normadata vs. Melissa
Plataforma KYC completa que roda depois da validação de formato de endereço, não no lugar dela.
Estrutura de endereços sem a fatura do geocoder
Grátis durante o acesso antecipado. Mande um email e respondemos em 24 horas.