OpenStreetMap/Tiles OSMit

Servizio di tile raster in lingua italiana basate su OSM, esplorabili su https://tile.osmit.it .

Politica di utilizzo delle tile

I dati di OpenStreetMap (OSM) sono liberi per chiunque. I nostri server tile non lo sono: sono finanziati tramite donazioni, e la capacità è limitata. Per proteggere il servizio a beneficio dei mappatori e della comunità in generale, devi seguire questa politica quando utilizzi le tile da tile.osmit.it.

Accogliamo usi creativi e non richiediamo l'uso di un'API specifica. Tuttavia, un uso eccessivo o inappropriato danneggia la possibilità degli altri di modificare e visualizzare la mappa. Potremmo bloccare l'accesso, senza preavviso, se il tuo utilizzo degrada il servizio. Cercheremo di contattarti se possibile, ma non possiamo garantirlo.

La disponibilità è best-effort: non esiste alcun SLA o garanzia.

Se non puoi soddisfare questi requisiti, puoi utilizzare un servizio alternativo basato su OSM (vedi sotto) oppure gestirne uno tuo.

Riepilogo rapido

Devi:

• Utilizzare l'URL corretto:
  • OSM-Carto in italiano (copertura globale): https://tile.osmit.it/tiles/carto/{z}/{x}/{y}.png
  • Stile escursionistico (copertura europea): https://tile.osmit.it/tiles/hiking/{z}/{x}/{y}.png
• Fornire un'attribuzione della licenza visibile, seguendo le Linee guida sull'attribuzione di OpenStreetMap.
• Inviare un User-Agent HTTP valido che identifichi chiaramente la tua applicazione (o un ID app nella piattaforma tramite X-Requested-With dove impostato automaticamente).
• Dalle pagine web, assicurarsi che venga inviato un header HTTP Referer valido.
• Effettuare il caching delle tile localmente secondo gli header di caching HTTP (o almeno 7 giorni se la tua cache non è in grado di leggerli).
• Evitare di incoraggiare o facilitare la violazione del copyright.

Non devi:

• Scaricare massivamente ("scraping") le tile o offrire funzionalità di prefetch.
• Inviare header Cache-Control: no-cache, Pragma: no-cache o simili header no-cache per impostazione predefinita.
• Impostare una Referrer-Policy restrittiva che impedisca l'invio dell'header HTTP Referer.
• Utilizzare un URL HTTP http://tile.osmit.it/...; usa gli URL HTTPS indicati sopra.
• Mascherarsi con lo User-Agent di un'altra applicazione o affidarsi allo User-Agent predefinito di una libreria.

Dovresti (raccomandato):

• Evitare di codificare l'URL delle tile in modo fisso; consentire il cambio senza necessità di aggiornamento del software.
• Aggiungere un link "Segnala un problema sulla mappa" a https://www.openstreetmap.org/fixthemap.
• Pubblicare un'email di contatto sul tuo sito web o sulla scheda dell'app store.
• Supportare HTTP/2 o HTTP/3 per download multiplexati efficienti.

1. URL corretto delle tile

Utilizza esattamente:

• OSM-Carto in italiano (copertura globale): https://tile.osmit.it/tiles/carto/{z}/{x}/{y}.png
• Stile escursionistico (copertura europea): https://tile.osmit.it/tiles/hiking/{z}/{x}/{y}.png

Altri sottodomini o nomi host potrebbero essere più lenti o ritirati senza preavviso. Non possiamo fornire supporto all'integrazione per librerie specifiche per mappe; consulta la documentazione della tua libreria.

2. Attribuzione e licenza

• Mostra l'attribuzione della licenza OpenStreetMap in modo chiaro sulla mappa (tipicamente in basso a destra).
  Tipicamente: © OpenStreetMap contributors
  Vedi: Linee guida sull'attribuzione
• Non incoraggiare attivamente o passivamente la violazione del copyright.
• Non nascondere l'attribuzione sotto l'interfaccia utente, dietro toggle o fuori schermo.

3. Requisiti tecnici

3.1 Identificazione

