Aplicações
O dado de favelas adiciona contexto territorial a decisões que hoje dependem exclusivamente de dados cadastrais. A distância e relação espacial de um ponto com favelas, complexos e ilhas é um sinal que diferencia perfis de risco aparentemente iguais.
Análise de Risco
Contextualize scores de crédito com a realidade territorial do endereço declarado pelo solicitante.
Prevenção a Fraude
Identifique divergências entre o perfil declarado e o contexto geoespacial real da localização informada.
Pricing de Seguros
Ajuste precificação de apólices considerando o contexto territorial do bem segurado ou do segurado.
Avaliação de Garantias
Refine a avaliação de imóveis em garantia com informações de proximidade a áreas de ocupação irregular.
Conceito
O dado é composto por três entidades geoespaciais derivadas da classificação do IBGE para aglomerados subnormais, enriquecidas com cálculos de distância e porte pela PrismaData.
Favela
Região classificada pelo IBGE em função das características construtivas dos domicílios. É a unidade base do dado.
Complexo de Favelas
Conjunto de favelas próximas entre si que formam uma unidade territorial contígua. Uma favela pode ou não pertencer a um complexo.
Ilha
Região interna a uma favela ou complexo cujos domicílios não se enquadram como favela (ex: conjuntos habitacionais), mas está cercada por área de favela.
Convenção de Sinais
Cada entidade possui um campo booleano *_contido que indica diretamente se o ponto está dentro (true) ou fora (false) da entidade. Os campos de distância (*_distancia_m) complementam com o sinal para indicar a posição relativa.
Parâmetros de Entrada
latitude
float
Latitude da coordenada geográfica do ponto a ser analisado.
longitude
float
Longitude da coordenada geográfica do ponto a ser analisado.
Exemplos
Três cenários reais no Aglomerado da Serra (BH) ilustram como interpretar o retorno em diferentes contextos espaciais.
{
"complexo_area_m2": 1755169.88,
"complexo_contido": true,
"complexo_distancia_centroid_m": 459.36,
"complexo_distancia_m": -405.9,
"complexo_dompp_total": 13901,
"complexo_hash_id": 6146791748692799037,
"complexo_municipio": "Belo Horizonte",
"complexo_perimetro_m": 10054.86,
"complexo_total_favelas": 9,
"complexo_uf": "Minas Gerais",
"favela_area_m2": 172669.89,
"favela_contido": true,
"favela_distancia_centroid_m": 115.51,
"favela_distancia_m": -107.23,
"favela_dompp_total": 1324,
"favela_hash_id": 8076882396877736653,
"favela_municipio": "Belo Horizonte",
"favela_perimetro_m": 2304.74,
"favela_uf": "Minas Gerais",
"ilha_area_m2": 64746.69,
"ilha_contido": false,
"ilha_distancia_centroid_m": 323.67,
"ilha_distancia_m": 141.14,
"ilha_hash_id": -3871855200304948974,
"ilha_perimetro_m": 1772.35,
"ilha_tipo_geom_contenedora": "COMPLEXO"
}
O ponto está dentro de uma favela (distância −107 m) e dentro do complexo de 9 favelas (distância −405 m). Está fora da ilha mais próxima (+141 m). O complexo possui 13.901 domicílios particulares permanentes.
{
"complexo_area_m2": 1755169.88,
"complexo_contido": false,
"complexo_distancia_centroid_m": 716.53,
"complexo_distancia_m": 103.01,
"complexo_dompp_total": 13901,
"complexo_hash_id": 6146791748692799037,
"complexo_municipio": "Belo Horizonte",
"complexo_perimetro_m": 10054.86,
"complexo_total_favelas": 9,
"complexo_uf": "Minas Gerais",
"favela_area_m2": 601334.87,
"favela_contido": false,
"favela_distancia_centroid_m": 259.56,
"favela_distancia_m": 103.01,
"favela_dompp_total": 3604,
"favela_hash_id": -8960810111489836645,
"favela_municipio": "Belo Horizonte",
"favela_perimetro_m": 7155.08,
"favela_uf": "Minas Gerais",
"ilha_area_m2": 64746.69,
"ilha_contido": true,
"ilha_distancia_centroid_m": 94.31,
"ilha_distancia_m": -103.01,
"ilha_hash_id": -3871855200304948974,
"ilha_perimetro_m": 1772.35,
"ilha_tipo_geom_contenedora": "COMPLEXO"
}
O ponto está dentro da ilha (distância −103 m) mas fora tanto da favela (+103 m) quanto do complexo (+103 m). Apesar de cercado por favela, o local em si possui características construtivas que não se enquadram como favela — típico de conjuntos habitacionais.
{
"complexo_area_m2": 1755169.88,
"complexo_contido": false,
"complexo_distancia_centroid_m": 847.28,
"complexo_distancia_m": 132.96,
"complexo_dompp_total": 13901,
"complexo_hash_id": 6146791748692799037,
"complexo_municipio": "Belo Horizonte",
"complexo_perimetro_m": 10054.86,
"complexo_total_favelas": 9,
"complexo_uf": "Minas Gerais",
"favela_area_m2": 114306.97,
"favela_contido": false,
"favela_distancia_centroid_m": 280.37,
"favela_distancia_m": 132.96,
"favela_dompp_total": 1394,
"favela_hash_id": 6476692552498675674,
"favela_municipio": "Belo Horizonte",
"favela_perimetro_m": 1992.69,
"favela_uf": "Minas Gerais",
"ilha_area_m2": 64746.69,
"ilha_contido": false,
"ilha_distancia_centroid_m": 1527.42,
"ilha_distancia_m": 1369.38,
"ilha_hash_id": -3871855200304948974,
"ilha_perimetro_m": 1772.35,
"ilha_tipo_geom_contenedora": "COMPLEXO"
}
Todas as distâncias são positivas — o ponto está fora de qualquer entidade. A favela e o complexo mais próximos ficam a 132 m, enquanto a ilha mais próxima está a 1.369 m. Demonstra como o dado captura a proximidade territorial mesmo para endereços que não estão em favela.
Atributos Retornados
O retorno é agrupado por entidade: favela, complexo e ilha. Cada grupo traz informações de distância, porte e identificação da entidade mais próxima ao ponto consultado.
true) ou fora (false).true) ou fora (false).true) ou fora (false).Detalhes Técnicos
Fontes
- IBGE — Aglomerados Subnormais (Censo 2022)
- Mapeamento interno PrismaData
Metodologia
Coleta dos dados de favelas do IBGE com processamento para identificação e geração dos dados de complexos de favelas e ilhas.
Frequência de Atualização
Base atualizada semestralmente.
Cobertura
Todo o território nacional. Pontos a mais de 5.000 m de qualquer entidade retornam valores nulos.
Limitações
Considere ao utilizar
- Os dados de domicílios são referentes ao Censo 2022 e representam uma fotografia daquele momento. Os totais de domicílios (
*_dompp_total) não são atualizados entre censos. - Pontos distantes a mais de 5.000 metros de qualquer favela retornam valores nulos para todas as entidades.
- A classificação de favela segue os critérios do IBGE para aglomerados subnormais, baseados nas características construtivas dos domicílios — e não em critérios de renda ou violência.
Pronto para testar?
Solicite acesso à sandbox da API de Favelas e veja o retorno para suas coordenadas.
Solicitar acesso