Documentação Técnica

Endereços em Área de Risco

Descrição

O dataset de Endereços em Área de Risco identifica se um ponto geográfico informado está situado dentro ou a certa distância de uma área de comunidade delimitada, conforme os dados oficiais do IBGE. Para realizar a consulta, é necessário informar a latitude e longitude do local desejado. Além da classificação do ponto, o dataset também fornece a mesma classificação para raios específicos de distância do ponto consultado (10m, 25m, 50m e 100m). Essas informações indicam se o ponto pode estar em uma área de risco, auxiliando em análises de segurança, crédito, onboarding, logística e outras decisões sensíveis à localização.

Origem da Informação

Este dataset reúne informações sobre áreas de comunidade baseadas nos dados oficiais do Instituto Brasileiro de Geografia e Estatística (IBGE).

Tabela de preços para esse dataset

Consultas Realizadas no MêsValor por consulta
1 - 10000R$ 0,070
10001 - 50000R$ 0,066
50001 - 100000R$ 0,063
100001 - 500000R$ 0,060
500001 - 1000000R$ 0,057
1000001 - 5000000R$ 46,000.00 (preço fixo)
5000001 e acimaEntre em contato

Parâmetros de consulta

A tabela abaixo detalha os campos aceitos na consulta a este dataset.

CampoDescriçãoValores PossíveisTipo de Campo
latlongLatitude e longitude de buscaCoordenadas da área. Ex.: -12.345678 , -45.678901🛑 Obrigatório

Clique aqui para saber mais sobre os parâmetros de consulta da Plataforma de Dados.

Abaixo está um exemplo de como realizar a chamada apenas com os parâmetros obrigatórios:

{  
    "Datasets": "address_risk",
    "q": "latlong[lat,long]"  
}  

Retorno dos Dados

Este dataset retorna a classificação do ponto exato definido por latitude e longitude, além da classificação dos arredores da localização, por meio de raios específicos (10m, 25m, 50m e 100m). Veja os detalhes sobre os campos na descrição do objeto de resultado do dataset ao final desta página.

Códigos de Classificação

Cada campo retornado possui uma classificação de 1 a 3, conforme descrito na tabela abaixo.

ClassificaçãoLegenda
1Indica que o ponto ou área de busca está localizado dentro de uma comunidade setorizada, geralmente formada por comunidades de maior porte.
2Indica que o ponto ou área de busca está localizado dentro de uma comunidade não setorizada, geralmente formada por comunidades de menor porte.
3Indica que o ponto ou área de busca não está contido em nenhuma comunidade.
Language
Credentials
Click Try It! to start a request and see the response here!