API › Location › Favelas

# Favelas

Dados geoespaciais sobre favelas, complexos e ilhas para enriquecer modelos de risco, crédito e compliance com contexto territorial que bureaus tradicionais não capturam. 

Categoria Location

Atualização Semestral

Fonte IBGE + mapeamento interno

Raio máximo 5.000 m

Nesta página

Aplicações Conceito Convenção de sinais Entradas Exemplos Atributos retornados Detalhes técnicos Limitações

Para que serve

## 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.

Entendendo o dado

## 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

#### Favela

Região classificada pelo IBGE em função das características construtivas dos domicílios. É a unidade base do dado. 

Complexo

#### 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

#### 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. 

Interpretação

## Convenção de Sinais

A relação espacial entre o ponto consultado e cada entidade é lida diretamente do **sinal** do campo `*_distancia_m` — não há campo booleano dedicado. Valor negativo indica que o ponto está dentro da entidade; valor positivo, fora. O valor absoluto é a distância até a borda mais próxima. 

−

**Valor negativo → ponto dentro da entidade** O valor absoluto indica a distância até a borda mais próxima, de dentro para fora.

+

**Valor positivo → ponto fora da entidade** O valor indica a distância até a borda mais próxima, de fora para dentro.

Request

## Parâmetros de Entrada

`lat` float

Latitude WGS84 do ponto a ser analisado.

`lng` float

Longitude WGS84 do ponto a ser analisado.

Na prática

## Exemplos

Três cenários reais no Aglomerado da Serra (BH) ilustram como interpretar o retorno em diferentes contextos espaciais. 

Ponto dentro de uma favela -19.9349, -43.9076

![Mapa: ponto dentro de favela no Aglomerado da Serra, BH](https://prismadata.io/imagens/favelas/favela_1.jpg)
    
    
    {
      "complexo_area_m2": 1755169.88,
      "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_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_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. 

Ponto dentro de uma ilha (conjunto habitacional) -19.9357, -43.9049

![Mapa: ponto dentro de ilha \(conjunto habitacional\) no Aglomerado da Serra, BH](https://prismadata.io/imagens/favelas/favela_2.jpg)
    
    
    {
      "complexo_area_m2": 1755169.88,
      "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_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_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. 

Ponto fora do complexo (bairro nobre próximo) -19.9333, -43.9192

![Mapa: ponto fora do complexo no Bairro Serra, BH](https://prismadata.io/imagens/favelas/favela_3.jpg)
    
    
    {
      "complexo_area_m2": 1755169.88,
      "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_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_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. 

Response

## 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. 

Favela

favela_distancia_m

Distância em metros à borda da favela mais próxima. Negativo = dentro; positivo = fora.

favela_distancia_centroid_m

Distância em metros ao centroide (ponto central) da favela mais próxima.

favela_area_m2

Área em metros quadrados da favela mais próxima.

favela_perimetro_m

Perímetro em metros da geometria que delimita a favela.

favela_dompp_total

Total de domicílios particulares permanentes na favela mais próxima (dados do Censo 2022).

favela_hash_id

Identificador único da favela.

favela_municipio

Município em que se encontra a favela.

favela_uf

Unidade Federativa em que se encontra a favela.

Complexo

complexo_distancia_m

Distância em metros à borda do complexo mais próximo. Negativo = dentro; positivo = fora.

complexo_distancia_centroid_m

Distância em metros ao centroide do complexo mais próximo.

complexo_area_m2

Área em metros quadrados do complexo.

complexo_perimetro_m

Perímetro em metros da geometria do complexo.

complexo_dompp_total

Total de domicílios particulares permanentes no complexo (Censo 2022).

complexo_total_favelas

Quantidade de favelas que compõem o complexo.

complexo_hash_id

Identificador único do complexo.

complexo_municipio

Município em que se encontra o complexo.

complexo_uf

Unidade Federativa do complexo.

Ilha

ilha_distancia_m

Distância em metros à borda da ilha mais próxima. Negativo = dentro; positivo = fora.

ilha_distancia_centroid_m

Distância em metros ao centroide da ilha mais próxima.

ilha_area_m2

Área em metros quadrados da ilha.

ilha_perimetro_m

Perímetro em metros da geometria da ilha.

ilha_hash_id

Identificador único da ilha.

ilha_tipo_geom_contenedora

Indica se a ilha está contida em uma favela isolada ou em um complexo de favelas.

Referência

## 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.

Atenção

## 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