Buscar lugares para o mapa

Busca cidades, bairros, ruas e CEPs na base de referência do IBGE (CNEFE 2022) carregada no servidor, sem chamar provedor externo e sem gravar nada. q com 5 a 8 dígitos (com ou sem hífen) busca CEPs pelo prefixo; outro texto (2 a 60 caracteres) busca pelo início do nome, sem diferenciar acento nem maiúsculas, em cidades, bairros e ruas ao mesmo tempo. Para ruas, uma palavra de tipo no início (rua, av, travessa) é ignorada. Até 10 resultados: primeiro os nomes iguais ao texto, depois os com mais endereços, agrupados por tipo (cidade, bairro, rua, CEP). Cada item traz o rótulo, a UF, a cidade com o código IBGE e a chave do filtro de cidade (cityKey), o bairro com a chave do filtro de bairro (districtPair) quando houver, o ponto de referência com a precisão e, para cidade e bairro, a caixa (bounds) para enquadrar o mapa. Uma rua com mais de um CEP no mesmo bairro traz zipCount e nenhum zipCode. coveredStates lista as UFs carregadas. state e cityCode restringem a busca. As respostas ficam em cache até a próxima carga da base (Cache-Control: private, max-age=3600). Recusas: 400 place_query_invalid, 400 place_scope_invalid, 422 reference_not_loaded (a UF pedida, ou nenhuma, não está carregada; details.coveredStates traz a lista das UFs carregadas), 503 reference_unavailable, 503 place_search_unavailable (rota não ligada) e 503 com Retry-After quando o servidor está ocupado.

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

Texto ou CEP (2 a 60 caracteres)

string

UF ou nome do estado

string

Código IBGE da cidade (7 dígitos)

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