JOSM-opas

From OpenStreetMap

Other languages:	+/-
English  •  Deutsch  •  Français  •  Finnish  •  日本語  •  Italiano  •  Русский  •  Slovensky  •  עברית  •  正體中文  •  简体中文

JOSM on monipuolinen Java-editori Openstreetmapille. Toisin kuin Potlatchilla editoidessa, JOSM ei lähetä muutoksia välittömästi palvelimelle, vaan teitä voi hingata omalla koneella niin kauan kuin tykkää ja vasta tämän jälkeen lähettää muutokset palvelimelle. Tästä on erityisesti hyötyä, kun onnistuu kusemaan puolet Suomesta muokkauksillaan, niin muutokset eivät ole tallentuneet palvelimelle, ellet ole erikseen painanut upload-nappulaa.

Contents 1 Asentaminen 1.1 Käynnistäminen 1.2 Asetukset 1.3 Laajennukset 2 Alku 3 Navigointi 4 Valitseminen 5 Tagien päivittäminen 6 Tien lisääminen 7 Poistaminen 8 Muutosten lähettäminen palvelimelle 9 Relaatioiden käsittely 9.1 Reikäinen alue 9.2 Vasemmalle/Oikealle kääntyminen kielletty 9.3 U-käännös kielletty 10 Yleisiä kikkoja 10.1 Tien katkaisu 10.2 Teiden yhdistäminen 10.3 Nodejen yhdistäminen

Asentaminen

Voit ladata JOSM:in koneellesi osoitteesta josm.openstreetmap.de. Tarvitset lisäksi suhteellisen tuoreen version Java Runtime Environmentista (myös vapaa IcedTea toimii). Suositelemme käyttämään aina uusinta (snapshot) versiota JOSMista.

Käynnistäminen

Jos kaikki on kunnossa, JOSM:in pitäisi käynnistyä, kun kaksoisklikkaat lataamaasi josm-latest.jar-tiedostoa (käyttöjärjestelmästä riippuen). Jos homma ei lähde pelittämään, voi kysyä apua vaikka talk-fi-postituslistalta tai katso käyttöjärjestelmäkohtaiset ohjeet JOSM sivusta. Jos puolestaan käytön aikana muisti loppuu, kokeile käynnistää Josm seuraavasti:

java -Xmx512m -jar josm-latest.jat

Asetukset

Ensimmäisen käynnistyksen jälkeen tulee säätää asetukset kohdalleen. Tämä onnistuu valitsemalla Edit->Preferences (F12).

1. Ensimmäiseltä välilehdeltä kannattaa valita "Draw Direction Arrows".
2. Toiselle välilehdelle puolestaan täytä OSM-käyttäjätunnuksesi (sähköpostiosoite, jolla olet rekisteröitynt) ja salasanasi.
3. Kolmannella välilehdellä projektioksi kannattaa valita Mercator, sillä vaihtoehtoinen EPSG:4326 vääristää Suomen leveyksillä muotoja huomattavasti. Myös "Enable built-in defaults" on hyvä valita niin saat valikon jossa on valmiina usein käytettyjä tägejä.

Muuta valittavaa tuskin ensimmäisellä kerralla onkaan. Kannattaa myöhemmin tutustua kaikkiin asetuksiin, mutta näillä pääsee hyvin vauhtiin. Kun olet sulkenut asetukset Ok-napilla, täytynee JOSM käynnistää uudestaan.

Laajennukset

JOSM:n omisaisuuksia voi laajentaa laajennuksilla/plugineilla. Kannattaa tutustua nähin, osasta voi olla paljonkin hyötyä. Varsinkin "Validator" ("Tarkastaja") laajennus on hyvä ottaa käyttöön, jotta näkee, onko kartassa tyyppillisimpä virheitä.

Alku

JOSM:in käynnistämisen jälkeen ensimmäinen ongelma on, kuinka saada kartta-aineisto ladattua ja muokkaaminen aloitettua. Tähän on kaksi hyvää vaihtoehtoa:

