Open Geodata¶

O Open Geodata tem como objetivo facilitar o acesso à dados espaciais de instituições públicas e privadas do Brasil. Algumas das instituições são apresentadas abaixo:

Dependências¶

O projeto tem como dependêcias pacotes para obtenção de diferentes tipos de dados, bem como define funções e classes para obtenção de dados específicos.

As principais dependências utilizadas pelo Open Geodata para obter dados espaciais são:

Pooch, trata-se de um biblioteca python, opensource, do projeto chamado Fatiando a Terra. Tomei conhecimento ao vê-lo como dependência da biblioteca geopandas/geodatasets.
OWSlib é uma biblioteca python, de opensource, que fornece uma interface comum para interagir com diversos serviços web geoespaciais baseados em padrões OGC (Open Geospatial Consortium), tais como: WMS, WFS, WCS, WMTS, CSW entre outros.
Bolton & Menk GIS/restapi, biblioteca opensource projetada para funcionar com os serviços REST do ArcGIS Server, para consultar e extrair dados, além de visualizar propriedades de serviço.
ArcGIS API for Python, biblioteca proprietária (da ESRI), disponibilizada no PyPI, utilizada para consumir dados do ArcGIS Server.

Ainda, a documentação é parte fundamental da biblioteca Open Geodata, onde são apresentados exemplos e maneiras de usar a biblioteca, bem como as dezenas de fontes abertas na internet.

Inspiração: do projeto à biblioteca!

Existe muita coisa disponível na internet: pra que querer guardar tudo no seu PC!?

Sempre colecionei dados espaciais e, inclusive, estudava como implantar o meu próprio GeoServer. Fui vivenciando os problemas de ter dados espaciais armazenados: ocupam muito espaço e rapidamente ficam desatualizados.

Passei a estudar maneiras de mante-los atualizados e, com isso, conheci as potencialidades do python. Mantinha os dados e rotinas de atualização, algumas delas disponíveis no Projeto Open Geodata. Passado algum tempo observei que a minha real necessidade era ter apenas a rotina de atualização, obtendo o dado mais atualizado, para o uso pontual (sem consistir o dado no meu HD / sem armazena-lo): iniciei o desenvolvimento da Biblioteca Open Geodata.

... uma longa trajetória, iniciada muito tempo atrás, quando se comprava "cartas do Instituto Geográfico e Cartográfico" na papelaria da faculdade, com pen drive: good ol' days!

Como Contribuir?¶

Alguma dúvida, sugestão e/ou contribuição, favor reportar um problema/issue ou abrir um tópico de discussão.

É possível também criar um pull request para contrubuir diretamente com o desenvolvimento da biblioteca.

Como Instalar?¶

O pacote está disponível no repositório oficial do python: PyPI.

Idealmente usar o uv, pois resolverá a dependÊncia do SICAR.

# Instala usando pip
pip3 install open-geodata --upgrade

# Instala usando uv
uv add open-geodata

# Instala usando uv
poetry add open-geodata

Diagrama¶

flowchart LR
    A .-> B
    B  .-> C
    A --Não Armazena --> C

    B@{ shape: cyl}
    A(["Obter"])
    B["Armazenar"]
    C["Usar"]

---
config:
    theme: mc
    look: handDrawn
    layout: dagre
---
flowchart LR
    A .-> B
    B  .-> C
    A --Não Armazena --> C

    B@{ shape: cyl}
    A(["Obter"])
    B["Armazenar"]
    C["Usar"]