Opis programu JOSM to edytor OpenStreetmap napisany w Javie. Działa on we wszystkich systemach operacyjnych, w których można zainstalować pełne środowisko Java.

Główna strona wiki o programie JOSM: https://wiki.openstreetmap.org/wiki/Pl:JOSM

Poradnik JOSM: https://wiki.openstreetmap.org/wiki/Pl:JOSM/Guide

Temat JOSM na forum: https://forum.openstreetmap.org/viewtopic.php?id=24661

Pobieranie i Instalacja JOSM jest dostarczany jest w postaci pojedynczego pliku .jar dostosowanego do pracy w środowisku Java. Dodatkowo dostępne są edycje dostosowane do konkretnych systemów operacyjnych. Dla systemu operacyjnego MS Windows można użyć instalatora, dzięki któremu JOSM staje się normalnie zainstalowanym programem wpisanym do rejestru systemu. Ma to tę zaletę, że wówczas JOSM ma dynamicznie przydzielaną pamięć operacyjną i można w jego pliku konfiguracyjnym trwale zapisać nazwę i hasło użytkownika OpenStreetMap. Dla systemów Linuxowych dostępne są paczki w repozytoriach danej dystrybucji, jednak zwykle są one mało aktualne. Z kolei korzystanie z pliku .jar umieszczonego np. na pendrivie ma tę zaletę, że możemy korzystać z niego bez instalacji na dowolnym komputerze.

JOSM dostępny jest w dwóch wydaniach. Dla użytkowników dostępne jest wydanie nazwane "tested", oprócz tego dostępne jest wydanie developerskie nazwane "latest" jest ono przeznaczone dla osób chcących pomóc w rozwoju edytora. Jednak wydanie developerskie może zawierać błędy i działać niestabilnie!

Najprostszym sposobem korzystania z JOSM jest pobranie przetestowanej wersji w postaci pliku jar: Ważne! Upewnij się że posiadasz aktualną wersję Javy. Zarówno w wersji x86 jak i x64

Jeśli nie masz to możesz pobrać aktualne wersje Java ze strony: https://www.java.com/pl/download/manual.jsp Kliknij na "Windows Offline" aby pobrać najnowszą wersję Java x86 do zainstalowania offline Kliknij na "Windows Offline (64-bitowa)", aby pobrać najnowszą wersję Java x64 do zainstalowania offline Aby pobrać JOSM, należy: Wejść na stronę: https://josm.openstreetmap.de/wiki/Pl%3AWikiStart Kliknąć: "Uruchom josm.jnlp". Plik się pobierze i umożliwi instalację JOSM. Ważne! Program może działać szybciej dzięki uruchamianiu przez specjalny kod Aby uruchamiać JOSM który będzie korzystał z większej ilości RAM, należy: Wejść na stronę https://josm.openstreetmap.de/ Pobrać plik josm-tested.jar Utworzyć plik tekstowy w notatniku: JOSM.txt W pliku JOSM.txt umieścić poniższy kod (z cudzysłowami): "C:\Program Files\Java\jre1.8.0_131\bin\javaws.exe" -J-d64 -Xmx3500M "C:\Users\Admin\Desktop\Aplikacje\josm.jnlp" Informacja! Ścieżki zmieniamy na takie które są na naszym komputerze 5. Zmienić rozszerzenie pliku JOSM.txt na cmd. > JOSM.cmd

Informacja! Od tej chwili możemy uruchamiać JOSM który będzie używać znacznie więcej ramu (domyślnie było 256 MB)

Ważne! Gdy JOSM nie chce się uruchamiać poprzez plik JOSM.cmd to mamy podaną nieprawidłową ścieżkę do pliku javaws.exe albo josm.jnlp. Lub mamy zbyt wysoką wartość przypisanej pamięci: -Xmx3500M

Ważne! Niektóre systemy operacyjne w celu uruchomienia mogą wymagać wydania polecenia w konsoli: java -jar josm.jar

Informacja! JOSM jest intensywnie rozwijany, nowe wersje wydawane są bardzo często, średnio raz kilka tygodni. W momencie uruchomienia JOSM sprawdza, czy nie ma nowszej wersji i sugeruje jej zainstalowanie. W przypadku, gdy mamy stosunkowo starą wersję, JOSM może "odmówić współpracy" i zakończyć działanie na komunikacie wymuszającym instalację nowej wersji.

Pierwsze uruchomienie Po uruchomieniu JOSM'a pojawia się ekran przywitalny zawierający podstawowe informacje o ostatnich zmianach w programie, czasem warto rzucić okiem, być może dostrzeżemy coś co nas interesuje (przydatne funkcje). Zanim rozpoczniemy edycję należy wpisać do programu swoją nazwą użytkownika i hasło z OpenStreetMap. W tym celu klikamy na menu – edycja – ustawienia, a następnie w zakładce "ustawienia połączenia" (ikonka globusa).

