Changes between Version 28 and Version 29 of Help/Preferences/RemoteControl
- Timestamp:
- 2014-11-16T17:48:53+01:00 (11 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Help/Preferences/RemoteControl
v28 v29 1 [[TranslatedPages(outdated=This page is missing some new options and the list of commands is probably better situated on a separate page.)]]1 [[TranslatedPages(outdated=This page is missing some new commands : features and open_file. The list of commands is probably better situated on a separate page.)]] 2 2 = Preferences > Remote Control = 3 3 … … 71 71 GET /import?url=... 72 72 }}} 73 where 74 ||= **Parameter** =||= **Required/Optional** =||= **Meaning** =|| 75 || `url` || R || || 76 || `new_layer` || O || If '''true''', downloads to a new layer || 73 77 74 78 === {{{load_data}}} === … … 81 85 where 82 86 ||= **Parameter** =||= **Required/Optional** =||= **Meaning** =|| 87 || `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. || 83 88 || `new_layer` || O || Chose to load the data in a new layer || 89 || `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 || 84 90 || `layer_name` || O || Only valid when the data is loaded in a new layer; Gives JOSM a hint on how to name the layer || 85 || `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 ||86 || `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. ||87 91 88 92 === {{{imagery}}} === … … 93 97 where 94 98 ||= **Parameter** =||= **Required/Optional** =||= **Meaning** =|| 99 || `url` || R || The Request URL, including patterns. Must be the last parameter, everything after "&url=" is interpreted as URL, even if it contains "&" characters. || 95 100 || `title` || O || The display name of the layer || 96 101 || `type` || O || Type of the layer. Possible values are `wms`, `tms` and `bing` [[BR]] (since !RemoteControl Version 1.3) || 102 || `cookies` || O || || 97 103 || `min_zoom` || O || The minimum zoom level [[BR]] (since !RemoteControl Version 1.4) || 98 104 || `max_zoom` || O || The maximum zoom level. For higher scales, the images of the maximum level is enlarged [[BR]] (since !RemoteControl Version 1.4) || 99 || `url` || R || The Request URL, including patterns. Must be the last parameter, everything after "&url=" is interpreted as URL, even if it contains "&" characters. || 105 106 107 mandatory parameters: url 108 optional parameters: title, type, cookies, min_zoom, max_zoom 100 109 101 110 ==== Examples ==== … … 116 125 ||= **Parameter** =||= **Required/Optional** =||= **Meaning** =|| 117 126 || `objects` || R || Comma separated list of object ids, e.g. "{{{n1234,n1235,w84,r958493}}}" || 118 || `new_layer` || O || If true, downloads to a new layer ||127 || `new_layer` || O || If '''true''', downloads to a new layer || 119 128 || `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]. || 120 || `referrers` || O || If true, downloads referrers of the object as well. I.e. parent relations, and for nodes, additionally, parent ways. (since r6782) || 129 || `relation_members` || O || If '''true''', downloads objects members of the relations as well. || 130 || `referrers` || O || If '''true''', downloads referrers of the object as well. I.e. parent relations, and for nodes, additionally, parent ways. (since r6782) || 121 131 122 132 ==== Example ==== … … 166 176 GET /version[?jsonp=callback] 167 177 }}} 178 where 179 ||= **Parameter** =||= **Required/Optional** =||= **Meaning** =|| 180 || `jsonp` || O|| Jsonp callback for older browsers not implementing Cross-Origin Resource Sharing (CORS) || 168 181 169 182 The 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.
