estimativa_safra v1.0¶
Estimativas de safra corrente por UF.
Fontes¶
| Prioridade | Fonte | Descrição |
|---|---|---|
| 1 | CONAB | Acompanhamento de Safra |
| 2 | IBGE LSPA | Levantamento Sistemático da Produção Agrícola |
Produtos¶
soja, milho, arroz, feijao, trigo, algodao
Schema¶
| Coluna | Tipo | Nullable | Descrição |
|---|---|---|---|
safra |
str | ❌ | Safra no formato "2024/25" |
produto |
str | ❌ | Nome do produto |
uf |
str | ✅ | Unidade Federativa |
area_plantada |
float64 | ✅ | Área plantada (mil ha) |
producao |
float64 | ✅ | Produção (mil ton) |
produtividade |
float64 | ✅ | Produtividade (kg/ha) |
levantamento |
int | ✅ | Número do levantamento |
fonte |
str | ❌ | Origem dos dados |
Garantias¶
- Estimativas atualizadas mensalmente
- Latência típica: M+0 (dados do mês corrente)
Exemplo¶
from agrobr import datasets
# Safra corrente
df = await datasets.estimativa_safra("soja")
# Safra específica
df = await datasets.estimativa_safra("soja", safra="2024/25")
# Filtrar por UF
df = await datasets.estimativa_safra("milho", uf="MT")
# Com metadados
df, meta = await datasets.estimativa_safra("soja", return_meta=True)
Schema JSON¶
Disponível em agrobr/schemas/estimativa_safra.json.
from agrobr.contracts import get_contract
contract = get_contract("estimativa_safra")
print(contract.primary_key) # ['safra', 'produto', 'uf', 'levantamento']
print(contract.to_json())
Formato de Safra¶
O formato de safra segue o padrão brasileiro: AAAA/AA
2024/25= safra que começa em 2024 e termina em 2025- Safra de verão: plantio set-dez, colheita jan-mai
- Safra de inverno: plantio fev-abr, colheita jun-set