1. Jos sinulla on GPX-tiedosto tai -tiedostoja alueestasi, helpointa on valita File->Open tai vastaava kuvake työkalupalkista ja avata tiedostosi. Tämän jälkeen JOSM näyttää tiedostoissa olevat pisteet ikkunassaan ja ennen kuin jatkat, kannattaa zoomata sille aluelle jota haluat muokata, silla JOSM lataa vain ja ainoastaan tiet, jotka sijaitsevat näkymän alueella. Tämä onnistuu helpoiten hiiren rullalla. Hyvän kokoinen alue on esimerkiksi sellainen, jossa ikkunan vasemmassa yläkulmassa olevan janan alla lukee noin 3-7 km. Tämän jälkeen voit ladata alueen painamalla työkalupalkin vasemmassa reunassa olevaa download-nappia. Avautuvasta ikkunasta valitse "OpenStreetMap data " ja jos haluat ladata muiden palvelimelle lähettämät gps-pisteet, valitse myös "Raw GPS data". Tämän jälkeen paina Ok ladataksesi alueen koneellesi.
2. Toinen vaihtoehto on etsiä haluamasi alue kartalta openstreetmap.org:issa ja klikata hiiren kakkospainikkeella alakulmassa olevaa Permalink-linkki ja valita kopioi linkin osoite. Tämän jälkeen klikkaa JOSM:issa vasemman yläkulman Download-nappulaa ja pastaa (ctrl+v) kopioimasi osoite alareunan URL-laatikkoon. Valitse muut asetukset kuten edellisessä kohdassa ja klikkaa Ok. Kun JOSM on ladannut alueen, kannattaa zoomata muutama pykälä ulos hiiren rullalla ja klikata uudelleen Download-nappia. Nyt Download-dialogin arvot ovat päivittyneet vastaamaan näkymää ja klikkaamalla Ok saat editoriin hieman enemmän lähiympäristöä. Tässä vaiheessa JOSM ei yleensä päivitä karttanäkymää, vaan vasta ladatut kadut ilmestyvät vasta, kun esim. jälleen zoomailet pykälän johonkin suuntaan hiiren rullalla.

Navigointi

Kartalla liikkuminen onnistuu helpoiten pitämällä hiiren oikeaa nappia pohjassa kartan päällä ja liikuttamalla hiirtä. Zoomaaminen puolestaan hoituu helpoiten hiiren rullalla. Liikuttuasi voit aina ladata näkyvällä alueella olevat tiet, joita ei ole vielä ladattu, painamalla Download ja Ok.

Kannattaa myös kokeilla mappaint-moodia, jossa JOSM värittää erilaiset tiet eri väreillä. Tämä onnistuu valitsemalla View->Wireframe view. Jos mappaint-moodia tuntuu hitalta kannattaa kokeilla OpenGL kiihdytystä, antamalla:

-Dsun.java2d.opengl=true 

valitsin java tulkille.

Mappaint ominaisuuden saa pois päältä samalla lailla kun sen saa päällekin.

Valitseminen

Voit valita kartalta tien tai pisteen valintatyökalulla, joka on vasemman reunan paletissa toinen ylhäältä. Työkalun pikanäppäin S. Valitessasi ole varovainen, ettet vahingossa siirrä teitä, sillä samalla työkalulla onnistuu myös siirto. Jos kämmäät jotain, paina Edit->Undo, ja JOSM pelastaa päivän. Jos haluat poistaa valinnan eli palata tyhjään valintaan, klikkaa työkalulla tyhjää kohtaa kartalla.

Jos haluat valita useampia objekteja, valitse ensin yksi ja tämän jälkenn paina shift pohjaan ja valitse muut. Voit myös painaa hiiren pohjaan tyhjällä alueella ja vetää neliön, jonka sisällä olevat objektit valitaan.

Päällekkäistä teiden käsittelyyn tarvitaan usein tieto, että JOSMissa hiiren keskinapilla saat esille listan sillä kohtaa olevista päällekkäisistä teistä. Painamalla ja pitämällä ctrl-nappia pohjassa, voit valita auenneesta listasta haluamasi tien. Muutoin päällekkäisistä teistä halutun valinta voi olla hankalaa tai mahdotonta.