Rozpoczęcie edycji Aby przejść do edycji interesującego nas fragmentu mapy musimy ją najpierw wczytać do programu. W tym celu klikamy na ikonkę z zieloną strzałką do dołu (skrót klawiszowy : Ctr+Shift+Down). Otwiera się wówczas okno z mapą OSM, które działa mniej więcej tak samo jak podstawowa mapa OSM na stronie www.openstreetmap.org. Możemy tę mapę przesuwać za pomocą myszy z wciśniętym prawym klawiszem, oraz zmniejszać i zwiększać jej skalę za pomocą rolki. Gdy już znajdziemy interesujący nas fragment mapy, zaznaczamy go myszką z użyciem lewego klawisza myszki. Przeciągając myszką z wciśniętym lewym klawiszem, zaznaczamy prostokątny obszar, który zostanie pobrany do edytora JOSM. Po wybraniu obszaru powinniśmy sprawdzić czy u góry okna jest zaznaczone aby JOSM pobrał dane OSM; możemy też zaznaczyć pobranie "czystych danych GPS" – czyli śladów GPS z wybranego obszaru, które edytorzy OSM załadowali kiedyś na serwer OpenStreetMap. Następnie na dole okna można już kliknąć na "pobierz".

Informacja! Czym większy obszar mapy wybierzemy tym więcej danych zostanie pobranych z serwera OSM na nasz komputer. Najlepiej jest wczytać tylko taki obszar, który faktycznie zamierzamy edytować. Potrwa to krócej i mniej obciąży nasz komputer. Na szczęście serwer OSM blokuje możliwość wczytywania zbyt dużego obszaru. Już w trakcie edycji można zawsze dograć kolejne fragmenty mapy.

Po szczęśliwym wczytaniu danych, program przechodzi w tryb edycji. Główną część ekranu zajmuje coś, co nie bardzo wygląda na mapę, choć nią jest. Mapa ta ma uproszczony do granic możliwości wygląd , aby pokazać bezpośrednio same obiekty, z których składa się mapa i umożliwić ich szybką i dokładną edycję. Na ekranie widzimy różnokolorowe kreski i małe kwadraciki, od których początkowo dostaje się lekkiego oczopląsu. Kreski to drogi lub obszary, a kwadraciki to węzły.

Oprócz tego, jeśli zaznaczyliśmy wczytanie "czystych danych GPS" zobaczymy je w formie cienkich, szarych linii, których w odróżnieniu od właściwej mapy nie można zaznaczyć ani nimi manipulować. Dane GPS znajdują się w osobnej warstwie, która jest tylko "rzucona" na właściwą, edytowalną mapę. Jedno z okien po prawej stronie ekranu (zwykle pierwsze od góry) umożliwia włączanie i wyłączanie widoczności warstw, a także układanie ich w wybranej przez siebie kolejności. Oprócz warstwy podstawowej i warstwy ze śladami GPS pobranymi z serwera OSM, możemy też stworzyć kolejne warstwy. Jeśli w menu u góry klikniemy na "Plik-otwórz" i wczytamy nasz własny ślad GPS, to wówczas pojawi się on w nowej, osobnej warstwie. Inną często przydatną w praktyce warstwą jest podkład ze zdjęć satelitarnych, Można ją włączyć, klikając w menu u góry na "podkłady mapy". Dla terenu Polski szczególnie przydatna jest warstwa zdjęć z Bing.

Część mapy, którą widzimy na ekranie w formie zakreskowanej jest jej fragmentem, który nie został jeszcze wczytany. Często zdarza się, że wiele obiektów z wczytanej części mapy, "włazi" na część nie-wczytaną. Wynika to z faktu, że JOSM pobiera wszystkie obiekty z wybranego do edycji obszaru - również te, które "wychodzą" poza ten obszar. Np. Jeśli przez nasz obszar przechodzi droga E75, to zostanie ona wczytana w całości - od Norwegii aż po Grecję.

Każdy z obiektów z podstawowej warstwy OSM można zaznaczyć przez kliknięcie - jeśli klikniemy na linię między węzłami zaznaczamy cały obiekt, jeśli klikniemy na węzeł zaznaczymy tylko ten jeden węzeł. Zaznaczony obiekt zmienia kolor na czerwony i staje się aktywny. Odpowiednio przesuwając myszą, można zaznaczony obiekt przesuwać i/lub zmieniać jego kształt. Po kliknięciu w dowolny obiekt, w oknach po prawej strony mapy pokazują się najróżniejsze informacje o zaznaczonym obiekcie i obszarze. Okno "właściwości" zawiera tagi i atrybuty obiektu, inne pokazuje historię edycji danego obiektu, jeszcze inne typy węzłów i relacji z którego składa się nasz obiekt. Większość z tych okien umożliwia też zmianę odpowiednich parametrów obiektu.

