Metadata-Version: 2.4
Name: nominatim-python-sdk
Version: 1.0.3
Summary: Client de comunicaçao c/ API da Nominatim
Author-email: Filipe Coelho <filipe@fmconsult.com.br>
License: MIT License
        
        Copyright (c) 2025 Seu Nome
        
        Permission is hereby granted, free of charge, to any person obtaining a copy...
        
Project-URL: Homepage, https://github.com/FMConsult/nominatim-python-sdk
Project-URL: Bug Tracker, https://github.com/FMConsult/nominatim-python-sdk/issues
Keywords: sdk,api,nominatim,fmconsult
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Dynamic: license-file

# Client Python para a API Nominatim (FMConsult Geocode)

## Instalação

```bash
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

| Classe | Método | Endpoint |
|--------|--------|----------|
| `SearchAddress` | `search` | `/search` |
| `ReverseGeocoding` | `reverse` | `/reverse` |
| `LookupAddress` | `lookup` | `/lookup` |

### Lookup (até 50 OSM IDs)

```python
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*`
