Changes between Version 4 and Version 5 of Help/Preferences/RemoteControl

Timestamp:

2012-01-23T15:51:48+01:00 (14 years ago)

Author:

bastiK

Comment:

copy doc from the openstreetmap wiki

Help/Preferences/RemoteControl

@@ -24 +24 @@
 * '''Confirm all Remote Control actions manually'''
 
-== See also ==
+== List of Commands ==
+=== {{{load_and_zoom}}} ===
+Instructs JOSM to download a bounding box from the API, zoom to the downloaded area and optionally select one or more objects.
+{{{
+GET /load_and_zoom?left=...&right=...&top=...&bottom=...&select=object[,object...]
+}}}
+where
+||= '''Parameter''' =||= '''Required/Optional''' =||= '''Meaning''' =||
+|| `left` || R || minimum longitude ||
+|| `right` || R || maximum longitude ||
+|| `bottom` || R || minimum latitude ||
+|| `top` || R || maximum latitude ||
+|| `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}}} ||
+|| `addtags` || O || Optional parameter to add tags. The key and value is separated by "=" and multiple tags can be separated by a Pipe "|". Try this one for [http://localhost:8111/load_and_zoom?addtags=wikipedia:de=Wei%C3%9Fe_Gasse|maxspeed=5&select=way23071688,way23076176,way23076177,&left=13.739727546842&right=13.740890970188&top=51.049987191025&bottom=51.048466954325 example]. Works also with the zoom-command. The user must review the tags and the selection before the tags are applied to the selected objects. ||
+
+==== Example ====
+
+Start JOSM (don't forget to enable the RemoteControl feature), then click on:
+
+[http://127.0.0.1:8111/load_and_zoom?left=8.19&right=8.20&top=48.605&bottom=48.590&select=node413602999]
+
+JOSM should now load an area in the German Schwarzwald and have the specified node selected. 
+
+=== {{{zoom}}} ===
+Instructs JOSM to zoom to the specified area and optionally select one or more objects.
+{{{
+GET /zoom?left=...&right=...&top=...&bottom=...&select=object[,object...]
+}}}
+Accepts the same parameters as the {{{load_and_zoom}}} command and uses the same code for zoom and selection. The only difference is that no data will be loaded from the API.
+
+**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.
+=== {{{import}}} ===
+Instructs JOSM to download the specified OSM file and add it to the current data set.
+{{{
+GET /import?url=...
+}}}
+=== {{{version}}} ===
+This command returns the current protocol version of the installed JOSM RemoteControl plugin. Developers can use it to query for a running instance of JOSM and also determine whether the requested functionality is available in the client.
+{{{
+GET /version[?jsonp=callback]
+}}}
+
+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.
+
+A typical output looks like this:
+{{{
+#!js
+{
+   "protocolversion": {
+      "major": 1, 
+      "minor": 0
+   }, 
+   "application": "JOSM RemoteControl"
+}
+}}}
+For older browsers not implementing [http://en.wikipedia.org/wiki/Cross-Origin_Resource_Sharing Cross-Origin Resource Sharing (CORS)] the command provides the possibility for jsonp callback. Load the URL in a script tag and supply the name of a callback that will receive the JSON data.
+
+Following is some sample code that checks for CORS capabilities and uses [http://en.wikipedia.org/wiki/JSONP JSONP] as a fallback solution. 
+{{{
+#!js
+// in addition to the CC-BY-SA of the wiki feel free to use the following source for any purpose without restrictions (PD)
+// credits and additions appreciated: http://wiki.openstreetmap.org/wiki/User:Stephankn
+
+function checkJOSM(version){
+   alert(version.application + " uses protocol version " + version.protocolversion.major + "." + version.protocolversion.minor);
+   // do something useful, maybe showing edit button
+}
+
+var url = "http://127.0.0.1:8111/version";
+var useFallback = false;
+// currently FF3.5, Safari 4 and IE8 implement CORS
+if (XMLHttpRequest) {
+   var request = new XMLHttpRequest();
+   if ("withCredentials" in request) {
+      request.open('GET', url, true);
+      request.onreadystatechange = function(){
+         if (request.readyState != 4) {
+            return;
+         }
+         if (request.status == 200) {
+            checkJOSM(eval('(' + request.responseText + ')'));
+         }
+      };
+      request.send();
+   }
+   else if (XDomainRequest) {
+      var xdr = new XDomainRequest();
+      xdr.open("get", url);
+      xdr.onload = function(){
+         checkJOSM(eval('(' + xdr.responseText + ')'));
+      };
+      xdr.send();
+   } else {
+      useFallback = true;
+   }
+}
+else {
+   // no XMLHttpRequest available
+   useFallback = true;
+}
+
+if (useFallback) {
+   // Use legacy jsonp call
+   var s = document.createElement('script');
+   s.src = url + '?jsonp=checkJOSM';
+   s.type = 'text/javascript';
+    
+   if (document.getElementsByTagName('head').length > 0) {
+      document.getElementsByTagName('head')[0].appendChild(s);
+   }
+    
+}
+}}}
+=== other commands ===
+Remotecontrol 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.
+
+Reverter plugin since 27091 makes use of this feature.
+
+== See also =
 [http://wiki.openstreetmap.org/wiki/JOSM/Plugins/RemoteControl Old JOSM Remote-Plugin page at OSM wiki]