Compatibilità: Google e Nominatim
Cambi l’URL di base e mantenga il suo codice client. Questa pagina elenca ciò che è supportato, secondo la specifica dell’API (OpenAPI 1.0.0).
Modalità Google Geocoding
| Elemento | Supporto |
|---|---|
| Percorso | /compat/google/maps/api/geocode/json |
| Geocodifica diretta | `address` (fino a 512 caratteri) |
| Geocodifica inversa | `latlng`, nella forma `lat,lng` |
| Filtri | `components`: viene considerato solo `country:XX`; `language` e `region` accettati |
| Campi della risposta | status, error_message, results[].formatted_address, place_id, types, partial_match, address_components, geometry.location, geometry.location_type, geometry.viewport |
| Errori | `status` nel formato Google (OK, ZERO_RESULTS, OVER_QUERY_LIMIT, REQUEST_DENIED, INVALID_REQUEST, UNKNOWN_ERROR), HTTP 200 |
| Place ID | Presenti nella forma; i valori sono identificatori di Addrova |
| Estensione di Addrova | Elenco `attribution` di fonti e licenze |
Modalità Nominatim
| Elemento | Supporto |
|---|---|
| Ricerca | /compat/nominatim/search con `q`, `format` (json o jsonv2, predefinito jsonv2), `limit` (da 1 a 40, predefinito 10), `countrycodes` (codici ISO separati da virgole), `addressdetails` (0 o 1, predefinito 0) |
| Inversa | /compat/nominatim/reverse con `lat`, `lon`, `format`, `addressdetails` (predefinito 1) |
| Campi della risposta | place_id, licence, lat, lon, display_name, category (jsonv2) o class (json), type, importance, address, boundingbox |
| Inversa senza risultato | {"error": "Unable to geocode"} |
| Fuori ambito | Tessere cartografiche, ricerca di oggetti OSM |
Autenticazione sulle rotte di compatibilità
| Metodo | Come |
|---|---|
| Parametro di query | `key=ADDROVA_KEY`, accettato solo sulle rotte /compat, per compatibilità. Non viene mai registrato. |
| Intestazione | `X-API-Key`, oppure la chiave come token bearer |