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

[[Image(Preferences.png, alt=JOSM Preferences)]]

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

[[Image(Installation.png, alt=Plugin Preferences)]]
== 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).

[[Image(GetData.png, alt=Download Data)]]

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`)

[[Image(SaveData.png, alt=Add selected data)]]
== 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:

[[Image(TagReplacement.png, alt=Add Tag)]]

[[Image(MapWithAIPreferencePanel.png, alt=MapWithAI Preferences)]]

=== 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]