Skip to content

Commit

Permalink
Merge branch 'praszuk/docs/update-readme-building-use'
Browse files Browse the repository at this point in the history
  • Loading branch information
praszuk committed Jan 10, 2025
2 parents ba131ea + 73f8b2e commit cf7cb82
Show file tree
Hide file tree
Showing 2 changed files with 12 additions and 10 deletions.
8 changes: 5 additions & 3 deletions README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,12 +42,14 @@ It communicates with the [PLBuildings server](https://github.com/praszuk/josm-pl
1. Install plugin in JOSM (same as other plugins via JOSM plugin settings).
2. Open ToggleDialog: On the left sidebar should be visible icon with houses (logo of this plugin) – click it. On the right side should appear toggle dialog same as below on the GIF.
3. Select Import mode and Data source – it will be remembered, but I recommend to keep dialog always open at importing to easily switching and keep looking on latest import.
4. Move the mouse cursor on a visible building and press `CTRL + SHIFT + 1`.
5. If you select other building before pressing shortcut combination, then it will use _Replace Geometry_ feature (from [utilsplugin2](https://wiki.openstreetmap.org/wiki/JOSM/Plugins/utilsplugin2)).
4. Move the mouse cursor on a visible building and press `CTRL + SHIFT + 1` – it will trigger building import. If you select other building before pressing shortcut combination, then it will use _Replace Geometry_ feature (from [utilsplugin2](https://wiki.openstreetmap.org/wiki/JOSM/Plugins/utilsplugin2))
to replace old shape and tags with the new one. It can show the tag conflict dialog window.

Note: If shortcut doesn't work (it may happen) or you want to just change it, go to the JOSM Keyboard Shortcut Settings and type `plbuildings`,
then change it for `Download building` .
then change it for `Download building`.

**Important! Every import should be verified!** There is no such thing as perfect data, so occasional minor errors may occur, such as in the building type or the number of levels. Additionally, a building might serve a different [functional purpose](https://wiki.openstreetmap.org/wiki/Key:building:use).


Simple building import:
![Simple building import](media/simple_import.gif)
Expand Down
14 changes: 7 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ Wtyczka komunikuje się z [serwerem PLBuildings](https://github.com/praszuk/josm

## Funkcjonalności
- Prosty import budynku w miejscu kursora myszy.
- Zastępowanie geometrii jeśli stary budynek jest zaznaczony.
- Zastępowanie geometrii, jeśli stary budynek jest zaznaczony.
- Aktualizacja tagów z możliwością pominięcia konfliktów _częstych tagów_ np. takich jak z `building=yes` na `building=house` bez wyświetlania okna dialogowego z konfliktem tagów.
- Łączenie budynku z istniejącym budynkiem. Sąsiadujące węzły będą współdzielone między budynkami – zapobiega to nakładającym/duplikującym się węzłom.
- Zapobieganie zduplikowanych importów.
- Proste statystyki (zliczanie zaimportowanych/podmienionych budynków).
- Proste statystyki (zliczalnie zaimportowanych i podmienionych budynków).
- Wielojęzyczność z użyciem i18n (polski i angielski).
- Wstępne sprawdzanie budynków przed zastąpieniem:
- Szukanie wartości "survey".
Expand Down Expand Up @@ -41,20 +41,20 @@ Wtyczka komunikuje się z [serwerem PLBuildings](https://github.com/praszuk/josm
## Jak z niej korzystać
1. Zainstaluj wtyczkę w JOSMie (tak jak każdą inną – przez ustawienia JOSMa).
2. Otwórz boczny panel (Toggle Dialog): Po lewej stronie powinna być widoczna ikonka z budynkami (logiem tej wtyczki) – klknij na nią. Po prawej stronie powinien otworzyć się boczny panel wtyczki taki jak na GIFie poniżej.
3. Wybierz tryb importu i źródło danych – zostanie to zapamiętane, ale rekomenduję aby zawsze mieć otwarty ten boczny panel dla łatwiejszej zmiany trybu/źródła i aby mieć na uwadze ostatni import.
4. Nakieruj kursor myszy na widoczny budynek i naciśnij `CTRL + SHIFT + 1`.
5. Jeśli przed wciśnięciem skrótu został zaznaczony inny budynek, zostanie użyta funkcja zamiany geometrii z pluginu [utilsplugin2](https://wiki.openstreetmap.org/wiki/JOSM/Plugins/utilsplugin2) w celu aktualizacji starego kształtu. Może to wyświetlić okno dialogowe konfliktów tagów.
3. Wybierz tryb importu i źródło danych – zostanie to zapamiętane, ale rekomenduję zawsze mieć otwarty boczny panel dla łatwiejszej zmiany trybu/źródła i aby mieć na uwadze ostatni import.
4. Nakieruj kursor myszy na widoczny budynek i naciśnij `CTRL + SHIFT + 1` – spowoduje to import budynku. Jeśli przed wciśnięciem skrótu został zaznaczony inny budynek, zostanie użyta funkcja zamiany geometrii z pluginu [utilsplugin2](https://wiki.openstreetmap.org/wiki/JOSM/Plugins/utilsplugin2) w celu aktualizacji starego kształtu. Może to wyświetlić okno dialogowe konfliktów tagów.

Uwaga: Jeśli skrót nie działa (może się tak zdarzyć) lub po prostu chcesz go zmienić na inny, wejdź w ustawienia skrótów w JOSMie i wpisz: `plbuildings`, następnie zmień skrót dla `Pobierz budynek`.
Notka: Jeśli skrót nie działa (może się tak zdarzyć) lub po prostu chcesz go zmienić na inny, wejdź w ustawienia skrótów w JOSMie i wpisz: `plbuildings`, następnie zmień skrót dla `Pobierz budynek`.

**UWAGA! Każdy import powinien zostać zweryfikowany!** Nie ma danych idealnych, stąd mogą się czasem pojawić drobne błędy związane np. z typem budynku lub liczbą pięter, ale również np. z budynkiem pełniącym inną [funkcję użytkową](https://wiki.openstreetmap.org/wiki/Pl:Key:building:use).

Prosty import budynku:
![Prosty import budynku](media/simple_import.gif)

Import z zamianą starej geometrii budynku:
![Import z zamianą starej geometrii budynku](media/import_with_replace.gif)

W celu wyświetlenia statystyk, otwórz: `Menu->Dane->Statystyki importowania budynków`
W celu wyświetlenia statystyk otwórz: `Menu->Dane->Statystyki importowania budynków`

Przykładowe statystyki:

Expand Down

0 comments on commit cf7cb82

Please sign in to comment.