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.0.1

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.0.1
File Size Uploaded
geobr-2.0.1.tar.gz 60.3 kB Details

Built distribution (wheel)

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

Total release size: 111.9 kB

Release files / geobr-2.0.1.tar.gz

Download URL geobr-2.0.1.tar.gz
Size 60.3 kB
Tags Source
SHA-256 checksum
How to use checksums
6abac41ebd24d5e3f21ce83a5fb1f6f8a07b89d7a194b1f1b77f81a24fdfe41f
BLAKE2b-256 checksum
How to use checksums
f9a4166edbb0896733e9383ba47730371d6b9c25b6d4e898200283a0f152b351
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 16, 2026.

Transparency log

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

Download URL geobr-2.0.1-py3-none-any.whl
Size 51.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e49743c76d16d0057a4bebc3f789f1795d88e22400ca40eeb11e49b5ec4a32b4
BLAKE2b-256 checksum
How to use checksums
a3529fde90dd19c3a5e244b7547111f87643bb98774e9c81c2e2e629c0222a9d
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 16, 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