Aplicações
O geocoder é a ponte entre endereços textuais e coordenadas geográficas. É frequentemente o passo inicial para acessar os demais dados de Location da PrismaData (renda, favelas, presídios, fronteira, setor censitário) — que recebem latitude e longitude como entrada.
Enriquecimento de Base
Converta endereços cadastrais em coordenadas para alimentar APIs de renda, risco territorial, favelas e presídios — sem dependência de geocoders genéricos.
Validação Cadastral
Verifique se o endereço declarado pelo cliente existe e retorna coordenadas válidas. O score de qualidade indica o grau de confiança na geocodificação.
Geocodificação Reversa
Transforme coordenadas de GPS, dispositivos ou eventos em endereço completo — útil para rastreamento, logística e associação de eventos a localidades.
Padronização de Endereços
O retorno normaliza logradouro, bairro, município, UF e CEP em formato padronizado — reduzindo inconsistências de bases cadastrais legadas.
Conceito
O Geocoder da PrismaData é especializado no Brasil — não depende de provedores genéricos globais. Opera em dois modos complementares:
Endereço → Coordenada
Recebe componentes de endereço (logradouro, número, bairro, município, UF, CEP) e retorna latitude, longitude, endereço normalizado e score de qualidade de 0 a 100.
Coordenada → Endereço
Recebe latitude e longitude e retorna o endereço mais próximo, com a distância em metros entre a coordenada de entrada e o ponto do endereço encontrado.
O geocoder é frequentemente o primeiro passo para consumir os demais dados de Location da PrismaData. A coordenada retornada pelo geocoder direto pode ser usada como entrada para as APIs de Renda, Favelas, Presídios, Fronteira e Setor Censitário.
Geocoder Direto
Converte um endereço textual em coordenadas geográficas. Aceita o endereço completo ou campos separados.
Parâmetros de Entrada
Atributos Retornados
MUITO_ALTA, ALTA, MEDIA, BAIXA ou MUITO_BAIXA.Geocoder Reverso
Converte coordenadas geográficas no endereço mais próximo, com a distância em metros entre o ponto de entrada e o endereço encontrado.
Parâmetros de Entrada
latitude
float
Latitude da coordenada geográfica a ser geocodificada reversamente.
longitude
float
Longitude da coordenada geográfica a ser geocodificada reversamente.
Atributos Retornados
Exemplos
Dois cenários reais ilustram os dois modos do geocoder: direto (endereço → coordenada) e reverso (coordenada → endereço).
Rua Alagoas, 601, Savassi — Belo Horizonte — MG — 30130-165
{
"prismadata__geocoder__cep": "30130-160",
"prismadata__geocoder__classificao_qualidade_geocodificacao": "MUITO_ALTA",
"prismadata__geocoder__endereco_completo": "RUA ALAGOAS, 601 - SAVASSI, BELO HORIZONTE - MG, 30130-160",
"prismadata__geocoder__latitude": -19.932592391967773,
"prismadata__geocoder__localidade": "SAVASSI",
"prismadata__geocoder__logradouro": "RUA ALAGOAS",
"prismadata__geocoder__longitude": -43.93540573120117,
"prismadata__geocoder__municipio": "BELO HORIZONTE",
"prismadata__geocoder__numero": 601,
"prismadata__geocoder__score_qualidade_geocodificacao": 100.0,
"prismadata__geocoder__uf": "MG"
}
Endereço geocodificado com score 100 — MUITO ALTA. A coordenada retornada (-19.9326, -43.9354) corresponde ao endereço exato da sede da PrismaData na Savassi. O retorno normaliza os componentes do endereço em campos separados e padronizados.
latitude = -22.98627572993613 | longitude = -43.208798617447684
{
"prismadata__reverse_geocoder__cep": "22420-008",
"prismadata__reverse_geocoder__distancia_m": 7.02674626,
"prismadata__reverse_geocoder__endereco_completo": "AVENIDA VIEIRA SOUTO, 516 - IPANEMA, RIO DE JANEIRO - RJ, 22420-008",
"prismadata__reverse_geocoder__latitude_endereco": -22.986234664916992,
"prismadata__reverse_geocoder__latitude_input": -22.98627572993613,
"prismadata__reverse_geocoder__localidade": "IPANEMA",
"prismadata__reverse_geocoder__logradouro": "AVENIDA VIEIRA SOUTO",
"prismadata__reverse_geocoder__longitude_endereco": -43.2088508605957,
"prismadata__reverse_geocoder__longitude_input": -43.208798617447684,
"prismadata__reverse_geocoder__municipio": "RIO DE JANEIRO",
"prismadata__reverse_geocoder__numero": 516,
"prismadata__reverse_geocoder__uf": "RJ"
}
A coordenada de entrada foi resolvida para Av. Vieira Souto, 516 — Ipanema, RJ. A distância entre o ponto informado e o endereço encontrado é de apenas 7,03 metros. O retorno inclui tanto as coordenadas de entrada (input) quanto as do endereço encontrado, permitindo calcular e verificar a precisão da resolução.
Detalhes Técnicos
Fontes
- IBGE — Malha de endereços e logradouros
- OpenStreetMap (OSM)
- Overture Maps
- Processamento e agregação PrismaData
Cobertura
Exclusivamente Brasil — todo o território nacional. Endereços ou coordenadas fora do Brasil não são suportados. A cobertura é maior em áreas urbanas e pode ser limitada em regiões rurais remotas ou loteamentos muito recentes.
Atualização
- Base de endereços: mensal
- Algoritmo de geocodificação: atualizado continuamente
Metodologia
Agregação de múltiplas bases de endereços (IBGE, OSM, Overture Maps) com metodologia proprietária PrismaData para matching, normalização e resolução de coordenadas. Score de qualidade calculado com base no nível de correspondência entre entrada e base.
Limitações
Considere ao utilizar
- O geocoder opera exclusivamente no Brasil. Endereços ou coordenadas fora do território nacional não são suportados.
- Não há garantia de que toda geocodificação será bem-sucedida. Bases cadastrais podem conter endereços inconsistentes, desatualizados ou com grafia divergente das fontes de referência. Use o
score_qualidade_geocodificacaopara avaliar a confiabilidade do resultado. - Loteamentos muito recentes, áreas rurais remotas ou ocupações informais podem ter cobertura limitada nas bases de referência.
- O geocoder reverso retorna o endereço mais próximo da coordenada informada. Em áreas de baixa densidade de endereços, a distância (
distancia_m) pode ser grande — avalie este campo para decidir se o resultado é aceitável. - O campo
classificacao_qualidade_geocodificacaoestá disponível apenas no geocoder direto. O reverso retornadistancia_mcomo proxy de qualidade.
Pronto para testar?
Solicite acesso à sandbox do Geocoder e converta seus endereços em coordenadas — ou vice-versa.
Solicitar acesso