| | 1 | [[TranslatedPages]] |
| | 2 | |
| | 3 | |
| | 4 | = MapWithAI = |
| | 5 | Consente l'utilizzo dei dati MapWithAI in JOSM. |
| | 6 | == Caratteristiche == #Features |
| | 7 | * Located in **[wikitr:/Help/Action/Download Download Data]**: Download arbitrary data (non-cropped at this time) with the `Download from MapWithAI API` checkbox -- ''note that you cannot download multiple MapWithAI layers'' |
| | 8 | * Located in **[wikitr:/Help/Menu/Data data menu]**: |
| | 9 | * **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). |
| | 10 | {{{#!comment |
| | 11 | * **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. |
| | 12 | }}} |
| | 13 | * **MapWithAI: Add selected data**: Add the selected data from the MapWithAI data layer to a OSM Data Layer |
| | 14 | * **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). |
| | 15 | * [#RemoteControl Remote Control] + [#UploadHooks Upload Hooks] |
| | 16 | * Map paint style: |
| | 17 | * Automatically added by the plugin |
| | 18 | * Can be automatically toggled on/off with the `MapWithAI` layer (this requires the `MapWithAI` plugin) |
| | 19 | * Can show `new`, `modified`, or `pre-existing` MapWithAI data (depends upon the `source` tag). |
| | 20 | * Live counter of objects added with `MapWithAI` |
| | 21 | * Preferences |
| | 22 | * Set MapWithAI url(s) |
| | 23 | * Choose whether or not MapWithAI automatically switches layers |
| | 24 | * Choose how many features you want to add per action |
| | 25 | * 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) |
| | 26 | * Change tags ''([wikitr:/Help/ExpertMode expert mode] only)'' that you want to be replaced. For example, `highway=residential` can become `disused:highway=road`. ''This replacement only occurs during download.'' |
| | 27 | {{{#!comment |
| | 28 | Access MapWithAI/RapiId data for arbitrary regions in [wikitr:/Help/Action/Download Download Data] with the new ''with the `Download from MapWithAI API'' tab. |
| | 29 | To download for the current working area simply use ''MapWithAI: Download data'' in the [wikitr:/Help/Menu/Data Data menu]. |
| | 30 | |
| | 31 | Add selected objects from the MapWithAI layer to the OSM data layer with ''MapWithAI: Add selected data' in the Data menu. |
| | 32 | Can automatically activate the OSM data layer after adding. |
| | 33 | Can select unlimited number of objects. |
| | 34 | |
| | 35 | * [#Remotecontrol Remote Control] |
| | 36 | * [/Styles/MapWithAI PaintStyle] |
| | 37 | * added by the plugin |
| | 38 | |
| | 39 | * Can show `new`, `modified`, or `pre-existing` MapWithAI data (depends upon the `source` tag). |
| | 40 | * Live counter of objects added with `MapWithAI` |
| | 41 | * Choose how many features you want to add per action |
| | 42 | * Choose whether or not to merge buildings with address nodes (note: ) |
| | 43 | * Change tags ''([wikitr:/Help/ExpertMode expert mode] only)'' that you want to be replaced. For example, `highway=residential` can become `disused:highway=road`. |
| | 44 | }}} |
| | 45 | |
| | 46 | == Installazione |
| | 47 | === Mandatory |
| | 48 | 1. see [wikitr:/Help/Preferences/Plugins Preferences > Plugins] for details. |
| | 49 | === Paintstyle (Plugin should automatically add and enable it) |
| | 50 | 1. Start JOSM. |
| | 51 | 1. Open JOSM Preferences. |
| | 52 | 1. Go to [wikitr:/Help/Preferences/MapPaintPreference Map Paint Styles] |
| | 53 | 1. Add `MapWithAI` from the `Available style` list. |
| | 54 | 1. Press OK. |
| | 55 | == Basic Usage ==#BasicUsage |
| | 56 | 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. |
| | 57 | 1. Prepare the area of interest as usual by downloading OSM data and choosing a background imagery. |
| | 58 | 1. Download data from MapWithAI by going to the `Data` -> `MapWithAI: Download Data`. The default keyboard shortcut is **`Ctrl+R`** (`Cmd+R` on Mac). |
| | 59 | \\ |
| | 60 | [[Image(GetData.png, alt=Download Data, center, 80%, link=)]]\\ |
| | 61 | \\ |
| | 62 | This simply uses the OSM data boundaries for the MapWithAI download too.\\ |
| | 63 | If several data layers are loaded, a dialog will ask from which layer the data boundaries should give the target for the MapWithAI download. \\ |
| | 64 | MapWithAI holds all of its data in one single layer. |
| | 65 | {{{#!comment |
| | 66 | This is dependent upon configured URLs (defaults to MapWithAI). |
| | 67 | }}} |
| | 68 | |
| | 69 | 3. Switch to the `MapWithAI` layer if it is not already activated. |
| | 70 | 3. Select objects to add to the topmost OSM data layer. |
| | 71 | 3. Add the selected objects by going to `Data` -> `MapWithAI: Add selected data` (default keyboard shortcut is **`Shift+A`**). |
| | 72 | |
| | 73 | [[Image(SaveData.png, alt=Add selected data, center, 80%, link=)]] |
| | 74 | == Advanced Usage == |
| | 75 | |
| | 76 | The ''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). |
| | 77 | |
| | 78 | === Preferences === |
| | 79 | |
| | 80 | ||= Preference =||= Explanation =||= Expert Mode =|| |
| | 81 | || API URLs || URLs for MapWithAI service (if blank, resets to default after JOSM restart) || no || |
| | 82 | || Automatically switch layers || When adding data switch layers automatically (default `yes`) || no || |
| | 83 | || Maximum features (add) || The maximum number of objects that can be selected in the MapWithAI Layer (default `5`) || no || |
| | 84 | || 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 || |
| | 85 | || Replacement tags || Table of keys to replace (default is empty) || yes || |
| | 86 | |
| | 87 | The table of replacement tags has `Key` and `Value` columns in the format of `key=TAG=VALUE` and `value=TAG=VALUE`, for example: |
| | 88 | |
| | 89 | [[Image(TagReplacement.png, alt=Add Tag, center, 80%,link=)]] |
| | 90 | |
| | 91 | Note that you can remove a tag by using `TAG=VALUE` for the original (`key` in the table) and `TAG=` for the replacement (`value` in the table). |
| | 92 | |
| | 93 | MapWithAI has an own tab in the Plugins register in the JOSM Preferences dialog. |
| | 94 | |
| | 95 | [[Image(MapWithAIPreferencePanel.png, alt=MapWithAI Preferences, center, 80%)]] |
| | 96 | |
| | 97 | === Controllo remoto === #RemoteControl |
| | 98 | Se JOSM è in esecuzione con il controllo remoto abilitato e il plugin MapWithAI è installato, puoi andare su http://localhost:8111/features?q=mapwithai . |
| | 99 | |
| | 100 | Il controllo remoto influisce ''soltanto'' sul layer MapWithAI corrente. |
| | 101 | |
| | 102 | * Scaricare dati per i livelli correnti http://localhost:8111/mapwithai |
| | 103 | * Impostare una bbox per scaricare i dati http://localhost:8111/mapwithai?bbox=longitude1,latitude1,longitude2,latitude2 |
| | 104 | * Impostare un URL arbitrario http://localhost:8111/mapwithai?url=STRING |
| | 105 | * Impostare numero massimo di oggetti da aggiungere in ogni azione http://localhost:8111/mapwithai?max_obj=INT |
| | 106 | * Impostare il cambio livello automatico http://localhost:8111/mapwithai?switch_layer=BOOLEAN |
| | 107 | * Impostare un ritaglio di una bbox http://localhost:8111/mapwithai?crop_bbox=longitude1,latitude1,longitude2,latitude2 |
| | 108 | |
| | 109 | === Etichette dei Changeset === #ChangesetTags |
| | 110 | * `mapwithai`: Conteggio degli oggetti OSM aggiunti e ancora presenti nel layer MapWithAI (divisioni ed eliminazioni potrebbero rendere questo dato impreciso). |
| | 111 | * `mapwithai:options`: Un elenco di opzioni non predefinite separate da punto e virgola (`;`): |
| | 112 | * `versione`: La versione del plugin MapWithAI. Aggiunto nel caso ci sia un bug grave in modo che possa essere inserito nella blacklist. |
| | 113 | * `task`: Il riquadro di delimitazione di un'attività, se ne viene rilevato uno. |
| | 114 | * `maxadd`: Numero massimo di oggetti MapWithAI che potevano essere aggiunti per operazione. `<1` indica che l'utente è stato in grado di aggiungere un numero qualsiasi di oggetti (potrebbe indicare un'importazione non documentata). |
| | 115 | * `url`: Mostra gli URL non predefiniti. Sempre l'ultimo `mapwithai:option`. |
| | 116 | |
| | 117 | === Impostazioni Avanzate === #AdvancedSettings |
| | 118 | * `mapwithai.conflation.simplifyway` -- soglia in base alla quale determinare se una way potrebbe dover essere semplificata. Per impostazione predefinita è `0.5`. |
| | 119 | * `mapwithai.conflation.simplifywaynodepercentagerequired` -- La percentuale di nodi arrivati alla quale all'utente viene chiesto se il percorso debba essere semplificato. Il valore predefinito è `20` (percento). |
| | 120 | |
| | 121 | === Compilazione === |
| | 122 | [https://gitlab.com/gokaart/JOSM_MapWithAI/wikis/Building-and-Testing Building and Testing] |
| | 123 | |
| | 124 | |
| | 125 | ---- |
| | 126 | Torna a [wikitr:/Plugins#JOSMdocu Plugin Help] \\ |
| | 127 | Torna a [wikitr:/Help Main Help] |
