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.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.1.1
File Size Uploaded
geobr-2.1.1.tar.gz 66.0 kB Details

Built distribution (wheel)

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

Total release size: 119.0 kB

Release files / geobr-2.1.1.tar.gz

Download URL geobr-2.1.1.tar.gz
Size 66.0 kB
Tags Source
SHA-256 checksum
How to use checksums
00b0ec94f68998533cdbd45f0f7e59f59cc42e1c14e9b8e9743a6f09e2a7e529
BLAKE2b-256 checksum
How to use checksums
c5bf250f578ef7ca65575ba816798ae42b391cac757486b1ecb714be1e9907ac
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 23, 2026.

Transparency log

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

Download URL geobr-2.1.1-py3-none-any.whl
Size 53.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0eb1072c61ed85efbd5e05911e02bb83fb5035c4c25f452085051eef1423fa02
BLAKE2b-256 checksum
How to use checksums
8503981d6989c3ab5655f2ebbed90edfacecbfeab7c77b4c66bebb2191020f1b
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 23, 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