• User-Agent: Invia una stringa User-Agent chiara e univoca che indichi il nome della tua app e opzionalmente includa un URL di contatto o un'email.
  Esempio (corretto):
  User-Agent: MyTownMaps/1.4 (+https://example.org; contact: maps@example.org)
  I browser utilizzeranno il proprio User-Agent predefinito.
• Non utilizzare lo User-Agent predefinito di una libreria, e non impersonare mai un'altra app o un browser.
• Se la tua piattaforma imposta automaticamente un header X-Requested-With con un ID app, questo è accettabile, ma un User-Agent appropriato è comunque raccomandato.
• Referer (solo web): Ci si aspetta che i browser inviino un header Referer valido. Le app native di solito non hanno un referer, e va bene così.
• Referrer-Policy (solo web): Non impostare una Referrer-Policy restrittiva che impedisca l'invio dell'header Referer nelle richieste verso tile.osmit.it .

3.2 Caching

• Non aggirare le cache. Non inviare mai Cache-Control: no-cache, Pragma: no-cache o simili header no-cache per impostazione predefinita.
• Rispettare gli header di caching del server (Cache-Control, Expires, Etag). Se la tua cache non è in grado di leggerli, memorizza ogni tile per almeno 7 giorni.
• Mantenere una cache locale sufficiente per garantire che le visualizzazioni ripetute non riscarichino inutilmente le tile.
• Utilizzare le richieste condizionali tramite If-None-Match e If-Modified-Since quando si richiedono tile scadute.

I browser moderni, con le impostazioni predefinite, soddisfano già questi requisiti tecnici.

3.3 Protocolli

• Raccomandato: utilizzare HTTP/2 o HTTP/3 per multiplexare le richieste in modo efficiente.

3.4 App, impostazioni predefinite delle librerie e SDK (identificazione obbligatoria)

Molti client HTTP e Software Development Kit (SDK) utilizzano un header User-Agent generico (es. okhttp/x.y, Go-http-client/1.1, python-requests/x.y, Java/1.8, curl/x.y). Il traffico che utilizza questi valori predefiniti verrà bloccato perché non possiamo identificare o contattare l'applicazione effettiva.

Devi:

• Le app devono configurare un User-Agent distinto e stabile che indichi il nome della tua app e opzionalmente un URL di contatto o un'email.
• Per i siti web, assicurarsi che l'header Referer sia presente e accurato dall'inizio alla fine. Se instradi le richieste tile attraverso i tuoi server o una CDN, non rimuovere né svuotare il Referer.
• Mantenere l'identificazione stabile tra le richieste e i rilasci. È consentito (e utile) aggiornare il numero di versione nel tuo User-Agent quando pubblichi nuove build (es. MyTownMaps/1.4 → MyTownMaps/1.5). Non randomizzare o ruotare il nome del prodotto o i dettagli di contatto, e non impersonare browser o altre app.
• Se pubblichi un SDK, imposta un User-Agent predefinito ragionevole (che indichi il nome dell'SDK e l'URL della documentazione) e fornisci un override semplice per consentire agli sviluppatori di identificare facilmente la propria app.

Non devi:

• Utilizzare lo User-Agent generico predefinito della libreria.
• Nascondersi dietro un User-Agent generico di proxy (es. nginx, Varnish, CDN-XYZ).
• Rimuovere il Referer dal traffico web o incanalare tutti i client dietro un'unica identità anonima.

Applicazione: Il traffico che utilizza valori predefiniti generici, rimozione del referer o identità falsificate potrà essere bloccato senza preavviso. Diamo priorità a operatori identificabili e contattabili per mantenere il servizio affidabile per tutti.

4. Vietato: download massivo ("scraping") e uso offline

Il download massivo è qualsiasi recupero preventivo di tile diverse da quelle che un utente sta attivamente visualizzando. Questo include, ma non si limita a:

• "Pre-caricamento" di aree estese o livelli di zoom multipli in anticipo.
• Creazione di archivi di tile (es. .zip, .mbtiles) per distribuzione successiva.
• Scansioni automatizzate su ampi bounding box, specialmente ad alto livello di zoom (z≥14).
• Bot headless che panoramicano/zoomano la mappa per forzare il rendering.

L'uso offline non è consentito su tile.osmit. Funzionalità come "Scarica città/nazione per uso offline" o "Salva area per dopo" si basano su prefetch/download massivo e sono pertanto vietate. Se hai bisogno di mappe offline, utilizza tile self-hosted o un provider che consenta esplicitamente l'uso offline/prefetch. Le tile vettoriali sono spesso più adatte a questo caso d'uso.

Utilizzo consentito (esempi):

• Visualizzazione interattiva normale da parte di un utente umano, dove il client richiede solo le tile necessarie per la viewport corrente (con un modesto look-ahead a corto raggio tipico dei browser).
• Rivisitazioni servite dalla cache locale rispettando gli header di caching del server (o TTL ≥ 7 giorni se non sei in grado di leggerli).

Utilizzo non consentito (esempi):

• Qualsiasi pulsante "scarica per uso offline" o job in background che recuperi tile che un utente non sta attualmente visualizzando.
• Precaricamento di intere città/regioni o pile di zoom multipli "per precauzione".

Applicazione: I pattern di prefetch/offline generano un carico sproporzionato sui server finanziati dalla comunità e verranno bloccati senza preavviso. Violazioni ripetute possono portare a blocchi a lungo termine o a livello di rete.

5. Proxy di caching

In generale non raccomandiamo di mettere un proprio proxy di caching davanti a tile.osmit.it. Se lo fai, deve:

• Impostare un User-Agent chiaro e contattabile che identifichi l'organizzazione/servizio.
• Rispettare gli header di caching del server o la regola del TTL minimo di 7 giorni indicata sopra.

6. Privacy

L'uso dei servizi Wikimedia Italia è soggetto alla Politica sulla privacy di Wikimedia Italia. Non inviare dati personali o riservati ai nostri servizi. Report su dati di utilizzo anonimizzati e aggregati possono essere prodotti quando necessario.

7. Modifiche e applicazione

Questa politica può cambiare in qualsiasi momento per riflettere le esigenze e i vincoli del progetto. I servizi commerciali, o quelli che richiedono donazioni, dovrebbero essere particolarmente consapevoli del fatto che l'accesso potrebbe essere revocato in qualsiasi momento: potresti non essere più in grado di servire i tuoi clienti paganti se l'accesso viene revocato.

Potremmo cercare di contattarti (ad esempio, tramite il tuo User-Agent o i dettagli di contatto pubblici) in caso di problemi, ma ciò potrebbe non essere sempre possibile. L'accesso potrà essere bloccato senza preavviso.

8. Alternative: servizi basati su OSM, tile vettoriali e self-hosting

Servizi di tile ospitati basati su dati OSM

• Lista della comunità: https://wiki.openstreetmap.org/wiki/Raster_tile_providers

Provider commerciali

• Vedi: Software e servizi commerciali OSM e https://switch2osm.org/providers/

Gestisci le tue tile

• Guida aggiornata: http://switch2osm.org/

Tile vettoriali

• Le tile vettoriali sono un'alternativa alle tile raster e vengono tipicamente renderizzate lato client utilizzando uno stile.
• Possono essere ospitate da terze parti o in self-hosting, e dove i termini del provider lo consentono possono essere impacchettate per uso offline.
• Vedi panoramica: https://wiki.openstreetmap.org/wiki/Vector_tiles

9. Ambito di applicazione

Questa politica si applica alle tile raster servite da tile.osmit.it da parte di Wikimedia Italia.

Non si applica al livello "Carto standard" mostrato su https://tile.osmit.it né ai livelli mostrati su https://openstreetmap.org. Quei livelli possono avere proprie politiche di utilizzo; contatta direttamente i rispettivi progetti se desideri utilizzare le loro tile.

Storia

• Storia del setup e documentazione di amministrazione si trovano in OpenStreetMap/Creazione sito OpenStreetMap Italia
• Delibera Collaboratore creazione stili mappa per sito OpenStreetMap del 21 giugno 2021
• Delibera Allestimento e hosting servizio web di generazione tiles per pubblicazione mappe OSM del 20 marzo 2023
• Politica di utilizzo ufficializzata il 24 marzo 2026