Tagien päivittäminen

Jos haluat muuttaa tien/pisteen ominaisuuksia (esim. lisätä/muuttaa nimen), valitse ensin kyseinen objekti. Tämän jälkeen JOSM näyttää objektiin liittyvät tagit oikean reunan Properties-paneelissa. Voit muokata olemassa olevaa tagia kaksoisklikkaamalla kyseistä riviä. Uuden tagin voit lisätä Add-nappulalla.

Tien lisääminen

Kokonaan uuden tien voit lisätä Draw Nodes -työkalulla (vasemman reunan paletissa kolmas ylhäältä). Pikanäppäin A

1. Klikkaa ensin tien alkupistettä.
2. ja klikkaile tielle uusia pisteitä, kunnes tie on mielestäsi valmis. Jos jonkin pisteen pitäisi osua jo olemassa olevalle tielle, niin klikkaa vaan kyseistä tietä, ja JOSM lisää pisteen kummallekin tielle.
3. helpoin tapa lopettaa piirto on vaihtaa takaisin valintatyökaluun
4. ja sitten lisää lisää tielle oikeat tagit Tagien päivittäminen -kohdan ohjeiden mukaan. Sopivia tageja on esim. highway=residential ja name=Nönnönnöö

Poistaminen

Valitse objekti, jonka haluat poistaa, ja klikkaa vasemman reunan roskiksen kuvaa tai pikanäppäintä D. Huomaa, että JOSM jää tällöin poistotilaan ja kaikki mitä klikkaat poistetaan, ellet vaihda takaisin valintatyökaluun.

Jos poistat tien, kaikki sen nodet, joilla ei ole erityisiä tageja ja jotka eivät kuuluu mihinkään muuhun tiehen poistetaan oletuksena. Jos poistat tiessä olevan noden, JOSM korjaa tien automaattisesti ohittamaan tämän kohdan, eli tie ei katkea.

Muutosten lähettäminen palvelimelle

Kun olet tehnyt muutoksia, ne eivät itsekseen päivity OSM:n palvelimille, vaan ne on erikseen lähetettävä. Tämä on yleensä kaksivaiheinen operaatio:

1. Lataa Downloadilla koko alue, jota olet muokannut. Jos tällä välin joku muu on muuttanut samoja teitä, JOSM kertoo mahdollisista ristiriidoista ja voit korjata homman.
2. Paina Upload-nappia, jolloin JOSM lähettää muutokset palvelimelle.

Muutokset olisi hyvä lähettää aina esim. 10 minuutin välein, jolloin palvelimella on tavallaan varmuuskopio tekemistäsi muutoksista, ja jos joku muu editoi samaa aluetta, ei mahdollisia ristiriitoja tule kovin paljoa, kun tajuaa että joku muukin muokkaa samaa aluetta.

Relaatioiden käsittely

