Metadata-Version: 2.3
Name: ibge-geodata
Version: 1.0.0
Summary: Python package to use spatial data of Brazilian territorial levels available at IBGE
License: GPL
Author: Victor Benezoli
Author-email: victorbenezoli@gmail.com
Requires-Python: >=3.11
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: geopandas (>=1.0.1,<2.0.0)
Requires-Dist: matplotlib (>=3.10.3,<4.0.0)
Requires-Dist: numpy (>=2.2.3,<3.0.0)
Requires-Dist: pytest (>=8.3.4,<9.0.0)
Requires-Dist: requests (>=2.32.3,<3.0.0)
Requires-Dist: rich (>=14.0.0,<15.0.0)
Project-URL: Homepage, https://github.com/victorbenezoli/geodata
Project-URL: Repository, https://github.com/victorbenezoli/geodata
Description-Content-Type: text/markdown

# geodata
`geodata` is a Python package designed to simplify the process of working with geographical data from the IBGE (Brazilian Geography and Statistic Institute) API.

# Features
- Loads vector data of Brazil's geographical divisions without the need to download files;
- Allows intuitive selection of the geographical division level and data resolution;
- Export the vector data to the desired format without the need for third-party software.

# Usage
```python
import geodata as gd

# Initialize the geodata object
geolevel = gd.GeoLevel.STATE
quality = gd.Quality.MEDIUM
geo = gd.GeoData(geolevel=level, quality=quality)

# Load the polygons data to a variable
data_pol = geo.polygons

# Load only metadata
data_meta = geo.metadata
```