Podstawowe rysowanie Wrysowywanie nowych obiektów w JOSM jest w miarę intuicyjne. Wrysowywanie obiektu: Najpierw należy przełączyć się w tryb rysowania, klikając na ikonkę z lewej strony "tworzenie węzłów i dróg". Następnie trzeba zacząć rysowanie od utworzenia pierwszego węzła naszego obiektu poprzez kliknięcie w odpowiedni punkt na mapie. Następnie można rysować obiekt, przeciągając myszkę i kolejno klikając, co tworzy kolejne węzły połączone w drogę. Aby zakończyć rysowanie obiektu należy dwa razy szybko kliknąć lewym klawiszem myszki. Aby wrysować obiekt "obszarowy", a nie "liniowy" (np. budynek) należy narysować "drogę zamkniętą" - to znaczy obrysować obiekt, tak aby ostatni węzeł był powiązany z pierwszym. Dodanie opisu: Po wrysowaniu obiekt jest zaznaczony na czerwono, co znaczy że jest aktualnie aktywny do dalszej edycji. Jeśli wrysowujemy obiekt często występujący na mapie (np: drogę, czy sklep), to możemy go szybko opisać z użyciem gotowego szablonu. Lista szablonów dostępna jest po kliknięciu w górnym menu na "szablony". Po wybraniu odpowiedniego włącza się automatycznie pole dialogowe, które umożliwia wpisanie danych dotyczących tego obiektu. Po kliknięciu "OK" obiektowi są przypisywane automatycznie odpowiednie tagi i ich parametry, które ew. można poprawić przy pomocy okna "właściwości" z prawej strony.

Uwaga Częstym błędem początkujących - szczególnie jeśli chodzi o drogi - jest nie związywanie ich z wcześniej wrysowanymi. Związanie to - zwane w OSM relacją - tworzy się przez umieszczenie węzła na skrzyżowaniu lub połączeniu dwóch lub więcej obiektów. Rysując nową drogę, przecinającą już istniejącą należy jeden z węzłów narysować na starej drodze, co utworzy skrzyżowanie. Uwaga Rysujmy tylko takie obiekty, które wiemy, że na pewno istnieją - jeśli byliśmy na miejscu i mamy własny ślad GPS - dobrym pomysłem jest rysowanie po tymże śladzie, choć warto zawsze uwzględniać też cudze ślady i podkłady zdjęć satelitarnych. Aby wrysować obiekt, nie musimy o nim wszystkiego wiedzieć – np. możemy wrysować budynek, nie wiedząc jaką pełni funkcję i oznaczając go tagiem "building".

Na koniec rysowania należy kliknąć ikonkę ze strzałką do góry – spowoduje to zapisanie naszych zmian na serwerze OSM.

Główne podkłady których można używać w Polsce Ważne! Pamiętaj że wszystkie podkłady z Geoportal nie wymagają nigdy kalibracji, natomiast inne mogę być przesunięte i jej wymagać 1. Geoportal 2: Ortofotomapa (zdjęcia lotnicze)

2. WMS mapy.geoportal.gov.pl – budynki Informacja! Można korzystać zarówno w Tracer2 lub dodać jako podkład z którego widać kolory/rodzaje budynków Link do najaktualniejszego obecnie podkładu z budynkami w całej Polsce: http://mapy.geoportal.gov.pl/wss/service/pub/guest/kompozycjaG2_TBD_WMS/MapServer/WMSServer?FORMAT=image/gif&VERSION=1.1.1&SERVICE=WMS&REQUEST=GetMap&LAYERS=Bud_A&STYLES=&TRANSPARENT=TRUE&SRS={proj}&WIDTH={width}&HEIGHT={height}&BBOX={bbox}{header(User-Agent,Mozilla/5.0 (JOSM)}

3. WMS mapy.geoportal.gov.pl – woda

Ważne! Woda z tego podkładu często jest naniesiona gorzej od już istniejącej lub niepoprawnie. Jednak może ona ułatwić nieco sprawdzanie miejsc w których np. cieki wodne nie zostały naniesione. Tak czy inaczej należy sprawdzać dokładny przebieg rzek z podkładu ISOK.

Informacja! Można korzystać zarówno w Tracer2 lub dodać jako podkład z którego widać cieki wodne, zbiorniki itd. Link do najaktualniejszego obecnie podkładu z ciekami wodnymi i terenami wodnymi w całej Polsce: wms:http://mapy.geoportal.gov.pl/wss/service/pub/guest/kompozycjaG2_TBD_WMS/MapServer/WMSServer?FORMAT=image/png&VERSION=1.1.1&SERVICE=WMS&REQUEST=GetMap&LAYERS=RzekKanal_L,CiekOkr_L,RzekiEt,Woda_A&STYLES=&TRANSPARENT=TRUE&SRS={proj}&WIDTH={width}&HEIGHT={height}&BBOX={bbox}{header(User-Agent,Mozilla/5.0 (JOSM)}

4. sdi.gdos.gov.pl: Pomniki Przyrody

Link do najaktualniejszego obecnie podkładu z pomnikami przyrody w całej Polsce: