Attenzione: venerdì 3 aprile la wikina sarà temporaneamente bloccata in scrittura per migrazione server, con aggiornamento della versione di MediaWiki e del tema.
Eventuali modifiche apportate quel giorno potrebbero non essere salvate.
Vedi task: T406686 : Adopt Vector 2022 in wiki.wikimedia.it

OpenStreetMap/Tiles OSMit

Da Wikimedia Italia.
Jump to navigation Jump to search

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

Bozza di 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, utilizza un servizio alternativo basato su OSM (vedi sotto) oppure gestiscine uno tuo.

Riepilogo rapido

Devi:

  • Utilizzare l'URL corretto:
  • 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:

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.

Template:Nota

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 OSMF è 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

Provider commerciali

Gestisci le tue tile

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 ai livelli mostrati sulla homepage di OpenStreetMap.org. Quei livelli possono avere proprie politiche di utilizzo; contatta direttamente i rispettivi progetti se desideri utilizzare le loro tile.

Storia

Estratto da "https://wiki.wikimedia.it/index.php?title=OpenStreetMap/Tiles_OSMit&oldid=1297618"