Documentação de Produto - PrismaData API

📌 Visão Geral

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.

🧪 Exemplos de uso

📍 Aglomerado da Serra, BH - MG

(lat, lng) <--> (-19.934913036190277, -43.90757230536786)

{
  "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)

(lat, lng) <--> (-19.935717576905642, -43.904905911382656)

{
  "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)

(lat, lng) <--> (-19.933284645466298, -43.9191946695413)

{
  "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.

💡 Favelas

O dado de favelas é indicado para avaliação de riscos e de concessão de crédito. Existem 3 entidades que compõem o dado de favelas: Favelas, complexos e ilhas. As favelas propriamente ditas que são regiões que são classifcadas desta forma pelo IBGE em função das características construtivas do domicílios contidos nesta região. Note que favelas, em conjunto, quando se encontram próximas, podem formar complexos de favelas. Além disso, é possível a existência de regiões dentro de favelas ou complexos nas quais os aspectos construtivos dos domicílios não se enquadram dentro do conceito do IBGE para que um domicílio seja considerado de favela, contudo são regiões que estão cercadas por regiões de favela. Neste caso, denominou-se esta região de ilha, já que ela se encontra rodeada por favela apesar dela própria não ser uma região de favela. Frequentemente as ilhas, são regiões que contêm domicilios de conjuntos habitacionais. Caso o ponto se encontre distante mais de 5000 metros de uma entidade valores vazios são retornados.

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

🔁 Atualizações

Base atualizada semestralmente.

📚 Fontes

• IBGE
• Mapeamentos interno

⚙️ Metodologia

Coleta dos dados de favelas do IBGE e manipulação destes dados parar a geração dos dados de complexo de favelas e de ilhas em favelas.

❗ Limitações