Client Python para a API Nominatim (FMConsult Geocode)

Instalação

pip install nominatim-python-sdk

Configuração

Defina as variáveis de ambiente antes de usar:

• nominatim.api.app.name
• nominatim.api.app.version
• nominatim.api.email.address

Base URL: https://api-geocode.fmconsult.com.br

Endpoints suportados

Lookup (até 50 OSM IDs)

from nominatim.apis.lookup_address import LookupAddress
from nominatim.dtos.geocoder import LookupFilter

client = LookupAddress()
results = client.lookup(LookupFilter(
    osm_ids=["R1852505", "W1068591929"],
    format="json",
    polygon_geojson=1,
))

CI/CD

• CI (.github/workflows/ci.yml): roda testes em push/PR para main
• CD (.github/workflows/publish.yml): publica no PyPI ao criar tag v*