Servizi OSM — Italia

API pubbliche in sola lettura con i dati OpenStreetMap del solo territorio italiano: un'istanza Nominatim per la geocodifica e un server OSM API v0.6 per l'accesso ai dati grezzi.

Servizi

Servizio	Base URL	Descrizione
Geocodifica	`https://osm.unfoxo.it/nominatim/`	Nominatim standard: ricerca, reverse, lookup. Copertura Italia.
Dati OSM	`https://osm.unfoxo.it/api/0.6/`	OSM API v0.6 read-only

Funzionamento

Questo server fornisce un istanza Nominatim 100% stock, con ranking wikidata e le special phrases implementate, in modo da fornire risultati più accurati.

In aggiunta, è disponibile anche una API compatibile con la OSM API v0.6, ma che implementa i soli comandi di lettura, ma non implementa meta e history.

I dati sono aggiornati tramite i minutely updates, di conseguenza l'API restituisce dati sempre aggiornati all'ultimo snapshot OSM.

Regole

Il server è limitato a una sola richiesta per secondo su qualsiasi endpoint. È possibie ottenere un accesso meno limitato richiedendo una API Key dedicata.

È obbligatorio per l'utilizzo delle API:

Specificare un User-Agent che indichi nome dell'app e un sito web di contatto, o impostare un valore valido come Referer:
Rispettare l'error code HTTP 429 effettuando retry con un periodo di tempo ragionevole.
Il non utilizzo per fini commerciali, o per l'estrazione di massa dei dati.

Inoltre, ogni dato viene restituito con la relativa attribuzione. È importante mostrare nel servizio che fa uso dei dati l'origine, secondo le regole per l'attribuzione.

Limiti e differenze rispetto alle api standard

Copertura solo Italia: gli unici elementi che si estendono oltre il confine sono quelli che hanno almeno un nodo nel territorio (strade, edifici)
Lo schema contiene solo i dati correnti: non è possibile richiedere dati storici. Ogni elemento è version=1
Gli attributi user, uid e changeset non esistono e sono omessi; il timestamp per elemento è omesso.
Gli elementi cancellati restituiscono 404 e non sono visualizzabili.
I nodi senza tag esistono solo se appartengono a una way quindi alcune way "complete" possono referenziare id di nodi mancanti.
Le coordinate sono esatte a 7 decimali.
Server read-only: nessun endpoint di scrittura, changeset, note, GPX o block.
Le richieste non-GET ricevono 405.