Aplicações
A Renda Dinâmica vai além da faixa e percentil da Renda Estática: entrega a distribuição estatística completa da renda do entorno, com filtros demográficos e comparação direta de valores. É a ferramenta adequada quando se precisa responder "esta renda específica é compatível com o perfil desta região?"
Verificação de Renda Declarada
Compare a renda informada pelo solicitante com a distribuição de renda da região. Um z-score muito negativo ou CDF muito baixo sinaliza incompatibilidade que merece investigação.
Análise de Crédito por Perfil
Filtre por gênero, idade e responsável pelo domicílio para avaliar a renda esperada de um perfil específico na região — não apenas a média geral.
Feature Engineering Avançado
Use z-score, CDF, desvio padrão e quartis como features em modelos preditivos. A riqueza estatística permite capturar heterogeneidade que uma simples faixa de SM não expressa.
Análise Temporal
Consulte a distribuição de renda em diferentes datas (a partir de janeiro de 2022) para observar evolução do perfil socioeconômico ou validar renda em período retroativo.
Conceito
O dado modela a renda pessoal mensal do entorno como uma função de densidade de probabilidade (Probability Density Function). Diferente da Renda Estática (que retorna faixa e percentil pré-calculados), a Renda Dinâmica permite aplicar filtros demográficos e comparar diretamente um valor de renda contra a distribuição da região.
Distribuição Completa
A renda é modelada como uma distribuição contínua. O retorno inclui média, mediana, quartis, desvio padrão, mínima e máxima — permitindo entender a dispersão e a forma da distribuição, não apenas um ponto central.
Segmentação por Perfil
Gênero, idade aproximada e condição de responsável pelo domicílio refinam a amostra. Útil para comparar a renda de um indivíduo específico com pessoas de perfil semelhante na mesma região.
Posição na Distribuição
Ao informar um valor de renda, o retorno inclui o CDF (% de pessoas com renda inferior), o z-score (desvio em relação à média) e a PDF (probabilidade pontual). Responde diretamente: "esta renda é compatível com a região?"
Como interpretar o z-score
O z-score indica quantos desvios-padrão a renda comparada está acima ou abaixo da renda média da região (considerando apenas pessoas com renda):
z ≈ 0 Renda compatível com o perfil da região.
z < −1 Renda significativamente abaixo do esperado para a região.
z > +1 Renda significativamente acima do esperado para a região.
z < −2 ou z > +2 Renda atípica — divergência relevante que pode indicar incompatibilidade cadastral.
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.
Parâmetros opcionais
renda_comparada floatrenda_comparada_cdf, renda_comparada_pdf e renda_comparada_z_score.genero string"masculino" ou "feminino". Se omitido, considera ambos os gêneros.idade intresponsavel booltrue) ou não-responsáveis (false). Responsável é quem é reconhecido como líder da unidade doméstica pelos demais moradores.data dateYYYY-MM-DD). Aceita datas a partir de janeiro de 2022. Se omitida, utiliza a data atual.Exemplos
Três cenários em Belo Horizonte mostram como filtros e localização mudam completamente a interpretação de uma mesma renda de R$ 10.000.
{
"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
}
Das 485 pessoas estimadas na vizinhança, 366 possuem renda. A renda média (com renda) é de R$ 17.668 e a mediana de R$ 21.003. Uma renda de R$ 10.000 é superior à de apenas 21,6% das pessoas da região (CDF), com z-score de −0.78 — abaixo do esperado para o Bairro de Lourdes, mas não atípica.
{
"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
}
Com o filtro de homens de ~60 anos responsáveis pelo domicílio, a amostra cai para 24 pessoas — todas com renda. A renda média sobe para R$ 28.760 e a mínima estimada é R$ 20.629. Agora, R$ 10.000 é superior à de apenas 0,14% das pessoas deste perfil, com z-score de −2.99 — uma renda muito atípica para o perfil na região. Sinal relevante para verificação cadastral.
{
"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
}
Mesmo perfil (homem, ~60 anos, responsável), mas em Venda Nova. A renda média cai para R$ 2.665 e a máxima estimada é R$ 7.500. Agora, os mesmos R$ 10.000 superam 99% das pessoas do perfil na região, com z-score de +2.36 — renda muito acima do esperado. O contraste com Lourdes (z-score −2.99 vs +2.36 para a mesma renda) demonstra o poder dos filtros combinados com localização.
Atributos Retornados
O retorno é organizado em quatro grupos: população (contagem de pessoas), distribuição da renda (estatísticas descritivas), comparação (quando renda_comparada é informada) e agregados territoriais.
Detalhes Técnicos
Fontes
- IBGE — Censo Demográfico 2022
- IBGE — PNAD Contínua (microdados trimestrais)
- IBGE — IPCA (atualização de valores nominais)
- Algoritmos de inferência com Machine Learning (PrismaData)
Cobertura
Todo o território nacional. A precisão é maior em áreas urbanas com alta densidade populacional. Filtros muito restritivos (ex: idade = 100 anos) reduzem a amostra e consequentemente a confiabilidade.
Atualização
- Mensal: recalibração com IPCA e salário mínimo vigente
- Trimestral: incorporação de microdados da PNAD Contínua
- Série histórica: consultas retroativas a partir de jan/2022
Metodologia
Regressão com base em características agregadas do setor censitário e de indivíduos amostrados. Variáveis geoespaciais, sociodemográficas e econômicas. Distribuição modelada como PDF contínua, calibrada e validada com benchmarks públicos.
Limitações
Considere ao utilizar
- Os valores são estimativas baseadas em modelagem estatística — não refletem a renda individual de nenhum morador específico. Devem ser utilizados como sinal complementar.
- A precisão diminui com a quantidade e a restritividade dos filtros aplicados. Filtros muito estreitos (ex: idade = 100 anos) geram amostras pequenas com menor confiabilidade.
- O filtro de idade não é exato: seleciona pessoas em faixa etária próxima à informada, não exatamente com a idade solicitada.
- A precisão diminui em áreas de baixa densidade populacional ou com grande heterogeneidade socioeconômica intra-setor.
- Os campos
renda_comparada_*só são retornados quando o parâmetrorenda_comparadaé informado na request. - Consultas retroativas (parâmetro
data) anteriores a janeiro de 2022 não são suportadas.
Pronto para testar?
Solicite acesso à sandbox da API de Renda Dinâmica e compare rendas contra o perfil real de qualquer região do Brasil.
Solicitar acesso