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

📍 Lourdes, BH (bairro nobre)

(lat, lng) <--> (-19.934418443389507, -43.942887201464195)

Renda comparada <--> R$ 10.000,00

Rua Rio de Janeiro, 2300 - Lourdes - Belo Horizonte, MG

{
  "qtde_pessoas": 485.0,
  "qtde_pessoas_sem_renda": 119.0,
  "renda_comparada_cdf": 21.624639290067826,
  "renda_comparada_pdf": 0.000054327178840454175,
  "renda_comparada_z_score": -0.7849331137654249,
  "renda_media_pessoas": 13333.191698804743,
  "renda_pessoas_com_renda_desvio_padrao": 10272.67510836109,
  "renda_pessoas_com_renda_maxima": 69123.23121828807,
  "renda_pessoas_com_renda_media": 17668.300475192078,
  "renda_pessoas_com_renda_mediana": 21002.905178527595,
  "renda_pessoas_com_renda_minima": 813.4884030701737,
  "renda_pessoas_com_renda_primeiro_quartil": 8969.07389667755,
  "renda_pessoas_com_renda_qtde": 366.0,
  "renda_pessoas_com_renda_terceiro_quartil": 24106.351176425094,
  "renda_total": 6466597.973920301,
  "renda_total_m2": 324.0685594584635

}

As pessoas que habitam no entorno deste ponto possuem uma renda típica de R$ 17.668,30. Além disso dentre as 485 pessoas que habitam a região de análise, 366 apresentam renda, e alguém com uma renda de R$ 10.000,00 possui uma renda superior à 21.62% das demais pessoas da região. O z-score de -0.78 indica que esta renda está abaixo do valor de renda esperado para a região.

📍 Lourdes, BH (bairro nobre)

(lat, lng) <--> (-19.934418443389507, -43.942887201464195)

Renda comparada <--> R$ 10.000,00

Gênero <--> Masculino

Idade <--> 60

Responsável pelo domicílio? <--> Sim

Rua Rio de Janeiro, 2300 - Lourdes - Belo Horizonte, MG

{
  "qtde_pessoas": 24.0,
  "qtde_pessoas_sem_renda": 0.0,
  "renda_comparada_cdf": 0.14140972301399285,
  "renda_comparada_pdf": 0.0000013802452168620837,
  "renda_comparada_z_score": -2.9858195845015816,
  "renda_media_pessoas": 28760.04573593453,
  "renda_pessoas_com_renda_desvio_padrao": 9911.730593796548,
  "renda_pessoas_com_renda_maxima": 66957.29112554113,
  "renda_pessoas_com_renda_media": 28760.04573593453,
  "renda_pessoas_com_renda_mediana": 26377.136111532138,
  "renda_pessoas_com_renda_minima": 20629.07223797445,
  "renda_pessoas_com_renda_primeiro_quartil": 23662.89043252312,
  "renda_pessoas_com_renda_qtde": 24.0,
  "renda_pessoas_com_renda_terceiro_quartil": 29128.37015272398,
  "renda_total": 690241.0976624287,
  "renda_total_m2": 34.59089912510599
}

Adicionando alguns filtros para avaliar um perfil mais específico, isto é de homens com cerca de 60 anos e que são responsáveis pelos domicílios observa-se que:

📍 Venda Nova, BH (bairro classe média baixa)

(lat, lng) <--> (-19.817176762257493, -43.95872014010363)

Renda comparada <--> R$ 10.000,00

Gênero <--> Masculino

Idade <--> 60

Responsável pelo domicílio? <--> Sim

R. Irineu Pinto, 205 - Venda Nova, Belo Horizonte - MG

{
  "qtde_pessoas": 19.0,
  "qtde_pessoas_sem_renda": 0.0,
  "renda_comparada_cdf": 99.08922617796617,
  "renda_comparada_pdf": 0.0000037831617063243673,
  "renda_comparada_z_score": 2.3612086969235446,
  "renda_media_pessoas": 2665.475128467721,
  "renda_pessoas_com_renda_desvio_padrao": 1929.9002585172097,
  "renda_pessoas_com_renda_maxima": 7499.847248306218,
  "renda_pessoas_com_renda_media": 2665.475128467721,
  "renda_pessoas_com_renda_mediana": 2043.3624938113708,
  "renda_pessoas_com_renda_minima": 406.0215586608711,
  "renda_pessoas_com_renda_primeiro_quartil": 1145.144691489582,
  "renda_pessoas_com_renda_qtde": 19.0,
  "renda_pessoas_com_renda_terceiro_quartil": 3816.00660097579,
  "renda_total": 50644.0274408867,
  "renda_total_m2": 0.3957067369495203

}

Com os mesmos filtros aplicados em Lourdes, isto é, homens de aproximadamente 60 anos e que são responsáveis pelo domicílio porém no Bairro de Venda nova os numeros mudam significativamente. A distribuição de renda cai significativamente e ao se comparar a renda mensal de R$ 10.000,00 percebe-se que alguém neste perfil e com esta renda possui renda superior à 99% das pessoas e que o z-score agora é positivo, indicando uma renda superior à renda esperada.

💡 Renda Dinâmica (PDF)

O dado de renda dinâmica representa a renda pessoal mensal das pessoas que habitam o entorno de determinado ponto (ou endereço) que se deseja analisar. Tal renda é modelada por uma função de densidade de probablidade (em inglês, Probability Density Function). A renda é dita dinâmica pois podem ser aplicados filtros temporais para se avaliar a renda das pessoas que habitam a região do ponto em diferentes momentos. Além disso, é possível filtrar as pessoas da região por gênero, idade e entre aqueles que são os responsáveis pelo domicílio. Por fim, é possível, ainda, comparar determinada renda mensal com a renda mensal da região. A partir desta comparação é possível:

