Skip to main content

geobr: Download Official Spatial Data Sets of Brazil

logo logo

geobr is a computational package to download official spatial data sets of Brazil. The package includes a wide range of geospatial data in geopackage format (like shapefiles but better), available at various geographic scales and for various years with harmonized attributes, projection and topology (see detailed list of available data sets below).

READ FULL DOCS

Contribute

To start the development environment run

uv sync

Test with

uv run pytest -n auto

You can use a helper to translate a function from R. If you want to add read_biomes, just run

uv run python helpers/translate_from_R.py read_biomes

It will scrape the original R function to get documentation and metadata. It adds:

  • default year
  • function name
  • documentation one liner
  • larger documentation
  • very basic tests

Be aware that if the function that you are adding is more complicated than the template. So, always double check.

Release new version

  1. Update version in pyproject.toml and the CHANGELOG.md.
  2. Commit and push to master.
  3. Tag the release (the python-v prefix avoids conflicts with R package tags):
git tag python-v1.0.0
git push origin python-v1.0.0
  1. The Python-publish-PyPI workflow will automatically build, test, and upload to PyPI.

Release files for geobr 2.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for geobr 2.1.0
File Size Uploaded
geobr-2.1.0.tar.gz 64.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for geobr 2.1.0
File Interpreter ABI Platform
geobr-2.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 117.4 kB

Release files / geobr-2.1.0.tar.gz

Download URL geobr-2.1.0.tar.gz
Size 64.4 kB
Tags Source
SHA-256 checksum
How to use checksums
5be583bd4e97034e90a65957245f1d007e9c7ff79cb03dbc079ba0744d4ac971
BLAKE2b-256 checksum
How to use checksums
8113067c44c9b3ed60bbc4b0401a1498dfb16fc59816e6d16c94718922f72814
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 18, 2026.

Transparency log

Release files / geobr-2.1.0-py3-none-any.whl

Download URL geobr-2.1.0-py3-none-any.whl
Size 53.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3be79f098adcf832329e57f0eeb1452214aad94c8fab65bd71fb9be5e4b365a5
BLAKE2b-256 checksum
How to use checksums
c56aad98aad8ed08a9aa2d3df6068e1cb00a11c7dbdfd5aa2bf2b37bc1ddf3ce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 18, 2026.

Transparency log
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page