Documentação > Favelas

Favelas

A PrismaData oferece acesso via API a dados enriquecidos sobre características socioeconômicas e demográficas associadas a coordenadas geográficas ou endereços.

Ideal para instituições financeiras, seguradoras, proptechs e empresas de compliance que desejam enriquecer seus modelos preditivos ou processos de análise e/ou verificação.

O dado de favelas é relevante porque permite caracterizar o ambiente socioespacial imediato de um ponto geográfico, indo além da divisão administrativa formal e capturando estruturas urbanas informais que influenciam diretamente risco, acesso a serviços, comportamento econômico e dinâmica social.

Favelas e complexos de favelas constituem territórios com organização própria, alta densidade populacional, padrões construtivos específicos e, frequentemente, regimes diferenciados de provisão estatal, segurança e infraestrutura. Tratar esses territórios como homogêneos ao restante do tecido urbano reduz significativamente a qualidade de análises que dependem de contexto territorial fino.

Ao retornar atributos como distância exata à borda da favela, posição relativa do ponto (dentro ou fora), tamanho, perímetro e número de domicílios, bem como a hierarquia espacial entre favela, complexo e ilhas internas, a API converte a favela de um rótulo genérico em uma variável contínua, mensurável e modelável.

Na prática, o dado é especialmente valioso para:

Crédito e modelos socioeconômicos, ao capturar heterogeneidade urbana que não aparece em CEP ou setor censitário;

Seguros, ao refinar avaliação de risco operacional, sinistro e exposição territorial;

Fraude e compliance, ao identificar áreas com dinâmicas informais que impactam verificação de endereço e identidade;

Logística e serviços, ao antecipar desafios de acesso, entrega e cobertura;

Políticas públicas e inteligência urbana, ao diferenciar favelas isoladas de grandes complexos integrados.

Exemplo de uso - Algomerado da Serra, BH - MG

Entrada:
(lat, lng) (-19.934913036190277, -43.90757230536786)
Resposta:
{
"complexo_area_m2": 1755169.882444958,
"complexo_distancia_centroid_m": 459.36,
"complexo_distancia_m": -405.9,
"complexo_dompp_total": 13901.0,
"complexo_hash_id": 6146791748692799037,
"complexo_municipio": "Belo Horizonte",
"complexo_perimetro_m": 10054.86267269001,
"complexo_total_favelas": 9,
"complexo_uf": "Minas Gerais",
"favela_area_m2": 172669.89,
"favela_distancia_centroid_m": 115.51,
"favela_distancia_m": -107.23,
"favela_dompp_total": 1324.0,
"favela_hash_id": 8076882396877736653,
"favela_municipio": "Belo Horizonte",
"favela_perimetro_m": 2304.74,
"favela_uf": "Minas Gerais",
"ilha_area_m2": 64746.69,
"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 destacado na imagem é um ponto contido em uma favela que junto à outras 8 favelas (cada uma delas delimitadas por uma linha vermelha) compõem um complexo de favelas (destacado com fundo azul). O ponto se encontra distante 107 metros da borda da favela que o contém já que seu valor é negativo. O ponto externo mais próximo do complexo de favelas que contém o ponto está distante 405 metros deste. Este complexo de favelas possui uma ilha, conforme pode ser visto na imagem na região interna do complexo que não está azul. Esta região é um conjunto habitacional dentro do complexo de favelas. É uma ilha pois apesar dos domicílios ali presentes não possuírem as características típicas de domicílios de favelas, é uma regão que está rodeada por domicílios de favelas. Além das informações de distâncias, informações que indicam o porte das entidades são fornecidas como a quantidade de domicílios particulares e permanetes, e os tamanhos da área e perímetro das geometrias. No canto inferior esquerdo da imagem é possível ver outras 3 favelas bem menores que não formam um complexo de favelas.

Aglomerado da Serra, BH - MG (Conjunto Habitacional)

Entrada:
(lat, lng) (-19.935717576905642, -43.904905911382656)
Resposta:
{
"complexo_area_m2": 1755169.882444958,
"complexo_distancia_centroid_m": 716.53,
"complexo_distancia_m": 103.01,
"complexo_dompp_total": 13901.0,
"complexo_hash_id": 6146791748692799037,
"complexo_municipio": "Belo Horizonte",
"complexo_perimetro_m": 10054.86267269001,
"complexo_total_favelas": 9,
"complexo_uf": "Minas Gerais",
"favela_area_m2": 601334.87,
"favela_distancia_centroid_m": 259.56,
"favela_distancia_m": 103.01,
"favela_dompp_total": 3604.0,
"favela_hash_id": -8960810111489836645,
"favela_municipio": "Belo Horizonte",
"favela_perimetro_m": 7155.08,
"favela_uf": "Minas Gerais",
"ilha_area_m2": 64746.69,
"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"
}

Agora, analisando um ponto interno da ilha na favela, pelo sinal negativo em sua distância (-103 metros) indica-se que o ponto se encontra dentro da ilha, ao passo que pelo sinal positivo para o complexo e favela, indica que o ponto não se encontra contido em uma favela ou complexo de favelas.

Bairro Serra, BH - MG (Bairro Nobre, próximo a favela)

Entrada:
(lat, lng) (-19.933284645466298, -43.9191946695413)
Resposta:

"complexo_area_m2": 1755169.882444958,
"complexo_distancia_centroid_m": 847.28,
"complexo_distancia_m": 132.96,
"complexo_dompp_total": 13901.0,
"complexo_hash_id": 6146791748692799037,
"complexo_municipio": "Belo Horizonte",
"complexo_perimetro_m": 10054.86267269001,
"complexo_total_favelas": 9,
"complexo_uf": "Minas Gerais",
"favela_area_m2": 114306.97,
"favela_distancia_centroid_m": 280.37,
"favela_distancia_m": 132.96,
"favela_dompp_total": 1394.0,
"favela_hash_id": 6476692552498675674,
"favela_municipio": "Belo Horizonte",
"favela_perimetro_m": 1992.69,
"favela_uf": "Minas Gerais",
"ilha_area_m2": 64746.69,
"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"
}

