RU:JOSM/RemoteControl

From OpenStreetMap Wiki
Jump to navigation Jump to search

broom

Help (89606) - The Noun Project.svg

Плагин Удаленное управление теперь доступен в основной сборке JOSM. Плагин открывает на прослушивание TCP порт (8111) на компьютере, по которому может принимать команды.

Возможности "удаленного управление" теперь в основной сборке JOSM. Более не требуется отдельная установка плагина удаленного управления.

Для отключения функции удаленного управления, откройте меню 'Правка' -> 'Настрой' и в левой части всех настроек щелкните мышкой на иконке удаленного управления, и просто снимите галку для отключения.

Плагин был добавлен в основную сборку JOSM начиная с версии 3715. Пользователи более старых версий JOSM могут продолжать использовать плагин.

Проблемы Конфиденциальности/безопасности:

Открыти порта позволяет другим приложениям определить что JOSM запущен, что может быть не желательно. It could introduce a security risk based on the actual implementation even with the current implementation considered safe.

The protocol used is HTTP, so that web applications wishing to let the user edit a certain area can simply generate suitable HTTP links.

Все команды реализованы в виде GET запросов.

Список команд

Команда version

Данная команда возвращает текущую версию протокола используемого плагином Удаленное управление. Разработчики могут использовать ее для запроса запущенного экземпляра JOSM, а так же определиться доступна ли в клиенте запрошенная функциональность.

 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:

{
   "protocolversion": {
      "major": 1, 
      "minor": 0
   }, 
   "application": "JOSM RemoteControl"
}


For older browsers not implementing 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 JSONP as a fallback solution.

// 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);
   }
    
}


Команда load_and_zoom

Инструкция JOSM скачать область карты (рамку) с API, приблизить окаченную область zoom и опционально выбрать один или более объектов.

 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 See full documentation and usage under: /Add-tags.
Optional parameter to add tags. The key and value is separated by "=" and multiple tags can be separated by a Pipe "|".

New parameter since JOSM 3850 (latest version) Try this one for 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.

Пример

Запустите JOSM (не забудьте включить Удаленное управление сначала), после щелкните :

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. (available since remotecontrol revision 22734)

 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

Инструкция JOSM загрузить OSM файл и добавить его в текущий слой.

 GET /import?url=...

where

parameter required/

optional

meaning
url R URL to download data from

Другие команды

Since version 22675 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.

Currently only WMSPlugin since version 22677 makes use of this feature.

Безопасность

Since the remote control plugin contacts remote servers, if you are of the security conscious kind, you might want to know exactly what the plugin does, and allow or disallow certain actions. The following configuration options are available:

Опция настроки значение по умолчанию описание
remotecontrol.always-confirm ложь(false) если истина (true), каждый запрос на удаленное управление должен быть подтвержден в всплывающем диалоге пользователем. This will be checked also for commands added by other plugins.
remotecontrol.permission.change-selection true allows remote control plugin to change which objects are selected
remotecontrol.permission.change-viewport true allows remote control plugin to zoom/pan to another location
remotecontrol.permission.import true allows remote control plugin to import data from remote URLs
remotecontrol.permission.load-data true allows remote control plugin to load data from OSM API
remotecontrol.permission.read-protocolversion true allows remote control to report its protocol version

Other plugins that register additional commands can specify a similar setting to disable the specific command registered by this plugin. Since this is controlled by the other plugin, the setting should be in the other plugin's preferences name space and should be handled by the other plugin's preferences editor.

Use from this wiki

Several templates create links fot the RemoteControl plugin.