EMBRAPA Solos API

The embrapa_solos module provides soil profiles and the pedological map of Brazil via the EMBRAPA GeoInfo WFS.

Functions

perfis

PronaSolos soil profiles (tabular).

async def perfis(
    *,
    uf: str | None = None,
    bbox: tuple[float, float, float, float] | None = None,
    as_polars: bool = False,
    return_meta: bool = False,
) -> pd.DataFrame | tuple[pd.DataFrame, MetaInfo]

Parameters:

Parameter	Type	Description
uf	str \| None	Filter by state (abbreviation, e.g. "MT")
bbox	tuple \| None	Bounding box (lon_min, lat_min, lon_max, lat_max)
as_polars	bool	Return a polars DataFrame
return_meta	bool	Return a (DataFrame, MetaInfo) tuple

Returns: DataFrame with columns: fid, uf, municipio, latitude, longitude, horizonte, profundidade, areia_total, silte, argila, ph_h2o, carbono_organico, ctc, saturacao_bases, aluminio, fosforo, classe_textural, nivel_levantamento, uso_atual

Example:

from agrobr import embrapa_solos

# All profiles
df = await embrapa_solos.perfis()

# Mato Grosso profiles
df = await embrapa_solos.perfis(uf="MT")

---

perfis_geo

Soil profiles with geometry (GeoDataFrame). Requires pip install agrobr[geo].

async def perfis_geo(
    *,
    uf: str | None = None,
    bbox: tuple[float, float, float, float] | None = None,
    return_meta: bool = False,
) -> gpd.GeoDataFrame | tuple[gpd.GeoDataFrame, MetaInfo]

Parameters:

Parameter	Type	Description
uf	str \| None	Filter by state (abbreviation)
bbox	tuple \| None	Bounding box (lon_min, lat_min, lon_max, lat_max)
return_meta	bool	Return a (GeoDataFrame, MetaInfo) tuple

Returns: GeoDataFrame (Point, EPSG:4326) with the same columns as perfis() + geometry

Example:

from agrobr import embrapa_solos

# Profiles with geometry in a bbox
gdf = await embrapa_solos.perfis_geo(bbox=(-56, -16, -54, -14))

---

mapa_solos

Pedological map of Brazil — SiBCS classification (tabular).

async def mapa_solos(
    *,
    ordem: str | None = None,
    bbox: tuple[float, float, float, float] | None = None,
    as_polars: bool = False,
    return_meta: bool = False,
) -> pd.DataFrame | tuple[pd.DataFrame, MetaInfo]

Parameters:

Parameter	Type	Description
ordem	str \| None	Filter by soil order (contains, case-insensitive). E.g. "LATOSSOLO"
bbox	tuple \| None	Bounding box (lon_min, lat_min, lon_max, lat_max)
as_polars	bool	Return a polars DataFrame
return_meta	bool	Return a (DataFrame, MetaInfo) tuple

Returns: DataFrame with columns: fid, simbolos, comp1, comp2, comp3, legenda, area_km2, ordem1, subordem1, gdegrupo1, ordem2, subordem2, gdegrupo2, legenda_sinotica, classe_dom

Example:

from agrobr import embrapa_solos

# Full map
df = await embrapa_solos.mapa_solos()

# Latosols
df = await embrapa_solos.mapa_solos(ordem="LATOSSOLO")

---

mapa_solos_geo

Pedological map with geometry (GeoDataFrame). Requires pip install agrobr[geo].

async def mapa_solos_geo(
    *,
    ordem: str | None = None,
    bbox: tuple[float, float, float, float] | None = None,
    return_meta: bool = False,
) -> gpd.GeoDataFrame | tuple[gpd.GeoDataFrame, MetaInfo]

Parameters:

Parameter	Type	Description
ordem	str \| None	Filter by soil order (contains, case-insensitive)
bbox	tuple \| None	Bounding box (lon_min, lat_min, lon_max, lat_max)
return_meta	bool	Return a (GeoDataFrame, MetaInfo) tuple

Returns: GeoDataFrame (MultiPolygon, EPSG:4326) with the same columns as mapa_solos() + geometry

Example:

from agrobr import embrapa_solos

# Soil polygons in a bbox
gdf = await embrapa_solos.mapa_solos_geo(bbox=(-56, -16, -54, -14))

Synchronous Version

from agrobr.sync import embrapa_solos

df = embrapa_solos.perfis(uf="MT")
df = embrapa_solos.mapa_solos()

Notes

• Source: EMBRAPA GeoInfo — license nc (CC BY-NC 3.0 BR)
• The _geo() functions require pip install agrobr[geo] (geopandas)
• ~34K soil profiles (PronaSolos 2020), ~2.8K pedological polygons
• Automatic WFS pagination
• BBOX query CRS: EPSG:4674 (SIRGAS 2000); returned GeoDataFrame in EPSG:4326