Importazione dati

Per poter avviare e utilizzare il server web di GeoAPI, è necessario importare i dati nei due database:

• MongoDB: contiene i dati ISTAT+CAP dei comuni italiani

• Tile38: contiene due collezioni, una con i poligoni dei limiti amministrativi dei comuni, l'altra con le coordinate geografiche per ciascun comune

MongoDB

La fonte dei dati è la repository comuni-json, mantenuta da BotFactory.

Scarica il file comuni.json ed esegui questo comando per importare i dati nella collezione specificata (va adattato per funzionare su Windows):

mongoimport --uri CONNECTION_STRING --jsonArray --collection COLLECTION "comuni.json"

dove CONNECTION_STRING è una stringa di connessione di MongoDB, ad esempio mongodb://localhost/geoapi, e COLLECTION è il nome della collezione all'interno del database specificato nella stringa di connessione. Non è necessario creare la collezione manualmente, né definire indici, che verranno creati in automatico dall'applicazione.

È consigliato dare un nome unico alla collezione, in modo che in caso di aggiornamenti dei dati in futuro sarà possibile importare i dati in un'altra collezione. Ad esempio: comuni201709 se i dati sono stati importati a settembre 2017.

Tile38 GeoNames

La prima collezione da importare in Tile38 contiene le associazioni tra codice ISTAT e coordinate geografiche del comune. I dati in questione sono reperibili su GeoNames.

• Scarica il file IT.zip dal dump di GeoNames

• Estrai il file IT.txt

• Esegui lo script contenuto nel file scripts/points.js di questa repository per importare i dati (node scripts/points.js)

  • Ricorda di modificare nel file points.js il percorso del file, l'URL HTTP di Tile38 e il nome della collezione (points di default) per l'importazione

Anche in questo caso è consigliato dare un nome unico alla collezione, ad esempio points201709 se i dati sono stati importati a settembre 2017.

Tile38 confini ISTAT

La seconda collezione contiene le associazioni tra codici ISTAT e i poligoni che definiscono i confini dei comuni. I dati sono forniti dall'ISTAT con licenza CC-BY 3.0.

• Scarica il file Limiti01012018.zip (fonte)
• Estrai in particolare la cartella Com01012018
• Dopo aver installato gli strumenti gdal-bin, esegui il comando seguente per convertire il file Com01012018_WGS84.shp in formato GeoJSON.

ogr2ogr -f GeoJSON -t_srs EPSG:4326 out.geojson Com01012018_WGS84.shp

• Esegui lo script contenuto nel file scripts/polygons.js di questa repository per importare i dati dal file out.geojson in Tile38 (comando node scripts/istat.js)

  • Ricorda di modificare nel file polygons.js il percorso del file out.geojson, l'URL HTTP di Tile38 e il nome della collezione (polygons di default) per l'importazione

Anche in questo caso è consigliato dare un nome unico alla collezione, ad esempio polygons201709 se i dati sono stati importati a settembre 2017.