= Installation
== Mandatory
1. Start JOSM
2. Open JOSM Preferences
3. Go to `Plugins` (the plug going into a socket)

![JOSM Preferences](uploads/9bed2297cb7f88f131c4d219c8d4693f/image.png)

4. Search for `mapwithai` (`rapid` also works)
5. Install the `MapWithAI` Plugin
6. Press OK

![Plugin Preferences](uploads/4b2d2fe0e98bc0f2650e3457643c73ad/image.png)
== Paintstyle (Plugin should automatically add and enable it)
1. Start JOSM
2. Open JOSM Preferences
3. Go to `Map Settings` (the globe with a grid over it)
4. Go to `Map Paint Styles`
5. Add `MapWithAI` from the `Available style` list
6. Press OK
= Usage
== Basic Usage
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.
1. Download an area of interest (either through a tasking manager or through the standard download window)
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).

![Download Data](uploads/10dd8380885cf8eeb6cd2d43cdc59cb7/image.png)

3. Switch to the `MapWithAI` layer if it is not already selected
4. Select an object or objects to add
5. Add the object by going to `Data` -> `MapWithAI: Add selected data` (default keyboard shortcut is `shift` + `a`)

![Add selected data](uploads/a35c937c61d5e0bd8373a95e997589de/image.png)
== Advanced Usage
=== Preferences
MapWithAI Preferences are currently under JOSM Preferences -> `Plugins` -> `MapWithAI`.

||= Preference =||= Explanation =||= Expert Mode =||
|| API URLs || URLs for MapWithAI service (if blank, resets to default after JOSM restart) || no ||
|| Automatically switch layers || if checked, when adding data switch layers automatically (default `yes`) || no ||
|| Maximum features (add) || The maximum number of features that can be added from the MapWithAI Layer in one action (default `5`) || no ||
|| Merge address nodes and buildings || Merges buildings added from the MapWithAI layer with building nodes (default `yes`) || no ||
|| Table of replacement tags || Table of keys to replace (default is empty) || yes ||

The table of replacement tags tags `key` and `value` entries in the format of `key=TAG=VALUE` and `value=TAG=VALUE`, for example:
![Add Tag](uploads/44b7d33ab3754d9b43802efa98f78046/image.png)
![MapWithAI Preferences](uploads/a9ce1004acfcba97196497b02d61a53e/image.png)

=== Remote control
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 .

Remote control ''only'' affects the current MapWithAI layer.

* Downloading data for current layers http://localhost:8111/mapwithai
* Setting a bbox to download data http://localhost:8111/mapwithai?bbox=longitude1,latitude1,longitude2,latitude2
* Setting an arbitrary URL http://localhost:8111/mapwithai?url=STRING
* Setting max objects to add in each action http://localhost:8111/mapwithai?max_obj=INT
* Setting autoswitch layer http://localhost:8111/switch_layer=BOOLEAN
* Setting a crop bbox http://localhost:8111/crop_bbox=longitude1,latitude1,longitude2,latitude2

= Building
[https://gitlab.com/gokaart/JOSM_MapWithAI/wikis/Building-and-Testing Building and Testing]