It:JOSM
From OpenStreetMap
| Other languages: | +/- |
|---|---|
|
English • Deutsch • Français • Finnish • 日本語 • Italiano • Русский • Slovensky • עברית • 正體中文 • 简体中文 | |
| Pagine di aiuto in italiano |
| Il portale italiano |
|
JOSM è il "Java Open Street Map Editor" sviluppato da Immanuel Scholz e attualmente mantenuto da Frederik Ramm. La sua pagina web è accessibile all'indirizzo http://josm.openstreetmap.de/, dove è possibile scaricare l'ultima versione (la release notturna, circa 1.5 MB). E' necessaria la versione 1.5 o successiva di Java.
Contents |
Quale editor utilizzare
Ci sono altri programmi di editing per i dati di OpenStreetMap, come l'editor in linea Potlatch oppure Merkaartor. Quando dunque si dovrebbe utilizzare JOSM e quando un altro editor? JOSM è un editor ricco di funzionalità per gli utenti che hanno già una certa esperienza nella mappatura. Esso richiede alcune nozioni per la sua installazione e configurazione. Se si ha intenzione di diventare un buon mappatore di OSM, allora vale la pena spendere un po' di tempo per imparare ad utilizzarlo; basta avere un po' di familiarità con il computer.
Si dovrebbe utilizzare questo editor offline se:
- Se si vuole modificare una grande quantità di dati.
- Se si vogliono modificare dei dati senza avere un effetto immediato sulla mappa (per fare qualche prova).
- Se si hanno a disposizione delle foto acquisite durante la rilevazione e si vogliono visualizzare in corrispondenza della posizione di acquisizione.
- Se si vuole un editor offline senza connessione ad internet e si vuole modificare un'area su cui anche altri utenti stanno operando. JOSM supporta la fusione delle modifiche e la gestione dei conflitti (ricordarsi di effettuare un download prima di ogni upload).
Probabilmente non si vuole usare JOSM se:
- Se si vuole dare un nome ad una sola strada. Usare piuttosto l'editor online.
- Se non si vuole installare una applicazione sul proprio pc.
- Se si sta modificando una mappa con un computer protetto da un firewall che non permette a JOSM di operare correttamente (es. dal posto di lavoro).
- Se il proprio computer non dispone dei seguenti requisiti.
Requisiti
Per poter utilizzare JOSM sul proprio computer è necessario:
- Java 1.5 o superiore (sfortunatamente Java 1.5 non è disponibile per Mac OS X 10.3, JOSM funziona probabilmente su OS X 10.4)
- 256 MB di RAM o più
- una risoluzione dello schermo di 1024*768 o superiore (800*600 potrebbe essere troppo poco)
- è raccomandata una scheda grafica con accelerazione 2D. Se si ha a disposizione solo OpenGL, si potrebbe provare a passare a Java il parametro
-Dsun.java2d.opengl=true
Se si hanno dei problemi con questa impostazione (errori sulle icone e sullo sfondo, finestre. testato su WinXP + nVidia FX1500 + dual monitor) usare:-Dsun.java2d.opengl=true -Dsun.java2d.opengl.fbobject=false
prendere in considerazione che l'opzione opengl può causare problemi con i window managers su Linux.
Download & installazione
E' necessario avere Java 1.5 installato sul proprio computer per poter eseguire JOSM. Sfortunatamente Java 1.5 non è disponibile per Mac OS 10.3.x.
E' necessario semplicemente scaricare il file jar di JOSM, che può essere trovato sul sito principale.
Dal momento che varie persone hanno iniziato a lavorare su JOSM, sono disponibili differenti estensioni che può potenziarlo secondo le proprie necessità.
Installazione di Java
Prima di tutto si deve installare Java sul proprio sistema prima di poter eseguire JOSM:
Linux
- Installare la Java Runtime da qui Java SE
Ubuntu
- Digitare:
$ sudo aptitude install sun-java6-jre
Debian "pure"
- Digitare (as root):
$ apt-get install sun-java6-jre
Nota: Se si è installata un'altra JVM, o si seleziona la sun java vm specificando il suo eseguibile (/usr/lib/jvm/java-6-sun/java) oppure aggiornare la configurazione del sistema eseguendo "update-java-alternatives -s java-6-sun"
Gentoo
Installazione standard:
emerge josm
se si è interessati agli ultimi josm-development e plugins usare il OpenStreetMap Gentoo Overlay. Utilizzando la chiave "x86" si ottiene una versione stabile, mentre la chiave "~x86" installa la versione di sviluppo svn.
Sono disponibili varie estensioni come ebuilds. Per una lista completa accedere a http://svn.openstreetmap.org/applications/utils/gentoo/.
openSUSE/Fedora/Mandriva
I pacchetti JOSM sono disponibili nel openSUSE's build service, nel repositorio Application:Geo.
Andare su http://download.opensuse.org/repositories/Application:/Geo/, selezionare la propria distribuzione e cercare l'RPM nella cartella noarch. Installare usando RPM oppure il proprio gestore dei pacchetti favorito.
Esempio per openSUSE 10.3 usando zypper:
zypper ar http://download.opensuse.org/repositories/Application:/Geo/openSUSE_10.3 zypper ref zypper in josm
Usare questo per l'installazione openSUSE OneClick:
http://packages.opensuse-community.org/index.jsp?searchTerm=josm
Windows
- Installare il Java Runtime da qui: Java SE
Mac OS X
- Java 1.5 è già installato con OS X 10.4 o successivo.
JOSM plugins
Una lista delle estensioni si trova alla pagina dei JOSM/Plugins su questo Wiki, e anche su JOSM Wiki. Le estensioni si installano come descritto di seguito:
Linux & Mac OS X
- Installare Java Runtime, se non lo si è già fatto
- Per installare le estensioni, salvarle in
~/.josm/plugins(es./home/$USER/.josm/plugins/wmsplugin.jar)
Windows
- Installare Java Runtime, se non lo si è già fatto
- Sull'ultima versione di JOSM (April 2007), copiare le estensioni in C:\Documents and Settings\your user name\Application Data\JOSM\plugins
Come eseguire JOSM
E' necessario passare il file jar al Java 1.5 runtime. Questo passo è differente su varie piattaforme:
Linux
Digitare java -jar josm.jar in una shell. Ci sono anche alcuni video-guide. Una descrive i passi per impostare KDE per eseguire JOSM semplicemente cliccando sul file JAR. Le guide sono disponibili da uno dei mirror elencati su openstreetmap.de.
Gli utenti di Ubuntu hanno a disposizione una buona guida su UbuntuForums.
Se è necessario utilizzare JOSM dietro un proxy, si può specificarlo al java runtime come java -Dhttp.proxyHost=192.168.1.1 -Dhttp.proxyPort=3128 -jar josm.jar, con l'IP e la porta del proprio proxy.
Se è necessario ipv6, si può specificarlo al java runtime con -Djava.net.preferIPv6Addresses=true
es.
java -Djava.net.preferIPv6Addresses=true -Dhttp.proxyHost=proxy.ipv6.uni-leipzig.de -Dhttp.proxyPort=3128 -jar josm/josm-snapshot-xxx.jar
Il proxy menzionato qui è solo perché il server openstreetmap non supporta ancora l'ipv6.
Windows
Generalmente basta fare doppio click sul file josm.jar per eseguire JOSM.
In quei casi rari in cui non funziona, creare un file di testo di nome start_JOSM.bat con un semplice blocco note. Scrivere quindi le seguenti righe nel file:
java -jar josm.jar
Salvare questo file .bat nella stessa cartella dove è posizionato josm.jar. Basta ora quindi fare doppio click sul file .bat e JOSM si aprirà.
Si può anche creare un collegamento al file JOSM.jar che permette l'inclusione di parametri addizionali. Ad esempio il seguente apre una finestra del terminale (utile per vedere il progresso degli uploads/downloads), carica JOSM in una sua finestra separata, e assegna 512MB di memoria al processocosì da velocizzare molto le operazioni su dati molto densi. Cambiare "path" con il percorso completo del proprio file josm-latest.jar.
C:\WINDOWS\system32\java.exe -jar -Xmx512M "C:\path\josm-latest.jar"
Sistemi Mac OS X
E' necessario un Mac OS 10.4 o superiore. Sulla versione 10.3 non funzionerà. Nella versione 10.4.x, fare semplicemente doppio click sul file jar e Java 1.5 dovrebbe caricare JOSM. Se si vuole allocare maggiore memoria per JOSM (per poter modificare una maggiore mole di dati), il seguente script sarà utile:
java -jar -Xmx256M -XX:MaxPermSize=256M josm-latest.jar
Per iniziare
- Se si ha a disposizione un file GPX contenente dei tracciati delle vie che si vogliono mappare, aprire JOSM. Selezionare File → Open per selezionare e caricare il proprio tracciato. JOSM automaticamente adatterà l'area di lavoro secondo i confini del proprio tracciato.
- Se non si ha a disposizione un tracciato GPX allora si possono eventualmente usare i dati raccolti da altri utenti. Guardare Korea Mapping Guide
- Se si vogliono provare le varie funzionalità messe a disposizione da JOSM senza apportare delle modifiche ai dati sul server allora è sufficiente non effettuare l'upload (il download si può usare senza problemi), eliminare i livelli (layers) modificati, e quindi eventualmente iniziare nuovamente.
- Effettuare sempre un download prima di apportare delle modifiche a dei dati memorizzati sul proprio computer.
- Per scambiare dei dati con il server assicurarsi che si sia impostata la propria username e password nelle impostazioni di JOSM. La propria username non è la username del wiki ma l'indirizzo di posta che si è utilizzato per la registrazione.
- Ora selezionare File → Download from OSM. Nella finestra che compare assicurarsi che l'opzione per scaricare i dati OSM sia abilitata e premere il tasto OK. Ricordarsi sempre di effettuare un download prima di ogni upload.
- Se i dati da scaricare sono troppi, il server si rifiuterà di spedirli per quell'area. in questo caso restringere l'area per diminuire i dati su cui intervenire.
- Attendere finché tutti i dati sono stati ricevuti. Se ci sono vie già esistenti per la propria area nel database, a questo punto saranno visualizzate in JOSM.
- Ora si può iniziare la propria sessione di modifiche. Si deve stare attenti quando si modificano dati esistenti, siccome le strade e i nodi possono già avere una gran quantità di informazioni associate.
- il manuale di JOSM è disponibile online qui, e queste pagine possono essere raggiunte premendo F1 all'interno della finestra di JOSM. Se si sono combinati dei pasticci basta semplicemente eliminare i livelli (layers) che si sono modificati prima di fare un upload e quindi iniziare nuovamente.
- Consultare questa pagina per una lista di scorciatoie predefinite.
Trucchi e consigli
Vedere anche JOSM/Advanced Tricks (ulteriori trucchi per utenti con esperienza)
- Dopo aver installato un plugin, si deve andare sulle preferenze dove si possono abilitare e disabilitare ogni plugin
- Per i nuovi utenti di OSM, si raccomanda di usare un file di impostazioni predefinite per facilitare l'assegnazione delle etichette (informazioni associate a vie/nodi). Si può chiedere alla mailing list o a User:SlowRider
- Per vedere le vie in colori e dimensioni differenti, installare il plugin mappaint
- Dopo che si sono pubblicati le proprie modifiche sul database di openstreetmap.org, è necessario aspettare un po' di tempo (generalmente una settimana) prima di poter vedere la propria nuova strada sulla slippy map. Se si vuole abbreviare il tempo di attesa, allora ci si potrebbe appoggiare al progetto Tiles@home
- Se non si ha a disposizione un mouse dotato di rotellina, si può ingrandire e rimpicciolire l'area di lavoro usando la combinazione di tasti Ctrl-. (punto) e Ctrl-, (virgola).
- Se si è mappata una carreggiata di una autostrada, scaricare da qui uno strumento che crea automaticamente la carreggiata opposta
- La sensibilità agli spostamenti dei nodi è impostata in maniera predefinita affinché siano leggermente rallentati. Probabilmente si vedrà che impostando la soglia a 5 il sistema diventerà più sensibile. Nelle impostazioni avanzate aggiungere una chiave soprannominata edit.initial-move-threshold e assegnarle il valore 5.
Associazione automatica delle foto ai tracciati GPS
Uno dei problemi di quando si rilavano dei tracciati GPS è quello di mantenere delle note accurate sui nomi delle strade in corrispondenza di ogni incrocio/svincolo. Se si possiede una macchina fotografica digitale che si porta con sé, JOSM può aiutare.
- scattare una foto del schermo del proprio GPS che immortali la data/ora (sul GPS) di quando si inizia
Mentre si procede al rilevamento GPS, si scattano delle foto in corrispondenza di particolari luoghi/incroci/segnali stradali. Quindi, quando si completa il tracciato e lo si carica in JOSM:
- Posizionarsi nel riquadro "Layers", in alto a destra
- Cliccare con il tasto destro del mouse sul livello (layer) del tracciato GPS che è stato appena caricato. Nota: si deve farlo sul livello che è stato appena caricato, e non sui dati che sono stati scaricati da OSM, siccome questi ultimi non hanno più un riferimento alla data/ora in cui sono stati acquisiti.
- Selezionare "Import Images" (o anche "import photos")
- Cliccare con il tasto destro del mouse sul livello delle foto
- Sincronizzare gli orologi prendendo come riferimento la foto scattata all'inizio del rilevamento (sul GPS)
- Se per qualche ragione non si possiede una foto del GPS, accendere la macchina fotografica e il GPS e calcolare la differenza degli orologi tra di essi. Questa differenza va sottratta o aggiunta al tempo visualizzato nella finestra di sincronizzazione degli orologi di JOSM.
Associazione automatica di registrazioni sonore ai tracciati GPS
Come per le foto, c'è una funzionalità simile per l'applicazione e la sincronizzazione di registrazioni sonore.
Ci sono tre metodi, descritti con delle istruzioni passo-a-passo, nella guida di JOSM:
1. Registrazione continua con marcatori GPS
Con questo metodo si possono raccogliere dei punti stradali espliciti lungo il tracciato usando i tasti sul proprio ricevitore GPS e allo stesso tempo dettare continuativamente con il proprio registratore audio descrivendo cosa il punto stradale rappresenta - un nome di una via o un punto di interesse. Le proprie note GPS dovrebbero contenere tre informazioni - la sua posizione, l'istante di acquisizione, il suo nome o numero. La registrazione sonora e il punto stradale sono così sincronizzati in JOSM cosicché si possa raggiungere ciascuna descrizione semplicemente cliccando sul marcatore che rappresenta il punto della strada.
2. Registrazione continua con identificazione vocale del punto di interesse
Con questo metodo si possono effettuare delle registrazioni vocali continue ma, invece di inserire i punti stradali nel proprio GPS, si detta un riferimento audio per ogni punto di interesse, per esempio dettando "MARCATORE! Scuola elementare Don Milani sulla destra".
3. Brani audio con punti stradali
Con questo metodo, si creano dei punti stradali per identificare luoghi di interesse. Si registrano dei brani audio separati per ogni punto e il nome di ogni file è aggiunto come un elemento <link> in corrispondenza del punto stradale sul tracciato del file GPX prima di caricarlo in JOSM. Quando JOSM crea quindi il marcatore audio per ogni punto stradale, conosce quale brano vocale riprodurre quando si clicca sul marcatore.
Messaggi di errore JOSM
Error while parsing. An error has occurred
La causa più comune di questo errore è che il server è lento e non ha risposto alla richiesta di JOSM. Se succede provare a effettuare nuovamente l'upload dei dati e JOSM riprenderà l'upload da dove si era fermato.
Se si ottiene l'errore error 412 precondition failed, significa che qualcosa è cambiato sul server in maniera imprevista. Provare ad eliminare gli oggetti affetti da modifiche.
JOSM sembra avviarsi, ma la finestra è nera
Se si dispone delle spettacolari potenzialità della grafica di compiz/beryl, questo può succedere. La soluzione è semplice: si deve aggiungere la seguente riga al profilo utente:
export AWT_TOOLKIT="MToolkit"
Note per i principianti
Qui sono elencate alcune note per i primi giorni dei principianti (Parsingphase) che lavorano su OSM, utilizzando l'editor JOSM (su Mac OS X).
Punti specifici per Mac
- "Installare" JOSM su un OS X è banale — basta scaricarlo e cliccare due volte sul file .jar.
- Usare un mouse dotato di due pulsanti con una rotellina — questo rende la vita più facile. Lo spostamento con il tasto destro muove la mappa, la rotellina cambia l'ingrandimento.
- Diversamente, command-click ("Apple-click") effettua un click destro, ctrl-frecce muove la mappa, e ctrl-, e ctrl-. cambia l'ingrandimento.
- Siccome inizia con un punto, la propria cartella ~/.josm sarà invisibile al Finder. Quindi si devono aggiungere le proprie estensioni mediante riga di comando, o aprire la cartella usando il comando "Go to Folder..." (menu "Go" nel Finder).
- C'è uno stile di visualizzazione Mac OS X sotto il menu Edit → Preferences; questo non cambia però alcuna funzionalità
Punti per tutte le piattaforme
- Si consiglia di usare la visualizzazione fornita dall'estensione "mappaint". Esso permette di vedere in modo più intuitivo quello che c'è nelle proprie mappe, a spese di un lavoro aggiuntivo per il processore del proprio computer. (Questa estensione è stata ora integrata in JOSM e può essere attivata/disattivata dal menu view > view wireframe)
- Si consiglia di fare gli upload e i download di piccole aree, frequentemente. Minore è il tempo in cui si tengono modifiche ancora non pubblicate, minore è la probabilità che ci sia un conflitto con altri utenti.
- Si consiglia di scaricare un'area prima di iniziare a lavorarci sopra, anche se si dispone di propri dati GPX.
- Si consiglia di scaricare l'area subito prima di effettuare un upload, così da ottenere eventuali modifiche fatte da altri utenti ed evitare la sovrascrittura delle loro modifiche.
- Quando si scarica un'area si ottengono tutti i dati inclusi nel riquadro rettangolare che si è scelto, incluse quelle parti di vie che fuoriescono dallo stesso riquadro. Quindi risulta difficile conoscere precisamente di quale area si ottengono i dati completi. Se si seleziona l'opzione "Draw boundaries of downloaded data" (nelle impostazioni di visualizzazione), verrà disegnato un rettangolo giallo lungo l'area per cui sono stati scaricati i dati completi. Bisogna fare attenzione quando si aggiungono dei nuovi dati esterni a questi rettangoli, perché si possono creare dei duplicati su dati già esistenti, che non sono stati scaricati.
- Una "piccola area" per iniziare può essere sia quella corrispondente ad un breve tracciato GPX che si è acquisito, oppure un riquadro di 1 km per lato intorno ad un punto conosciuto. Questo corrisponde a circa 0.06° di latitudine/longitudine (più o meno la distorsione polare), quindi si può introdurre un'area di una dimensione analoga in File → Download from OSM → Bounding Box.
- Le aree rurali con pochi dati possono essere modificate meglio con aree più ampie — la raccomandazione di 1 km è valida per una zona grande quanto un quartiere di Londra.
- Nel momento in cui si sta operando su un'area in JOSM, a qualunque livello di ingrandimento, la finestra di download di JOSM prenderà in considerazione l'area correntemente visualizzata.
- E' molto facile selezionare qualsiasi cosa, più di quanto ci si aspetta, in modo particolare quando si creano delle "vie". Aprire il pannello "Current Selection" (Alt-e, quinto pulsante da sotto, sulla sinistra) per mantenere una visione su cosa è correntemente selezionato.
- Tornare alla modalità di selezione regolarmente e cliccare su un'area vuota o digitare Ctrl-Shift-A per svuotare la propria lista di selezioni.
Perché le mie modifiche non vengono visualizzate?
- Consultare le caratteristiche della mappa per vedere come specificare che la propria è una strada/ferrovia etc, e di quale tipo. se non si è sicuri del tipo (es. statale/provinciale) si consiglia di essere prudenti e scegliere il tipo minore (es. provinciale).
- Le mappe ufficiali sono comunque aggiornate ad intervalli di qualche giorno. Si potrebbe utilizzare il progetto Tiles@home per essere in grado di ridisegnare in proprio la mappa di tipo osmarender.
Vedere anche
Argomenti correlati
- Pagina per il brainstorming sulla interfaccia utente di JOSM
- Panoramica dei componenti di OpenStreetMap
- Formato dei file JOSM
- Funzione di ricerca di JOSM
- Guida sull'esecuzione di JOSM da dischi flash con Java
- mailinglist per gli sviluppatori di JOSM
