O cenário de crescimento

Quem aprova um loteamento quer saber o que ele vai pedir da cidade. O cenário de crescimento responde com o que a plataforma já tem: o Censo 2022, as escolas do INEP e as unidades de saúde do CNES. Cada resposta traz um número, a faixa que a medição sustenta, a base de onde ele veio e uma frase pronta. Uma resposta que os dados não dão volta retida, com o motivo, e nunca é adivinhada.

O cálculo é gratuito e vale para uma cidade aberta no projeto, sob a mesma abertura do diagnóstico por setor. Ele não roda uma simulação e não lê nenhuma pessoa: é uma conta sobre as tabelas da cidade.

O que ele responde

Resposta	`id`	De onde vem
Moradores	`moradores`	Os domicílios do lote vezes os moradores por domicílio dos setores de referência (Censo 2022).
Crianças de 0 a 4, de 5 a 9 e de 10 a 14 anos	`criancas_0_4`, `criancas_5_9`, `criancas_10_14`	Os domicílios do lote vezes as crianças por domicílio dos setores de referência, meninos e meninas somados (Censo 2022).
A escola mais próxima de cada etapa	`escola_inf_cre`, `escola_inf_pre`, `escola_fund_ai`, `escola_fund_af`, `escola_med`	A distância em linha reta do centro do lote, com o código INEP, a rede e as matrículas da escola na etapa (Censo Escolar 2024).
A unidade de saúde mais próxima de cada grupo	`saude_atencao_basica`, `saude_pronto_atendimento`, `saude_hospital`	A distância em linha reta do centro do lote, com o código CNES. Os grupos são os do diagnóstico.
Água, esgoto e lixo	`agua_rede_geral`, `esgoto_rede`, `lixo_coletado`	A parte dos domicílios dos setores de referência com água da rede geral, esgoto na rede e lixo coletado (Censo 2022), só nos setores em que o IBGE publicou a variável inteira.
Declividade	`declividade`	A declividade média dos setores de referência. Com 30% ou mais, a Lei 6.766/1979 restringe o parcelamento.

Os setores de referência

O centro do lote: é o centro de área do polígono desenhado. Ele precisa cair num setor do município, e a resposta diz qual em setor_do_centro. Num pedido por setores, o centro é a média dos centros deles, e setor_do_centro vem nulo.
Os cinco setores de cada número: para cada número de pessoas, a conta usa os cinco setores urbanos do município mais perto do centro que têm ao menos 20 domicílios e o número publicado pelo IBGE. As pessoas deles somadas, divididas pelos domicílios deles somados, vezes os domicílios do lote, dão a estimativa.
Cada faixa de idade usa os seus: um setor em que o IBGE escondeu os meninos ou as meninas de uma faixa não entra naquela faixa. O base.setores de cada resposta lista os setores que ela usou. setores_de_referencia lista os dos moradores, que também servem ao saneamento e à declividade.
Zero: quando os cinco setores não têm crianças de uma faixa, a resposta é zero, sem faixa, e a frase diz que o lote pode ter algumas.

O erro medido

A medição deixou de fora, um a um, cada um dos 337.548 setores urbanos do Censo 2022 e estimou cada um pelos vizinhos, do mesmo jeito: os cinco setores mais próximos com ao menos 20 domicílios e o número publicado. Em 8 de cada 10 setores, os moradores ficaram entre 9% abaixo e 10% acima da estimativa, e as crianças de 0 a 4 anos, entre um terço abaixo e 43% acima. Por isso cada estimativa de pessoas traz a faixa (faixa), e é a faixa que se deve ler.

O que ele ainda não responde

As famílias jovens a mais que um loteamento novo costuma atrair: a estimativa sai de bairros já assentados.
Casa ou apartamento: as pessoas por domicílio são as dos vizinhos, seja qual for a moradia do lote.
Capacidade: vagas de escola, leitos e consultas. Nenhuma fonte aberta publica a capacidade de escolas e unidades de saúde.
Como os novos moradores vão agir: isso é uma simulação, não este cálculo.
O caminho pela rua: as distâncias são em linha reta.

Como pedir

No console: em Simular uma obra → Novo loteamento, marque os cantos do lote no mapa, feche o lote e diga quantos lotes ele tem, um domicílio por lote. O console manda o desenho ao servidor, que não o guarda, e mostra as frases por assunto.
- No mapa: os setores de referência aparecem em tracejado, e o setor do centro em traço mais grosso. A escola mais próxima de cada etapa (pontos) e a unidade de saúde mais próxima de cada grupo (anéis) ficam ligadas ao centro do lote. Com o relevo ligado, o mesmo aparece sobre o relevo.
- A declividade dentro do desenho é calculada no navegador, a partir do relevo, e vem separada da declividade dos setores de referência.
- Levar ao chat abre o chat com o pedido escrito.
No chat: o assistente monta o pedido com você: a cidade, os domicílios e o polígono que veio do console, ou os setores que você nomeia. Ele chama o cálculo e mostra as frases como o servidor as escreveu, sem calcular nenhum número.
Pelo MCP: estimate_growth, com municipio, unidades e poligono ou setores.
Pela API: POST /v1/diagnosticos/{codigo}/crescimento, com o escopo results:read. O corpo traz o polígono, como abaixo, ou "setores": ["260120105000005"] no lugar dele:

{
  "versao": 1,
  "municipio": "2601201",
  "unidades": 200,
  "poligono": [[-37.058, -8.420], [-37.056, -8.420], [-37.056, -8.418], [-37.058, -8.418]]
}

A resposta traz centro ([longitude, latitude]), setor_do_centro, setores_de_referencia e respostas, mais fontes, os créditos dos números, e aviso, o texto que a licença do Copernicus pede onde a declividade aparece. Uma resposta de escola, por exemplo:

{
  "id": "escola_inf_cre",
  "retido": false,
  "numero": 360,
  "unidade": "m",
  "escola": "26024691",
  "rede": "privada",
  "matriculas": 53,
  "frase": "A escola com creche mais próxima fica a 360 m em linha reta (INEP 26024691, privada, com 53 matrículas na etapa)."
}

Sem número: uma resposta retida vem com retido: true e o motivo, e a frase diz por quê.
Recusas: um pedido fora do contrato volta com 422 invalid_growth_request, o contract_code e o field (códigos). Uma cidade que o projeto não abriu volta com 403 diagnosis_not_open.

Fontes e créditos

IBGE, Censo Demográfico 2022: os domicílios, os moradores por domicílio, a idade e o sexo e o saneamento de cada setor censitário.
IBGE, Malha de Setores Censitários 2022: os contornos e os centros dos setores.
INEP, Catálogo de Escolas e Censo Escolar 2024: a coordenada declarada de cada escola, as etapas e as matrículas por etapa e rede.
Ministério da Saúde, CNES: a coordenada e o tipo de cada unidade de saúde.
Copernicus DEM GLO-30: a declividade dos setores, do perfil da cidade.