GeoCEP.api.br
DICIONÁRIO DE DADOS & INTELIGÊNCIA

Níveis de Precisão de Coordenadas

Cada resposta georreferenciada da API GeoCEP inclui o atributo precisao. Entenda o que cada valor significa e por que ele varia.

numero_exatoPorta de Entrada Predial
Métrica (< 5m)

Coordenada exata de entrada do lote ou edifício. Retornada quando o número predial informado consta na Base Nacional oficial auditada.

Recomendação: Entregas last-mile, frotas urbanas, delivery e drones.
crowdsourced_consensoConsenso de Campo
Auditada (< 10m)

Coordenada validada por múltiplos motoristas/entregadores em campo via algoritmo de triangulação espacial e auditoria de reputação.

Recomendação: Numerações novas, condomínios fechados e áreas de recente expansão.
rua_interpoladaEixo do Logradouro
Eixo Viário (< 25m)

Ponto posicionado ao longo da extensão da rua. Ocorre quando o número solicitado ainda não tem o ponto individual de porta catalogado.

Recomendação: Navegação veicular, cálculo de frete e estimativas de tempo de tráfego.
centroideCentro Geográfico
Área (~100m)

Centroide médio do logradouro ou zona postal. Retornado sempre que a consulta é feita apenas pelo CEP sem informar o número predial.

Recomendação: Autocomplete de checkout de e-commerce, validação cadastral e precificação.
coordenada_diretaGPS Fornecido
Coordenada Bruta

Coordenadas brutas enviadas diretamente pelo cliente no payload da requisição.

Recomendação: Roteirização customizada e geocodificação reversa.

Perguntas Frequentes sobre Precisão

Por que consultei um número e veio como rua_interpolada?

O Brasil possui áreas de expansão recente e novos empreendimentos imobiliários onde números específicos ainda não constam com o ponto métrico catalogado no Censo presencial. Nesses casos, para nunca quebrar a operação do cliente com erro 404, a API entrega as coordenadas interpoladas no eixo da rua.

Como a precisão melhora ao longo do tempo?

Conforme motoristas, entregadores e parceiros utilizam o endpoint de crowdsourcing (/v1/contribute) e confirmam entregas no local, nosso motor espacial valida o consenso e promove o ponto automaticamente para numero_exato.