Changes between Version 10 and Version 29 of Help/RemoteControlCommands


Ignore:
Timestamp:
(multiple changes)
Author:
(multiple changes)
Comment:
(multiple changes)

Legend:

Unmodified
Added
Removed
Modified
  • Help/RemoteControlCommands

    v10 v29  
    44
    55== List of Commands ==
    6 
    76A complete list of commands and mandatory/optional parameters is shown at http://127.0.0.1:8111/ (when JOSM is running).
    87
    9 === {{{load_and_zoom}}} ===
     8=== {{{load_and_zoom}}} ===#load_and_zoom
    109Instructs JOSM to download a bounding box from the API, zoom to the downloaded area and optionally select one or more objects.
    1110{{{
     
    1312}}}
    1413where
    15 ||= **Parameter** =||= **Required/Optional** =||= **Meaning** =||
    16 || `bottom` || R || Minimum latitude ||
    17 || `top` || R || Maximum latitude ||
    18 || `left` || R || Minimum longitude ||
    19 || `right` || R || Maximum longitude ||
    20 || `new_layer` || O || If '''true''', downloads to a new layer ||
    21 || `layer_name` || O || Only valid when the data is loaded in a new layer; Gives JOSM a hint on how to name the layer ||
    22 || `layer_locked` || O || Only valid when the data is loaded in a new layer; If '''true''', new layer is [[Action/LockedLayer|locked]] ||
    23 || `download_policy` || O || Only valid when the data is loaded in a new layer; If '''never''' , download is [[Help/Action/BlockDownload|blocked]] ||
    24 || `upload_policy` || O || Only valid when the data is loaded in a new layer; If '''never''' or '''false''', upload is [[Help/Action/EncourageDiscourageUpload|blocked or discouraged]] ||
    25 || `addtags` || O || Optional parameter to add tags. The key and value is separated by "=" and multiple tags can be separated by a Pipe "|". See [#addtags details]. ||
    26 || `select` || O || Comma-separated list of objects that should be selected. Object specifiers are combinations of the words "way", "node", or "relation", and the numerical object id. Example: {{{select=way38473,node12399,node54646}}}. Since r13212 the special value **currentselection** let JOSM keep its previous selection. ||
    27 || `zoom_mode` || O || '''download''' | '''selection''', defaults to selection ||
    28 || `changeset_comment` || O || Comment of the changeset ||
    29 || `changeset_source` || O || Source of the changeset ||
    30 || `changeset_tags` || O || Optional parameter to add changeset tags. The key and value is separated by "=" and multiple tags can be separated by a Pipe "|". This command uses the same syntax as the [#addtags addtags] parameter. `changeset_comment` and `changeset_source` currently override the `comment` and `source` tags passed in this parameter, but this may change in the future. First available in r15316. ||
    31 || `search` || O || Search objects in the current data layer. See [wiki:/Help/Action/Search Search] ||
     14||= **Parameter** =||= **Required/ \\ Optional** =||= **Meaning** =||
     15|| `bottom` ||  R  || Minimum latitude ||
     16|| `top` ||  R  || Maximum latitude ||
     17|| `left` ||  R  || Minimum longitude ||
     18|| `right` ||  R  || Maximum longitude ||
     19|| `new_layer` ||  O  || If '''true''', downloads to a new layer. (Overwrites user preference, see #19308) ||
     20|| `layer_name` ||  O  || Only valid when the data is loaded in a new layer; Gives JOSM a hint on how to name the layer ||
     21|| `layer_locked` ||  O  || Only valid when the data is loaded in a new layer; If '''true''', new layer is [wikitr:/Help/Action/LockedLayer locked] ||
     22|| `download_policy` ||  O  || Only valid when the data is loaded in a new layer; If '''never''' , download is [wikitr:/Help/Action/BlockDownload blocked] ||
     23|| `upload_policy` ||  O  || Only valid when the data is loaded in a new layer; If '''never''' or '''false''', upload is [wikitr:/Help/Action/EncourageDiscourageUpload blocked or discouraged] ||
     24|| `addtags` ||  O  || Optional parameter to add tags. The key and value is separated by "=" and multiple tags can be separated by a Pipe "|". See [#addtags details]. ||
     25|| `select` ||  O  || Comma-separated list of objects that should be selected. Object specifiers are combinations of the words "way", "node", or "relation", and the numerical object id. Example: {{{select=way38473,node12399,node54646}}}. Since r13212 the special value **currentselection** let JOSM keep its previous selection. ||
     26|| `zoom_mode` ||  O  || '''download''' | '''selection''', defaults to selection ||
     27|| `changeset_comment` ||  O  || Comment of the changeset ||
     28|| `changeset_source` ||  O  || Source of the changeset ||
     29|| `changeset_hashtags` ||  O  || Hashtags of the changeset ''(since r13109)'' ||
     30|| `changeset_tags` ||  O  || Optional parameter to add changeset tags. The key and value is separated by "=" and multiple tags can be separated by a Pipe "|". This command uses the same syntax as the [#addtags addtags] parameter. `changeset_comment` and `changeset_source` currently override the `comment` and `source` tags passed in this parameter, but this may change in the future. ''(since r15316)'' ||
     31|| `search` ||  O  || Search objects in the current data layer. See [wikitr:/Help/Action/Search Search] ||
    3232
    3333==== Example ====
    34 
    3534Start JOSM (don't forget to enable the !RemoteControl feature), then click on:
    3635
     
    3837
    3938JOSM should now load an area in the German Schwarzwald and have the specified node selected.
     39
    4040
    4141=== {{{zoom}}} ===
     
    4747
    4848**Hint**: This command can also be used to select objects only. Just enter a small arbitrary area to the left..bottom entries and add the object list to the select= option.
     49
    4950=== {{{import}}} ===
    5051Instructs JOSM to download the specified OSM file and add it to the current data set.
     
    5354}}}
    5455where
    55 ||= **Parameter** =||= **Required/Optional** =||= **Meaning** =||
    56 || `url` || R || The Request URL, including patterns. Must be the last parameter, everything after "&url=" is interpreted as URL, even if it contains "&" characters. ||
    57 || `new_layer` || O || If '''true''', downloads to a new layer ||
    58 || `layer_name` || O || Only valid when the data is loaded in a new layer; Gives JOSM a hint on how to name the layer ||
    59 || `layer_locked` || O || Only valid when the data is loaded in a new layer; If '''true''', new layer is [[Action/LockedLayer|locked]] ||
    60 || `download_policy` || O || Only valid when the data is loaded in a new layer; If '''never''' , download is [[Help/Action/BlockDownload|blocked]] ||
    61 || `upload_policy` || O || Only valid when the data is loaded in a new layer; If '''never''' or '''false''', upload is [[Help/Action/EncourageDiscourageUpload|blocked or discouraged]] ||
     56||= **Parameter** =||= **Required/ \\ Optional** =||= **Meaning** =||
     57|| `url` ||  R  || The Request URL, including patterns. Must be the last parameter, everything after "&url=" is interpreted as URL, even if it contains "&" characters. ||
     58|| `new_layer` ||  O  || If '''true''', downloads to a new layer. (Overwrites user preference, see #19308) ||
     59|| `layer_name` ||  O  || Only valid when the data is loaded in a new layer; Gives JOSM a hint on how to name the layer ||
     60|| `layer_locked` ||  O  || Only valid when the data is loaded in a new layer; If '''true''', new layer is [wikitr:/Help/Action/LockedLayer locked] ||
     61|| `download_policy` ||  O  || Only valid when the data is loaded in a new layer; If '''never''' , download is [wikitr:/Help/Action/BlockDownload blocked] ||
     62|| `upload_policy` ||  O  || Only valid when the data is loaded in a new layer; If '''never''' or '''false''', upload is [wikitr:/Help/Action/EncourageDiscourageUpload blocked or discouraged] ||
     63|| `changeset_tags` ||  O  || Optional parameter to add changeset tags. The key and value is separated by "=" and multiple tags can be separated by a Pipe "|". This command uses the same syntax as the [#addtags addtags] parameter. First available in r16324. ||
    6264
    6365=== {{{load_data}}} ===
    64 (since version 1.6)
     66''(since version 1.6)''
     67
    6568Instruct JOSM to load OSM data, directly encoded in the URL, instead of coming from an external file. This is only suited for smaller data (some browsers limit the maximum URL length), but it is faster (since no download is required), and in many cases where dynamically generated data is needed, it's easier to generate.
    6669
     
    6972}}}
    7073where
    71 ||= **Parameter** =||= **Required/Optional** =||= **Meaning** =||
    72 || `data` || R || The XML data to load, this should be URL encoded in a way that also encodes the special characters &, = and ? to resp. %26, %3D and %3F. The JS [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent encodeUriComponent()] method provides this functionality out of the box. ||
    73 || `new_layer` || O || Chose to load the data in a new layer ||
    74 || `mime_type` || O || Mime type of the data, by default this is "application/x-osm+xml", which is currently the only supported mime type, but in the future other mime types could be supported ||
    75 || `layer_name` || O || Only valid when the data is loaded in a new layer; Gives JOSM a hint on how to name the layer ||
    76 || `layer_locked` || O || Only valid when the data is loaded in a new layer; If '''true''', new layer is [[Action/LockedLayer|locked]] ||
    77 || `download_policy` || O || Only valid when the data is loaded in a new layer; If '''never''' , download is [[Help/Action/BlockDownload|blocked]] ||
    78 || `upload_policy` || O || Only valid when the data is loaded in a new layer; If '''never''' or '''false''', upload is [[Help/Action/EncourageDiscourageUpload|blocked or discouraged]] ||
     74||= **Parameter** =||= **Required/ \\ Optional** =||= **Meaning** =||
     75|| `data` ||  R || The XML data to load, this should be URL encoded in a way that also encodes the special characters &, = and ? to resp. %26, %3D and %3F. The JS [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent encodeUriComponent()] method provides this functionality out of the box. ||
     76|| `new_layer` ||  O  || Choose to load the data in a new layer. (Overwrites user preference, see #19308) ||
     77|| `mime_type` ||  O || Mime type of the data, by default this is "application/x-osm+xml", which is currently the only supported mime type, but in the future other mime types could be supported ||
     78|| `layer_name` ||  O || Only valid when the data is loaded in a new layer; Gives JOSM a hint on how to name the layer ||
     79|| `layer_locked` ||  O || Only valid when the data is loaded in a new layer; If '''true''', new layer is [wikitr:/Help/Action/LockedLayer locked] ||
     80|| `download_policy` ||  O || Only valid when the data is loaded in a new layer; If '''never''' , download is [wikitr:/Help/Action/BlockDownload blocked] ||
     81|| `upload_policy` ||  O || Only valid when the data is loaded in a new layer; If '''never''' or '''false''', upload is [wikitr:/Help/Action/EncourageDiscourageUpload blocked or discouraged] ||
    7982
    8083=== {{{open_file }}} ===
     
    8588}}}
    8689where
    87 ||= **Parameter** =||= **Required/Optional** =||= **Meaning** =||
    88 || `filename` || R || The local file to open in JOSM (Ie: /tmp/test.osm) ||
    89 
    90 
    91 === {{{imagery}}} ===
     90||= **Parameter** =||= **Required/ \\ Optional** =||= **Meaning** =||
     91|| `filename` ||  R || The local file to open in JOSM (Ie: /tmp/test.osm) ||
     92
     93
     94=== {{{imagery}}} ===#imagery
    9295Instructs JOSM to add an imagery (WMS/TMS) layer.
    9396{{{
     
    9598}}}
    9699where
    97 ||= **Parameter** =||= **Required/Optional** =||= **Meaning** =||
    98 || `url` || R || The Request URL, including patterns. Must be the last parameter, everything after "&url=" is interpreted as URL, even if it contains "&" characters.  ||
    99 || `title` || O || The display name of the layer ||
    100 || `type` || O || Type of the layer. Possible values are `wms`, `tms` and `bing` [[BR]] (since !RemoteControl Version 1.3) ||
    101 || `cookies` || O ||  ||
    102 || `min_zoom` || O || The minimum zoom level [[BR]] (since !RemoteControl Version 1.4) ||
    103 || `max_zoom` || O || The maximum zoom level. For higher scales, the images of the maximum level is enlarged [[BR]] (since !RemoteControl Version 1.4) ||
    104 
    105 
    106 mandatory parameters: url
    107 optional parameters: title, type, cookies, min_zoom, max_zoom
     100||= **Parameter** =||= **Required/ \\ Optional** =||= **Meaning** =||
     101|| `url` ||  R or `id`  || The Request URL, including patterns. Must be the last parameter, everything after "&url=" is interpreted as URL, even if it contains "&" characters.  ||
     102|| `id` ||  R or `url`  || The imagery ID in JOSM, see [[Maps]] (since r17655).  ||
     103|| `title` ||  O  || The display name of the layer ||
     104|| `type` ||  O  || Type of the layer. Possible values are `wms`, `tms` and `bing` ''(defaults to `wms`, since !RemoteControl Version 1.3)'' ||
     105|| `cookies` ||  O  ||  ||
     106|| `min_zoom` ||  O  || The minimum zoom level ''(since !RemoteControl Version 1.4)'' ||
     107|| `max_zoom` ||  O  || The maximum zoom level. For higher scales, the images of the maximum level is enlarged ''(since !RemoteControl Version 1.4)'' ||
     108|| `name` ||  O  || alias for `title` ''(since !RemoteControl Version 1.10)'' ||
     109|| `attribution-text` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     110|| `attribution-url` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     111|| `bestMarked` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     112|| `bounds` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     113|| `category` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     114|| `country-code` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     115|| `customHttpHeaders` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     116|| `date` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     117|| `default-layers` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     118|| `description` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     119|| `eula` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     120|| `icon` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     121|| `id` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     122|| `logo-image` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     123|| `logo-url` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     124|| `metadataHeaders` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     125|| `minimumTileExpire` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     126|| `modTileFeatures` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     127|| `noTileChecksums` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     128|| `noTileHeaders` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     129|| `overlay` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     130|| `permission-reference-url` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     131|| `pixel-per-eastnorth` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     132|| `projections` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     133|| `shapes` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     134|| `terms-of-use-text` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     135|| `terms-of-use-url` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     136|| `tileSize` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     137|| `transparent` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     138|| `type` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
     139|| `valid-georeference` ||  O  || ''(since !RemoteControl Version 1.10)'' ||
    108140
    109141==== Examples ====
    110 * TMS layer "osm" {{{http://tile.openstreetmap.org/{zoom}/{x}/{y}.png}}}
    111 
    112 [http://localhost:8111/imagery?title=osm&type=tms&url=http://tile.openstreetmap.org/%7Bzoom%7D/%7Bx%7D/%7By%7D.png]
     142* TMS layer "osm" {{{https://tile.openstreetmap.org/{zoom}/{x}/{y}.png}}}
     143
     144http://localhost:8111/imagery?title=osm&type=tms&min_zoom=1&max_zoom=20&url=https://tile.openstreetmap.org/%7Bzoom%7D/%7Bx%7D/%7By%7D.png
    113145
    114146* WMS layer "landsat" {{{http://irs.gis-lab.info/?layers=landsat&SRS={proj}&WIDTH={width}&HEIGHT={height}&BBOX={bbox} }}}
    115 [http://localhost:8111/imagery?title=landsat&type=wms&url=http://irs.gis-lab.info/?layers=landsat&SRS=%7Bproj%7D&WIDTH=%7Bwidth%7D&HEIGHT=%7Bheight%7D&BBOX=%7Bbbox%7D]
     147http://localhost:8111/imagery?title=landsat&type=wms&url=http://irs.gis-lab.info/?layers=landsat&SRS=%7Bproj%7D&WIDTH=%7Bwidth%7D&HEIGHT=%7Bheight%7D&BBOX=%7Bbbox%7D
     148
     149* "Bing" layer
     150
     151http://localhost:8111/imagery?id=Bing
     152
    116153
    117154=== {{{load_object}}} ===
    118 
    119155Instructs JOSM to download objects with a given id.
    120156{{{
     
    122158}}}
    123159where
    124 ||= **Parameter** =||= **Required/Optional** =||= **Meaning** =||
    125 || `objects` || R || Comma separated list of object ids, e.g. "{{{n1234,n1235,w84,r958493}}}" ||
    126 || `new_layer` || O || If '''true''', downloads to a new layer ||
    127 || `addtags` || O || Optional parameter to add tags. The key and value is separated by "=" and multiple tags can be separated by a Pipe "|". See [#addtags details]. ||
    128 || `relation_members` || O || If '''true''', downloads objects members of the relations as well. ||
    129 || `referrers` || O || If '''true''', downloads referrers of the object as well. I.e. parent relations, and for nodes, additionally, parent ways. (since r6782) ||
    130 || `layer_name` || O || Only valid when the data is loaded in a new layer; Gives JOSM a hint on how to name the layer ||
    131 || `layer_locked` || O || Only valid when the data is loaded in a new layer; If '''true''', new layer is [[Action/LockedLayer|locked]] ||
    132 || `download_policy` || O || Only valid when the data is loaded in a new layer; If '''never''' , download is [[Help/Action/BlockDownload|blocked]] ||
    133 || `upload_policy` || O || Only valid when the data is loaded in a new layer; If '''never''' or '''false''', upload is [[Help/Action/EncourageDiscourageUpload|blocked or discouraged]] ||
     160||= **Parameter** =||= **Required/ \\ Optional** =||= **Meaning** =||
     161|| `objects` ||  R || Comma separated list of object ids, e.g. "{{{n1234,n1235,w84,r958493}}}" ||
     162|| `new_layer` ||  O || If '''true''', downloads to a new layer. (Overwrites user preference, see #19308) ||
     163|| `addtags` ||  O || Optional parameter to add tags. The key and value is separated by "=" and multiple tags can be separated by a Pipe "|". See [#addtags details]. ||
     164|| `relation_members` ||  O || If '''true''', downloads objects members of the relations as well. ||
     165|| `referrers` ||  O || If '''true''', downloads referrers of the object as well. I.e. parent relations, and for nodes, additionally, parent ways. ''(since r6782)'' ||
     166|| `layer_name` ||  O || Only valid when the data is loaded in a new layer; Gives JOSM a hint on how to name the layer ||
     167|| `layer_locked` ||  O || Only valid when the data is loaded in a new layer; If '''true''', new layer is [wikitr:/Help/Action/LockedLayer locked] ||
     168|| `download_policy` ||  O || Only valid when the data is loaded in a new layer; If '''never''' , download is [wikitr:/Help/Action/BlockDownload blocked] ||
     169|| `upload_policy` ||  O || Only valid when the data is loaded in a new layer; If '''never''' or '''false''', upload is [wikitr:/Help/Action/EncourageDiscourageUpload blocked or discouraged] ||
    134170
    135171==== Example ====
    136 
    137172[http://localhost:8111/load_object?new_layer=true&objects=w106159509]
    138173
     174
    139175=== {{{add_node}}} ===
    140 
    141176Instructs JOSM to create a new node at the given coordinates.
    142177
     
    147182}}}
    148183where
    149 ||= **Parameter** =||= **Required/Optional** =||= **Meaning** =||
    150 || `lon` || R || The longitude of the node ||
    151 || `lat` || R || The latitude of the node ||
    152 || `addtags` since v1.5|| O || Optional parameter to add tags. The key and value is separated by "=" and multiple tags can be separated by a Pipe "|". See [#addtags details]. ||
     184||= **Parameter** =||= **Required/ \\ Optional** =||= **Meaning** =||
     185|| `lon` ||  R || The longitude of the node ||
     186|| `lat` ||  R || The latitude of the node ||
     187|| `addtags` ||  O || Optional parameter to add tags. The key and value is separated by "=" and multiple tags can be separated by a Pipe "|". See [#addtags details]. ''(since v1.5)'' ||
    153188
    154189==== Example ====
    155190http://localhost:8111/add_node?lon=13.3&lat=53.2
    156191
     192
    157193=== {{{add_way}}} ===
    158 
    159194Instructs JOSM to create a new way with new way nodes at given coordinates.
    160195
     
    165200}}}
    166201where
    167 ||= **Parameter** =||= **Required/Optional** =||= **Meaning** =||
    168 || `way` || R || Pairs of latitude, longitude coordinates separated by semicolon. ||
    169 || `addtags` since v1.5|| O || Optional parameter to add tags. The key and value is separated by "=" and multiple tags can be separated by a Pipe "|". See [#addtags details]. ||
     202||= **Parameter** =||= **Required/ \\ Optional** =||= **Meaning** =||
     203|| `way` ||  R || Pairs of latitude, longitude coordinates separated by semicolon. ||
     204|| `addtags` ||  O || Optional parameter to add tags. The key and value is separated by "=" and multiple tags can be separated by a Pipe "|". See [#addtags details]. ''(since v1.5)'' ||
    170205
    171206==== Example ====
    172 
    173207http://localhost:8111/add_way?way=53.2,13.3;53.3,13.3;53.3,13.2
    174208
     
    176210=== {{{version}}} ===
    177211This command returns the current protocol version of the installed !RemoteControl interface. Developers can use it to query for a running instance of JOSM and also determine whether the requested functionality is available in the client.
     212
    178213{{{
    179214GET /version[?jsonp=callback]
    180215}}}
    181216where
    182 ||= **Parameter** =||= **Required/Optional** =||= **Meaning** =||
    183 || `jsonp` || O|| Jsonp callback for older browsers not implementing ​Cross-Origin Resource Sharing (CORS) ||
     217||= **Parameter** =||= **Required/ \\ Optional** =||= **Meaning** =||
     218|| `jsonp` ||  O  || Jsonp callback for older browsers not implementing ​Cross-Origin Resource Sharing (CORS) ||
    184219
    185220The command returns a json object containing an application identifier that is always "JOSM !RemoteControl", a major number and a minor number. Compatible protocol changes result in an increase of the minor number. Incompatible changes increase the major number. So a client application knowing of protocol version 1.0 can still talk to JOSM having 1.1. But it's not guaranteed to be working with 2.0. So the client should verify the major number.
     
    193228      "minor": 0
    194229   },
    195    "application": "JOSM RemoteControl"
     230   "application": "JOSM RemoteControl",
     231   "version": 16587, // JOSM version (since r16587)
     232   "osm_server": "default" // indicates that the user is using the OSM server by "default" or "custom" (since r19416)
    196233}
    197234}}}
     
    255292}}}
    256293
     294=== {{{openapi.json}}} ===
     295JOSM RemoteControl as [https://swagger.io/specification/ OpenAPI Specification]
     296
     297* http://localhost:8111/openapi.json
     298* https://petstore.swagger.io/?url=http://localhost:8111/openapi.json
     299
    257300
    258301=== Adding, changing or deleting tags === #addtags
     
    271314[http://localhost:8111/load_and_zoom?addtags=wikipedia%3Ade=%7Cmaxspeed=&select=way23071688,way23076176,way23076177,&left=13.739727546842&right=13.740890970188&top=51.049987191025&bottom=51.048466954325].
    272315
     316=== {{{export}}} ===
     317''(since JOSM r19425)''
     318
     319Returns the content of the active layer in the `.osm` format
     320{{{
     321GET /export
     322}}}
     323
     324If there is no active layer, or it is in the process of uploading changes, an empty response will be returned.
     325
     326
    273327=== Other commands ===
    274328Remotecontrol allows other plugins to add additional commands. The other registers a RequestHandler class and specifies a command to be handled by this class. The command syntax has to be defined by the other plugin.
    275329
    276 Reverter plugin since version 27091 makes use of this feature.
    277 
     330==== Reverter ====
     331Reverter plugin since version 27091 makes use of this feature. See [source:osm/applications/editors/josm/plugins/reverter/src/reverter/RevertChangesetHandler.java RevertChangesetHandler.java].
     332
     333==== Mapillary ====
     334See [https://github.com/JOSM/Mapillary/blob/master/src/main/java/org/openstreetmap/josm/plugins/mapillary/io/remotecontrol/MapillaryRemoteControl.java MapillaryRemoteControl.java].
     335Either `sequence` or `photo` must be specified, but not both. Since the remote control class was written for multiple imagery sources, the id for either `sequence` or `photo` ''must'' be prefixed with `Mapillary/`.
     336
     337==== Compilation of plugin remote control commands ====
     338||= Plugin =||= **Command** =||= **Parameter** =||= **Required/ \\ Optional** =||= **Meaning** =||
     339|| Reverter || `revert_changeset` ||  ||  || Base command to revert a changeset ||
     340|| || || `id` ||  R  || The changeset id to use (should match regex `[0-9]+`). Since version 36321, you can pass multiple ids separated by commas. ||
     341|| MapWithAI || `mapwithai` || || || Base command to download MapWithAI data ||
     342|| || || `max_obj` ||  O  || Set the maximum number of objects the user can add per action from the MapWithAI layer. Should match regex `[0-9]+`. ||
     343|| || || `switch_layer` ||  O  || Use if you want to force users to automatically switch layers when they add data to OSM. Takes `true`/`false`. ||
     344|| || || `bbox` ||  O  || The bbox to download (`lat,lon,lat,lon` -- assumes the bbox will not cross meridian) ||
     345|| || || `crop_bbox` ||  O  || Crop downloaded MapWithAI data (roads only) to this bbox. Tasking managers may also generate a well-known layer. ||
     346|| || || `url` ||  O  || The URL to use instead of the built-in data sources. Useful for imports (please make certain you went through the import process). ||
     347|| || || `source` ||  O  || The source to use when uploading to OSM (changeset source) ||
     348|| Mapillary || `photo` || || || Base command to download a Mapillary photo (may be extended to other imagery sources in the future) ||
     349|| || || `photo` ||  R/O  || The id of the image to show and download. Either this or `sequence` must be specified. ||
     350|| || || `sequence` ||  R/O  || The id of the sequence to show and download. First image is shown in image viewer. ||
    278351----
    279 
    280 Back to [[Help/Preferences/RemoteControl]][[br]]
    281 Back to [[Help/Preferences]][[br]]
    282 Back to [[Help]]
     352Back to [wikitr:/Help/Preferences/RemoteControl Remote control preferences] \\
     353Back to [wikitr:/Help/Preferences Preferences] \\
     354Back to [wikitr:/Help Main Help]