Ponto de referência de um CEP ou endereço

Acha o ponto de referência do IBGE (CNEFE 2022) para um CEP ou um endereço, sem gravar nada e sem chamar provedor externo. Escolhe o melhor ponto entre o do CEP (street com dispersão abaixo de 300 m, postal_code até 1.500 m, city acima disso ou para CEP genérico terminado em 000), o do bairro (district, pelo par cidade e bairro) e o da cidade (city). Quando o melhor ponto só identifica a cidade (CEP genérico, CEP espalhado pela cidade ou só cidade com UF), wholeCity vem true e o ponto é o centro da cidade da base, para o raio partir dele. city e state nomeiam a cidade do ponto quando a base a conhece (vazios caso contrário). Precisa de um zipCode válido ou de city com state; district refina quando não há CEP. Serve de centro para o raio a partir de um endereço ou CEP no mapa e de início do pino no editor de endereço. attribution é a fonte a citar. Recusas: 400 reference_query_invalid (sem CEP válido nem cidade com UF, ou campo inválido), 422 reference_not_loaded (a base de referência não está carregada para a UF do lugar; com só parte das UFs carregadas, um CEP fora da base e sem UF também cai aqui), 404 reference_point_not_found (a UF está carregada, mas não há ponto para o lugar), 503 reference_unavailable (a base não pôde ser lida) e 503 reference_point_unavailable (a rota não está ligada).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

CEP com ou sem máscara

string

Bairro

string

Cidade

string

UF ou nome do estado

Headers
string

Workspace da requisição. Sem ele vale o workspace padrão da pessoa; um workspace do qual ela não participa responde 403 workspace_not_member.

string

Departamento que limita os dados. Quem não participa do departamento recebe 403; donos e administradores escolhem qualquer um.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json