Finalmente, um ponto no Bairro Serra, próximo ao complexo de favelas mas não contido dentro do complexo, todas as distâncias se tornam positivas (indicando que não se encontra internamente à favela/complexo/ilha) e seu valor absoluto indica o quão próximo ele está do complexo de favelas.

Entradas

  • latitude: Latitude da coordenada geográfica do ponto do qual se deseja analisar.
  • longitude: Longitude da coordenada geográfica do ponto do qual se deseja analisar.

Atributos Retornados

  • complexo_area_m2: tamanho da área em metros quadrados do complexo mais pŕoximo ao ponto.
  • complexo_distancia_centroid_m: a distância em metros do ponto até o miolo, ou ponto central do complexo.
  • complexo_distancia_m: a distância em metros do ponto até a borda do complexo. Se o valor for negativo, o ponto se encontra dentro do complexo. Se for negativo, se econtra fora do complexo de favelas.
  • complexo_dompp_total: número total de domicílios particulares permanentes que estão contidos no complexo mais próximo ao ponto.
  • complexo_hash_id: id que identifica unicamente o complexo
  • complexo_municipio: nome do município em que se encontra o complexo.
  • complexo_perimetro: o perimetro em metros da geometria que define o complexo de favelas.
  • complexo_total_favelas: quantidade de favelas que formam o complexo de favelas.
  • complexo_uf: Unidade Federativa em que se encotnra o complexo.
  • favela_area_m2: tamanho da área em metros quadrados da favela mais próxima ao ponto.
  • favela_distancia_centroid_m: distância em metros que o ponto se encontra do miolo ou ponto central da favela mais próxima à ele.
  • favela_distancia_m: a distância em metros à fronteira da favela. Valores positivos indicam um ponto fora da favela e valores negativos indicam um ponto dentro dos limites da favela.
  • favela_dompp_total: quantidade de domicílios particulares permanentes da favela mais próxima ao ponto.
  • favela_hash_id: identificador que indetifica unicamente a favela.
  • favela_municipio: nome do município em que se encontra a favela mais pŕoxima ao ponto.
  • favela_perimetro_m: o perímetro em metros da geometria que define os limites da favela.
  • favela_uf: Unidade Federativa em que se encontra a favela.
  • ilha_area_m2: área em metros quadrados da ilha mais próxima ao ponto.
  • ilha_distancia_centroid_m: distância do ponto ao centroid da ilha mais próxima à ele.
  • ilha_distancia_m: distância do ponto à borda da ilha mais próxima à ele. Valores positivos indicam um ponto contido fora dos limites da ilha, enquanto valores negativos indicam o ponto contido dentro dos limites da ilha.
  • ilha_hash_id: valor que identifica unicamente a ilha mais proxima ao ponto.
  • ilha_perimetro_m: o perimetro em metros da geometria de delimita a ilha mais próxima ao ponto.
  • ilha_tipo_geom_contenedora: indica se a ilha está contida em uma favela ou em um complexo de favelas