SnowTime · gli script dei dati aperti
=====================================

Questi script costruiscono i dati di SnowTime che vengono da OpenStreetMap e da altre fonti aperte.
La pagina con i file e le licenze: https://snowtime.app/dati/


Cosa c'è
--------

tools/poi/
  build_poi.py, query.overpassql, curated.json
  Rifugi, bivacchi, baite, cime, punti panoramici, piste e comprensori di Alta Valtellina, Livigno
  e Lago di Resia. Scrive Shared/POI/POIData.json e TerrainWeb/poi.js.

tools/trails/
  build_trails_v2.py: i sentieri di Alta Valtellina e Livigno, con livello CAI, tempi e profilo.
  Scrive Shared/Trails/TrailData.json e TerrainWeb/trails.js.
  build_trails.py: la prima versione, tenuta per confronto.

tools/explore/
  build_explore.py: i dati di Esplora (Shared/Explore/ExploreData.json e TerrainWeb/explore.js).
  trains_europe.py: i binari dei treni panoramici d'Europa, da OpenStreetMap.
  merge_views.py: unisce e controlla i panorami.
  build_importance.py: quanto conta ogni posto sulla mappa (TerrainWeb/importance.js).

tools/explore/data/
  Le liste curate da noi: mercatini, luci di Natale, aurora, laghi che ghiacciano, panorami,
  treni e foliage d'Europa, posti famosi. Luoghi, date e note sono controllati sulle pagine ufficiali.


Come si usano
-------------

- Servono Python 3 e Pillow (pip install Pillow).
- La cartella che contiene tools/ fa da radice: i risultati vanno in Shared/ e TerrainWeb/.
  Crea la cartella TerrainWeb/ prima di partire.
- In cima a ogni script ci sono ingressi, uscite e opzioni.
- Quando servono, gli script scaricano i dati da OpenStreetMap (Overpass e API), Mapterhorn,
  Natural Earth e Open Data Hub, e li tengono in una cartella di cache che scegli tu.
- Alcuni passaggi leggono i file già costruiti: per esempio build_trails_v2.py legge POIData.json
  e build_importance.py legge ExploreData.json.


Licenze
-------

- I dati ricavati da OpenStreetMap sono © OpenStreetMap contributors e sono disponibili sotto la
  Open Database License 1.0: https://opendatacommons.org/licenses/odbl/1-0/
  Dettagli: https://www.openstreetmap.org/copyright
- Quote e rilievo: Mapterhorn. Fonti e licenze: https://mapterhorn.com/attribution
- Città e abitanti: Natural Earth, dominio pubblico.
- Livelli e nomi di alcuni sentieri: Regione Lombardia, Rete Escursionistica Lombarda (CC BY 4.0).
- Mercatini dell'Alto Adige: Open Data Hub (CC0).
- In curated.json il testo sul Campanile di Curon viene da Wikipedia (CC BY-SA 4.0) e la foto citata
  è di John Mason (CC BY 2.0). I crediti sono nel file.


Domande e correzioni: ciao@snowtime.app
