Contract: zoneamento_agricola¶
Agricultural Climate Risk Zoning — sowing windows by municipality/crop/soil (ZARC/MAPA).
Schema¶
| Column | Type | Nullable | Constraints |
|---|---|---|---|
cultura |
STRING | No | normalized pt-br name |
safra |
STRING | No | "YYYY/YYYY" or "perene" |
geocodigo |
STRING | No | IBGE 7-digit |
uf |
STRING | No | 2-letter abbreviation |
municipio |
STRING | Yes | — |
solo_codigo |
INTEGER | No | soil type code |
ciclo_codigo |
INTEGER | No | cultivar cycle code |
clima |
STRING | Yes | — |
manejo |
STRING | Yes | — |
portaria |
STRING | Yes | — |
dec1..dec36 |
INTEGER | Yes | risk per 10-day period (0-5) |
PK: (cultura, safra, geocodigo, solo_codigo, ciclo_codigo)
The 36 columns dec1..dec36 represent the 36 ten-day periods of the year. Values from 0 (no risk) to 5 (maximum risk).
Example¶
from agrobr import datasets
# Soybean zoning in MT
df = await datasets.zoneamento_agricola(cultura="SOJA", uf="MT")
# With filters
df = await datasets.zoneamento_agricola(
cultura="SOJA", uf="MT", solo=2, ciclo=1, safra="2024/2025"
)
# No filters (returns everything available)
df = await datasets.zoneamento_agricola()
# Available crops (via the source API directly)
from agrobr import zarc
culturas = zarc.culturas()