O dado é atualizado mensalmente, mas mudanças mais profundas ocorrem trimestralmente com as divulgações de cada edição da PNADc.

📥 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.
• data (opcional): Data em que se deseja analisar a renda. Aceita-se datas passadas a partir de Janeiro de 2022 e caso não seja informada, considera-se a data atual.
• renda comparada (opcional): Renda a ser comparada considerando o entorno do ponto. Útil para avaliar se determinada renda é acima ou abaixo com o perfil de renda da região.
• genero (opcional): Opcionalmente pode-se definir um genero para refinar as informções, isto é, indicar a renda de homens ou mulheres da região. Caso não seja informado considera-se a renda de ambos os gêneros.
• idade (opcional): Opcionalmente pode-se definir a idade aproximada das pessoas daregião para analisar a renda deste perfil. Caso não seja informada a idade, consideram-se pessoas de todas as idades para caracaterizar o perfil de renda da região.
• responsavel (opcional): Opcionalmente pode-se indicar se as pessoas da região serão ou não responsáveis pelos seus respectivos domicílios. Responsável pelo domicílio é aquele que é reconhecido como o líder da unidade doméstica pelos demais moradores.

📦 Atributos Retornados

• qtde_pessoas: estimativa da quantidade de pessoas que se encontram na vizinhança do ponto:
• qtde_pessoas_sem_renda: estimativa da quantidade de pessoas da região que não possuem uma renda mensal:
• renda_comparada_cdf: quando uma renda a ser comparada é informada, indica quantas pessoas (em termos percentuais) da região possuem uma renda inferior à renda pesquisada:
• renda_comparada_pdf: quando uma renda a ser comparada é informada, indica o quão provável é alguém possuir exatamente aquela renda na região
• renda_comparada_z_score: quando uma renda a ser comparada é informada, indica o desvio desta renda com a renda característica da região. Valores próximos à zero indicam uma proximdade das rendas e valores com magnitude elevada indicam valores díspares entre si. Valores de z-score positivos, indicam uma renda comparada acima da renda característica da região e valores negativos indicam valores abaixo da renda característica da região
• renda_media_pessoas: indica a renda média entre as pessoas da região considerando-se todas as pessoas, inlusive as pessoas sem renda, que tendem a reduzir esse valor:
• renda_pessoas_com_renda_desvio_padrao: desvio padrão da PDF da renda da região, indicando o quão diversa é a renda dos indivíduos na região. Valores menores indicam uma renda mais homogênea e valores maiores uma renda mais variada. Este valor é obtido considerando somente as pessoas que apresentam renda mensal na região
• renda_pessoas_com_renda_maxima:: estimativa do valor de renda máxima mensal estimada na região. Este valor é obtido considerando somente as pessoas que apresentam renda mensal na região
• renda_pessoas_com_renda_media:: estimativa do valor de renda média mensal estimada na região. Este valor é obtido considerando somente as pessoas que apresentam renda mensal na região
• renda_pessoas_com_renda_mediana:: estimativa do valor que divide as pessoas entre o 50% mais rico e o 50% mais pobre da região. Este valor é obtido considerando somente as pessoas que apresentam renda mensal na região
• renda_pessoas_com_renda_minima:: estimativa do valor de renda mínima mensal da região. Este valor é obtido considerando somente as pessoas que apresentam renda mensal na região
• renda_pessoas_com_renda_primeiro_quartil:: estimativa do valor de renda mensal que divide o 25% mais pobre e o 75% mais rico da região. Este valor é obtido considerando somente as pessoas que apresentam renda mensal na região
• renda_pessoas_com_renda_primeiro_quartil:: estimativa da quantidade de pessoas que apresentam renda mensal na região
• renda_pessoas_com_renda_terceiro_quartil:: estimativa do valor de renda mensal que divide o 75% mais pobre e o 25% mais rico da região. Este valor é obtido considerando somente as pessoas que apresentam renda mensal na região
• renda_total:: estimativa da renda nominal total, que representa a soma da renda mensal de todos os indivíduos da região.
• renda_total_m2:: estimativa da renda nominal total, que representa a soma da renda mensal de todos os indivíduos da região dividida pela área da região que se considera na modelagem. Valores maiores indicam não só uma região rica, mas também uma região verticalizada, isto é, com alta concentração espacial de renda.

🔁 Atualizações

Base atualizada mensalmente, com microdados mais recentes da PNAD Contínua, Censo IBGE e cadastros públicos municipais.

📚 Fontes

• IBGE - Censo 2022, inflação (IPCA) e PNAD
• Mapeamentos internos e algoritmos de inferência com ML

⚙️ Metodologia

Utilizamos regressão com base em características agregadas do setor censitário e de indivíduos amostrados. A modelagem incorpora variáveis geoespaciais, sociodemográficas e econômicas. Resultados são calibrados e validados com benchmarks públicos.

❗ Limitações

Os dados retornam médias e estimativas da renda pessoal das pessoas que habitam a vizinhança do ponto que se deseja analisar, não refletindo valores individuais. A precisão diminui em áreas muito pequenas ou com baixa densidade populacional. Além disso, há um decréscimo na precisão com a quantidade de filtros aplicados bem como pela restritividade deles. Um exemplo de filtro restritivo é um filtro de idade com valor de 100 anos, já que a amostra de pessoas próximas à essa faixa etária é pequena. Deve-se ressaltar que o filtro de idade não é exato, ou seja, não se avalia a renda das pessoas que possuem exatamente a idade desejada, mas sim de pessoas da região que possuem uma idade próxima à idade desejada.