Installation

Mandatory

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

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

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

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)

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:

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

​Building and Testing