geomoz 0.1.0

Geospatial data library for Mozambique with geological and administrative datasets

GeoMoz - Dados Geográficos de Moçambique

GeoMoz é um pacote Python que fornece acesso fácil a dados geográficos de Moçambique, incluindo divisões administrativas (11 províncias, 161 distritos, 459 postos, 11.524 aldeias) e dados geológicos completos.

Inspirado no geobr (Brasil).

---

🚀 Instalação

pip install geomoz

Com dependências completas:

pip install geomoz geopandas matplotlib folium

---

⚡ Uso Rápido

import geomoz
from geomoz import quick_map

# Carregar províncias
provinces = geomoz.read_province()
print(f"✅ {len(provinces)} províncias carregadas")

# Mapa rápido
quick_map(provinces, column='Provincia')

# Hierarquia completa
districts = geomoz.read_district()
posts = geomoz.read_admin_post()
villages = geomoz.read_village()  # Usar cache para aldeias!

---

📊 Dados Disponíveis

Dataset	Registros	Função
Províncias	11	read_province()
Distritos	161	read_district()
Postos Administrativos	459	read_admin_post()
Aldeias	11.524	read_village() / CachedGeoMoz.read_village()
Geologia	~50.000	read_geology()

---

🎨 Exemplos

Mapa de Províncias

from geomoz import plot_provinces
plot_provinces(show_names=True, save_path='mapa.png')

Geologia por Província

import geopandas as gpd
from geomoz import read_province, read_geology

province = read_province(name_province="Tete")
geology = read_geology()
geo_tete = gpd.overlay(geology, province, how='intersection')
print(f"Unidades geológicas em Tete: {len(geo_tete)}")

Mapa Web Interativo

import folium
from geomoz import read_province

province = read_province(name_province="Nampula")
m = folium.Map(location=[-14.5, 39], zoom_start=7)
folium.GeoJson(province).add_to(m)
m.save('mapa.html')

---

📚 Documentação

• 📖 README Completo - Documentação detalhada
• 🎓 Tutorial Educativo - Guia passo a passo
• 📋 Referência Rápida - Cheat sheet
• 💻 Exemplos - Códigos de exemplo

---

🛠️ Desenvolvimento

git clone https://github.com/geolithica/geomoz.git
cd geomoz
pip install -e ".[dev]"
pytest

---

📄 Licença

MIT License - veja LICENSE

---

GeoMoz - Dados geográficos de Moçambique ao alcance de todos! 🗺️🇲🇿