JOSM:illa onnistuu myös [[Relations|relaatioiden] käsittely. Relaatiot keräävät yhteen useita kohteita, jotka voivat olla sekä tie- että solmu-tyyppisiä. Relaation jokaisella jäsenellä on relaatiossa nimetty rooli eikä mikään karttakohde saa olla samassa relaatiossa useampaan kertaan. Jokaiselle relaatiolle annetaan myös omia arvoja (tageja). Jokaisella relaatiolla pitäisi olla tagi "type", jonka arvo määrittää mitä relaatiolla yritetään kuvata.

Kaikki lataamallasi alueella oleviin kohteisiin liitetyt relaatiot näkyvät oikean laidan relations-paneelissa. Jos "Relations"-paneeli ei ole näkyvissä, avaa se; viimeinen painike vasemman reunan painikelistassa ennen lisukeohjelmien lisäämiä painikkeita näyttää ja piilottaa "Relations"-paneelin. (Näppäimistöoikotie alt+r). Uuden relaation lisääminen onnistuu vain tästä paneelista. Jos haluat muokata jotain relaatiota, voit avata relaation ominaisuudet -ikkunan kaksoisnapauttamalla haluamaasi relaatiota tai valitsemalla relaation listasta ja valitsemalla painikkeen "Edit".

Valitun kohteen tiedot -listassa ("Properties/Memberships") näkyy oman alaotsikkonsa (sarakeotsikot "Member of" ja "Role") alla lista relaatioista, joissa valittu kohde on jäsenenä ja missä roolissa valittu kohde on kussakin relaatiossa. Tämän listan riviä kaksoisnapauttamalla saat auki kyseisen relaation ominaisuudet-ikkunan.

Relaation ominaisuudet ("Edit relation") -ikkunassa voit antaa relaatiolle ominaisuuksia/arvoja sekä lisätä ja poistaa relaation jäseniä.

Reikäinen alue

Esimerkkinä reikäisen alueen määrittely, esim. metsä puistossa tai pelto metsän keskellä.

1. Piirrä toisistaan erillisinä lenkkeinä ulkokehä ja sisäkehä(t). (Ulkokehä kiertää myötäpäivään ja sisäkehät vastapäivään.) Nykyisillä ohjeilla sisäkehällä pitäisi olla sama aluetta määrittävä tagi kuin ulkokehällä mutta sen tarpeellisuudesta ei ole varmaa tietoa.
2. Jos "Relations"-paneeli ei ole näkyvissä, avaa se.
3. Valitse kaikki relaatioon haluamasi tiet.
4. Valitse oikean laidan 'Relations'-paneelista "New Relation" (ensimmäinen nappi vasemmalta, "N...")
5. Auenneeseen uuteen ikkunaan määritellään relaation tagit ja siihen kuuluvat jäsenet. Valitse "Add selected" ja valittuna olleet tiet lisätään relaatioon.
6. Ikkunan ylälaidan Tags osassa määrittelet relaatiolle annetut tagit. Reikäiselle alueelle tarvitaan vain key:n alle type ja samalle riville value:n alle multipolygon.
7. Lopuksi määrittelet jokaiselle relaation jäsenelle roolin tässä relaatiossa. Valitse alemmasta listasta yksi jäsen kerrallaan ja kirjoita vasempaan kenttään outer jos kyseinen tie on reikäisen alueen ulkoraja ja inner jokaiselle reikää määrittävälle tielle.
8. Jos et heti tiedä (esim. näytetystä solmujen määrästä) onko jokin lisätty tie ulko- vai sisäreuna, saat kyseisen tien näkymään kartalla valittuna valitsemalla sen listasta ja valitsemalla relaationmuokkausikkunan ala-oikealta painikkeen "Select".

Jos haluat määritellä aukon sisälle uuden alueen (esim. aukossa metsässä on pelto), piirrä aukon ympäri myötäpäivään uusi tie samoja solmuja pitkin ja määrittele tälle aukon sisältöä kuvaava tagi. (Tämän jälkeen JOSMin validator-plugin ilmoittaa päällekkäisistä teistä: viesti ei ole ryhmitelty virheeksi vaan vain ilmoitukseksi käyttäjälle; päällekkäiset tiet voivat olla virhe, joten käyttäjän tulisi olla varma että palvelimelle lähetettävässä tapauksessa tiedot ovat oikein. Päällekkäisten teiden testi on kirjoitettu aikana ennen vakiintunutta alue-tyyppisten teiden käyttöä eikä sitä ole sittemmin parannettu ohittamaan tunnetut päällekkäisten teiden tapaukset. Päällekkäiset esim. highway-tagilliset tiet olisivat yhä virhe.)

Vasemmalle/Oikealle kääntyminen kielletty

Kääntymistä yksisuuntaiselle tielle väärään liikennesuuntaan ei tarvitse ikinä lisätä.

1. Avaa Relations-paneeli jos ei ole vielä auki.
2. Valitse solmu, jonka yhdistämien teiden välillä kääntymiskielto pätee.
3. Luo uusi relaatio (Relations-paneelista New)
4. Valitse "Add Selec..." ja valittuna ollut solmu lisätään relaatioon
5. Kirjoita Relaatio-ikkunassa solmun role-kenttään via (huomaa että vilkkuvaa kursoria ei näy vaikka voit kirjoittaa valittuasi kentän)
6. Kirjoita relaation Tags -taulukkoon Key-sarakkeeseen tyhjään ruutuun type
7. Kirjoita samalle riville Value-sarakkeeseen restriction
8. Lisää seuraavalle riville Key-sarakkeeseen restriction ja Value-sarakkeeseen esim. no_left_turn jos kääntymiskielto on "vasemmalle kääntyminen kielletty". Muut mahdolliset arvot on selitetty alempana.
9. Huomaa että vaikka relaation ominaisuudet -ikkuna on auki, voit valita taustalla yhä näkyvästä kartasta haluamasi tiet. Valitse tiet (saapuva ja lähtevä) ja lisää ne relaatioon valitsemalla taas "Add Selec..."
10. Relaation jäsenet-listassa tiet näytetään nimiensä mukaan, jos teillä on name -tagi. Anna kummallekin lisäämällesi tielle joko arvo from tai to sen mukaan onko tie kääntymiskiellon "mistä"- vai "mihin"-tie.
11. Jos kielto on voimassa vain osan vuorokaudesta, voit lisätä relaatiolle tagit "hour_on" ja "hour_off" arvoinaan kiellon alkamis- ja päättymisajat.

Olisit voinut myös valita kaikki relaatioon tulevat jäsenet jo ennen uuden relaation luomista jolloin ne olisi lisätty relaation ensimmäisellä "Add Select..." painikkeen käytöllä.

Relaatio on nyt valmis. Risteyksen jokaiselle kääntymiskiellolle joudut määrittelemään oman relaationsa. via -roolissa voi olla paitsi yksi solmu, myös useampi solmu tai vaikkapa useampaa ajorataa yhdistävä poikkitie.

Vaikka kääntymiskielto voi sopivien teiden kesken olla yksikäsitteinen ilman kiellon tyyppiä kuvaavaa arvoa, tulee kielto määritellä relaatioon; arvoa voidaan teoriassa käyttää vaikkapa kääntymiskieltomerkkien esittämiseen käyttäjälle. Kääntymiskiellon tyyppiä kuvaavat sovitut arvot ovat

no_right_turn

Oikealle kääntyminen kielletty

no_left_turn

Vasemmalle kääntyminen kielletty

no_straight_on

Suoraan ajo kielletty (ts. pakollinen kääntyminen)

only_right_turn

Vain käännös oikealle sallittu

only_left_turn

Vain käännös vasemmalle sallittu

only_straight_on

Vain ajo suoraan sallittu

no_u_turn

U-käännös kielletty

U-käännös kielletty

Yleisiä kikkoja

Tien katkaisu

Jakaaksesi tien kahteen osaan, valitse node, jonka kohdalta haluat katkaista ja valitse Tools->Split Way. Jos saman noden kautta menee useampi tie, on myös kyseinen tie valittava. Voit myös valita useamman noden, jolloin tie katkaistaan kaikkien nodejen kohdilta.

Huom! JOSM:lla tuntuu olevan ongelmia, jos yrität katkaista tien, joka on ympyrä. Nämä pystyy pilkkomaan helpoiten valitsemalla tien lisäksi kaksi nodea, jolloin JOSM katkaisee kummankin kohdalta.

Teiden yhdistäminen

Voit yhdistää monta tietä yhdeksi valitsemalla kaikki tiet ja tämän jälkeen painamalla Tools->Combine Way. Yhdistettävillä teillä täytyy olla yhteinen päätysolmu jotta yhdistäminen onnistuisi. Voit käyttää myös pikanäppäintä C

Nodejen yhdistäminen

Mikäli haluat yhdistää kaksi tai useampaa nodea (esimerkiksi risteyksessä tiet ovat kiinni eri nodeissa vaikka todellisuudessa pitäisi olla kaikkien samassa), valitse nodet ja tämän jälkeen Tools->Merge Nodes. Voit käyttää myös pikanäppäintä M