| | 1 | = Installation |
| | 2 | == Mandatory |
| | 3 | 1. Start JOSM |
| | 4 | 2. Open JOSM Preferences |
| | 5 | 3. Go to `Plugins` (the plug going into a socket) |
| | 6 | |
| | 7 |  |
| | 8 | |
| | 9 | 4. Search for `mapwithai` (`rapid` also works) |
| | 10 | 5. Install the `MapWithAI` Plugin |
| | 11 | 6. Press OK |
| | 12 | |
| | 13 |  |
| | 14 | == Paintstyle (Plugin should automatically add and enable it) |
| | 15 | 1. Start JOSM |
| | 16 | 2. Open JOSM Preferences |
| | 17 | 3. Go to `Map Settings` (the globe with a grid over it) |
| | 18 | 4. Go to `Map Paint Styles` |
| | 19 | 5. Add `MapWithAI` from the `Available style` list |
| | 20 | 6. Press OK |
| | 21 | = Usage |
| | 22 | == Basic Usage |
| | 23 | Please note that the screen shots were taken with `Expert Mode` checked in JOSM preferences. You may not see all the actions available without that check, the missing actions may be buggy or for a niche audience. |
| | 24 | 1. Download an area of interest (either through a tasking manager or through the standard download window) |
| | 25 | 2. Download data from MapWithAI by going to `Data` -> `MapWithAI: Download Data` (default keyboard shortcut is `ctrl` + `r` / `cmd` + `r`, will conflict with a `LiveGPSPlugin` shortcut). |
| | 26 | |
| | 27 |  |
| | 28 | |
| | 29 | 3. Switch to the `MapWithAI` layer if it is not already selected |
| | 30 | 4. Select an object or objects to add |
| | 31 | 5. Add the object by going to `Data` -> `MapWithAI: Add selected data` (default keyboard shortcut is `shift` + `a`) |
| | 32 | |
| | 33 |  |
| | 34 | == Advanced Usage |
| | 35 | === Preferences |
| | 36 | MapWithAI Preferences are currently under JOSM Preferences -> `Plugins` -> `MapWithAI`. |
| | 37 | |
| | 38 | ||= Preference =||= Explanation =||= Expert Mode =|| |
| | 39 | || API URLs || URLs for MapWithAI service (if blank, resets to default after JOSM restart) || no || |
| | 40 | || Automatically switch layers || if checked, when adding data switch layers automatically (default `yes`) || no || |
| | 41 | || Maximum features (add) || The maximum number of features that can be added from the MapWithAI Layer in one action (default `5`) || no || |
| | 42 | || Merge address nodes and buildings || Merges buildings added from the MapWithAI layer with building nodes (default `yes`) || no || |
| | 43 | || Table of replacement tags || Table of keys to replace (default is empty) || yes || |
| | 44 | |
| | 45 | The table of replacement tags tags `key` and `value` entries in the format of `key=TAG=VALUE` and `value=TAG=VALUE`, for example: |
| | 46 |  |
| | 47 |  |
| | 48 | |
| | 49 | === Remote control |
| | 50 | For current features, if JOSM is running with remote control enabled and the MapWithAI plugin is installed, you can go to http://localhost:8111/features?q=mapwithai . |
| | 51 | |
| | 52 | Remote control ''only'' affects the current MapWithAI layer. |
| | 53 | |
| | 54 | * Downloading data for current layers http://localhost:8111/mapwithai |
| | 55 | * Setting a bbox to download data http://localhost:8111/mapwithai?bbox=longitude1,latitude1,longitude2,latitude2 |
| | 56 | * Setting an arbitrary URL http://localhost:8111/mapwithai?url=STRING |
| | 57 | * Setting max objects to add in each action http://localhost:8111/mapwithai?max_obj=INT |
| | 58 | * Setting autoswitch layer http://localhost:8111/switch_layer=BOOLEAN |
| | 59 | * Setting a crop bbox http://localhost:8111/crop_bbox=longitude1,latitude1,longitude2,latitude2 |
| | 60 | |
| | 61 | = Building |
| | 62 | [https://gitlab.com/gokaart/JOSM_MapWithAI/wikis/Building-and-Testing Building and Testing] |
