Changes between Version 7 and Version 8 of Help/Plugin/MapWithAI


Ignore:
Timestamp:
2020-03-10T00:17:54+01:00 (5 years ago)
Author:
Hb---
Comment:

Feature section still way to long

Legend:

Unmodified
Added
Removed
Modified

  • Help/Plugin/MapWithAI

    v7 v8  
    1 = Features
     1= MapWithAI =
     2Allows the use of MapWithAI data in JOSM.
     3== Features == #Features
    24* Located in **[[Action/Download|Download Data]]**: Download arbitrary data (non-cropped at this time) in the `Download from MapWithAI API` tab -- ''note that you cannot download multiple MapWithAI layers''
    35* Located in **[[Menu/Data|data menu]]**
    46 * **MapWithAI: Download data**: Download MapWithAI data from the current download area (if more than one layer, a dialog will ask for a layer to be selected). This is dependent upon configured URLs (defaults to MapWithAI).
     7{{{#!comment
    58 * **MapWithAI: Download arbitrary data** ''([wikitr:/Help/ExpertMode expert mode] only)'': Download MapWithAI data inside an arbitrary bounding box, optionally cropping to the bounding box. The bounding box defaults to the current map view. This is also dependent upon configured URLs.
     9}}}
    610 * **MapWithAI: Add selected data**: Add the selected data from the MapWithAI data layer to a OSM Data Layer
    711 * **MapWithAI: Attempt to merge potentially duplicate ways** ''([wikitr:/Help/ExpertMode expert mode] only)'': Attempt to merge potentially duplicate ways. Done automatically for MapWithAI data, but is available for other uses (may or may not work as expected).
    8 * [#Remotecontrol Remote Control]
    9 * Upload Hooks
    10  * `mapwithai`: The count of OSM objects added and still present from the MapWithAI layer (splits and deletions may cause this to be inaccurate)
    11  * `mapwithai:options`: A semi-colon (`;`) separated list of non-default options
    12   * `version`: The version of the MapWithAI plugin. Added in case there is a severe bug so it can be blacklisted.
    13   * `task`: The bounding box for a task, if one is detected
    14   * `maxadd`: The maximum number of MapWithAI objects that are permitted to be added per operation. `<1` allows any number of objects to be added.
    15   * `url`: Shows non-default urls. Always the last `mapwithai:option`.
    16 * [/Styles/MapWithAI PaintStyle]
     12* [#RemoteControl Remote Control] + [#UploadHooks Upload Hooks]
     13* Map paint style
    1714 * Automatically added by the plugin
    1815 * Can be automatically toggled on/off with the `MapWithAI` layer (this requires the `MapWithAI` plugin)
    1916 * Can show `new`, `modified`, or `pre-existing` MapWithAI data (depends upon the `source` tag).
    2017* Live counter of objects added with `MapWithAI`
    21 * [/wiki/Help/Preferences/Plugins Preferences]
     18* Preferences
    2219 * Set MapWithAI url(s)
    2320 * Choose whether or not MapWithAI automatically switches layers
    … …  
    2522 * Choose whether or not to merge buildings with address nodes (note: this only applies to buildings that will have one ''and only one'' address inside it)
    2623 * Change tags ''([wikitr:/Help/ExpertMode expert mode] only)'' that you want to be replaced. For example, `highway=residential` can become `disused:highway=road`.
    27 = Installation
    28 == Mandatory
     24{{{#!comment
     25Access MapWithAI/RapiId data for arbitrary regions in [wikitr:/Help/Action/Download Download Data] with the new ''with the `Download from MapWithAI API'' tab.
     26To download for the current working area simply use ''MapWithAI: Download data'' in the [wikitr:/Help/Menu/Data Data menu].
     27
     28Add selected objects from the MapWithAI layer to the OSM data layer with ''MapWithAI: Add selected data' in the Data menu.
     29Can automatically activate the OSM data layer after adding.
     30Can select unlimited number of objects.
     31
     32* [#Remotecontrol Remote Control]
     33* [/Styles/MapWithAI PaintStyle]
     34 * added by the plugin
     35
     36 * Can show `new`, `modified`, or `pre-existing` MapWithAI data (depends upon the `source` tag).
     37* Live counter of objects added with `MapWithAI`
     38 * Choose how many features you want to add per action
     39 * Choose whether or not to merge buildings with address nodes (note: )
     40 * Change tags ''([wikitr:/Help/ExpertMode expert mode] only)'' that you want to be replaced. For example, `highway=residential` can become `disused:highway=road`.
     41}}}
     42
     43== Installation
     44=== Mandatory
    29451. see [[Help/Preferences/Plugins]] for details)
    30 == Paintstyle (Plugin should automatically add and enable it)
     46=== Paintstyle (Plugin should automatically add and enable it)
    31471. Start JOSM
    32482. Open JOSM Preferences
    … …  
    35515. Add `MapWithAI` from the `Available style` list
    36526. Press OK
    37 = Usage
    3853== Basic Usage ==#BasicUsage
    3954Please 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.
    40 1. Download an area of interest (either through a tasking manager or through the standard download window)
    41 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).
     551. Prepare the area of interest as usual by downloading OSM data and choosing a background imagery.
     562. Download data from MapWithAI by going to the `Data` -> `MapWithAI: Download Data`. The default keyboard shortcut is **`Ctrl+R`** (`Cmd+R` on Mac).
     57 \\
     58 [[Image(GetData476.png, alt=Download Data, center, 80%, link=)]]\\
     59 \\
     60 This simply uses the OSM data boundaries for the MapWithAI download too.
     61 If several data layers are loaded, a dialog will ask from which layer the data boundaries should give the target for the MapWithAI download.
     62 MapWithAI holds all of its data in one single layer.
     63{{{#!comment
     64 This is dependent upon configured URLs (defaults to MapWithAI).
     65}}}
    4266
    43 [[Image(GetData.png, alt=Download Data, center, 80%)]]
     673. Switch to the `MapWithAI` layer if it is not already activated.
     684. Select objects to add to the topmost OSM data layer.
     695. Add the selected objects by going to `Data` -> `MapWithAI: Add selected data` (default keyboard shortcut is **`Shift+A`**)
    4470
    45 3. Switch to the `MapWithAI` layer if it is not already selected
    46 4. Select an object or objects to add
    47 5. Add the object by going to `Data` -> `MapWithAI: Add selected data` (default keyboard shortcut is `shift` + `a`)
     71[[Image(SaveData476.png, alt=Add selected data, center, 80%, link=)]]
     72== Advanced Usage ==
    4873
    49 [[Image(SaveData.png, alt=Add selected data, center, 80%)]]
    50 == Advanced Usage
    51 === Preferences
    52 MapWithAI Preferences are currently under JOSM Preferences -> `Plugins` -> `MapWithAI`.
     74The ''MapWithAI: Attempt to merge potential duplicate ways'' is available in [wikitr:/Help/ExpertMode expert mode] only. It attempts to merge potentially duplicate ways. Done automatically for MapWithAI data, but is available for other uses (may or may not work as expected).
     75
     76=== Preferences ===
    5377
    5478||= Preference =||= Explanation =||= Expert Mode =||
    5579|| API URLs || URLs for MapWithAI service (if blank, resets to default after JOSM restart) || no ||
    56 || Automatically switch layers || if checked, when adding data switch layers automatically (default `yes`) || no ||
    57 || Maximum features (add) || The maximum number of features that can be added from the MapWithAI Layer in one action (default `5`) || no ||
    58 || Merge address nodes and buildings || Merges buildings added from the MapWithAI layer with building nodes (default `yes`) || no ||
    59 || Table of replacement tags || Table of keys to replace (default is empty) || yes ||
     80|| Automatically switch layers || When adding data switch layers automatically (default `yes`) || no ||
     81|| Maximum features (add) || The maximum number of objects that can be selected in the MapWithAI Layer (default `5`) || no ||
     82|| Merge address nodes and buildings || Merge buildings added from the MapWithAI layer with one single existing address node inside the building on the OSM layer (default `yes`) || no ||
     83|| Replacement tags || Table of keys to replace (default is empty) || yes ||
    6084
    61 The table of replacement tags tags `key` and `value` entries in the format of `key=TAG=VALUE` and `value=TAG=VALUE`, for example:
     85The table of replacement tags has `Key` and `Value` columns in the format of `key=TAG=VALUE` and `value=TAG=VALUE`, for example:
    6286
    63 [[Image(TagReplacement.png, alt=Add Tag, center, 80%)]]
     87[[Image(TagReplacement476.png, alt=Add Tag, center, 80%,link=)]]
     88
     89MapWithAI has an own tab in the Plugins register in the JOSM Preferences dialog.
    6490
    6591[[Image(MapWithAIPreferencePanel.png, alt=MapWithAI Preferences, center, 80%)]]
    6692
    67 === Remote control
    68 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 .
     93=== Remote control === #RemoteControl
     94If JOSM is running with remote control enabled and the MapWithAI plugin is installed, you can go to http://localhost:8111/features?q=mapwithai .
    6995
    7096Remote control ''only'' affects the current MapWithAI layer.
    … …  
    77103* Setting a crop bbox http://localhost:8111/mapwithai?crop_bbox=longitude1,latitude1,longitude2,latitude2
    78104
    79 = Building
     105=== Upload Hooks === #UploadHooks
     106 * `mapwithai`: The count of OSM objects added and still present from the MapWithAI layer (splits and deletions may cause this to be inaccurate)
     107 * `mapwithai:options`: A semi-colon (`;`) separated list of non-default options
     108  * `version`: The version of the MapWithAI plugin. Added in case there is a severe bug so it can be blacklisted.
     109  * `task`: The bounding box for a task, if one is detected
     110  * `maxadd`: The maximum number of MapWithAI objects that are permitted to be added per operation. `<1` allows any number of objects to be added.
     111  * `url`: Shows non-default urls. Always the last `mapwithai:option`.
     112
     113
     114=== Building ===
    80115[https://gitlab.com/gokaart/JOSM_MapWithAI/wikis/Building-and-Testing Building and Testing]