Changes between Version 3 and Version 4 of Uk:Help/Preferences/RemoteControl


Ignore:
Timestamp:
2012-01-28T20:02:29+01:00 (14 years ago)
Author:
andygol
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Uk:Help/Preferences/RemoteControl

    v3 v4  
    3333де
    3434||= **Параметр** =||= **Обов’язковий/необов’язковий** =||= **Опис** =||
    35 || `left` || R || мінімальна довгота ||
    36 || `right` || R || максимальна довгота ||
    37 || `bottom` || R || мінімальна широта ||
    38 || `top` || R || максимальна широта ||
    39 || `select` || O || розділений комами перелік об’єктів, які потрібно виділити. Об’єкти вказуються комбінацією слів "way", "node" або "relation" та числовим id. Example: {{{select=way38473,node12399,node54646}}} ||
    40 || `addtags` || O || необов’язковий параметр для додавання теґів. Ключі та значення відокремлюються знаком "=", а кілька теґів можуть бути розділені "|". Спробуйте цей [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 приклад]. Працює також із командою zoom. Користувачу потрібно спочатку переглянути теґи та виділення перед тим, як теґи будуть застосовані до виділених об’єктів. ||
    41 || `new_layer` || O || Якщо «істина», завантажити до нового шару ||
     35|| `left` || О || мінімальна довгота ||
     36|| `right` || О || максимальна довгота ||
     37|| `bottom` || О || мінімальна широта ||
     38|| `top` || О || максимальна широта ||
     39|| `select` || Н || розділений комами перелік об’єктів, які потрібно виділити. Об’єкти вказуються комбінацією слів "way", "node" або "relation" та числовим id. Example: {{{select=way38473,node12399,node54646}}} ||
     40|| `addtags` || Н || необов’язковий параметр для додавання теґів. Ключі та значення відокремлюються знаком "=", а кілька теґів можуть бути розділені "|". Спробуйте цей [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 приклад]. Працює також із командою zoom. Користувачу потрібно спочатку переглянути теґи та виділення перед тим, як теґи будуть застосовані до виділених об’єктів. ||
     41|| `new_layer` || Н || Якщо «істина», завантажити до нового шару ||
    4242
    4343==== Приклад ====
     
    5050
    5151=== {{{zoom}}} ===
    52 Instructs JOSM to zoom to the specified area and optionally select one or more objects.
    53 {{{
    54 GET /zoom?left=...&right=...&top=...&bottom=...&select=object[,object...]
    55 }}}
    56 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.
    57 
    58 **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.
     52Надає JOSM інструкції для масштабування вказаної ділянки та (необов’язково) виділення одного чи де-кількох об’єктів.
     53{{{
     54GET /zoom?left=…&right=…&top=…&bottom=…&select=object[,object…]
     55}}}
     56Приймає тіж самі параметри що й команда {{{load_and_zoom}}} та використовує таке саме кодування для масштабування та виділення. Існує тільки одна різниця — вона не завантажує дані через API.
     57
     58**Підказка**: Ця команда може використовуватись тільки для виділення об’єктів. Просто введіть координати довільної маленької ділянки (left..bottom) та додайте перелік об’єктів до параметра select= .
     59
    5960=== {{{import}}} ===
    60 Instructs JOSM to download the specified OSM file and add it to the current data set.
    61 {{{
    62 GET /import?url=...
     61Надає JOSM інструкції для для завантаження вказаного файлу OSM та додавання його до поточного набору даних.
     62{{{
     63GET /import?url=
    6364}}}
    6465
     
    6667
    6768=== {{{imagery}}} ===
    68 Instructs JOSM to add an imagery (WMS/TMS) layer.
    69 {{{
    70 GET /imagery?title=...&type=...&url=...
    71 }}}
    72 where
    73 ||= **Parameter** =||= **Required/Optional** =||= **Meaning** =||
    74 || `title` || O || The display name of the layer ||
    75 || `type` || O || Type of the layer. Possible values are `wms` and `tms` [[BR]] (since !RemoteControl Version 1.3) ||
    76 || `url` || R || The Request URL, including patterns. Must be the last parameter, everything after "&url=" is interpreted as URL, even if it contains "&" characters.  ||
    77 
    78 ==== Examples ====
    79 * TMS layer "osm" {{{http://tile.openstreetmap.org/{zoom}/{x}/{y}.png}}}
     69Надає JOSM інструкції для завантаження шару (WMS/TMS) з фоном.
     70{{{
     71GET /imagery?title=…&type=…&url=…
     72}}}
     73де
     74||= **Параметр** =||= **Обов’язковий/необов’язковий** =||= **Опис** =||
     75|| `title` || Н || Назва шару ||
     76|| `type` || Н || Тип шару. Можливі значення `wms` та `tms` [[BR]] (починаючи з версії 1.3) ||
     77|| `url` || О || URL-запит, включаючи шаблони. Повинен бути останнім параметром, все що знаходиться після "&url=" інтерпретується як URL, навіть якщо є символи "&".  ||
     78
     79==== Приклади ====
     80* TMS шар "osm" {{{http://tile.openstreetmap.org/{zoom}/{x}/{y}.png}}}
    8081
    8182[http://localhost:8111/imagery?title=osm&type=tms&url=http://tile.openstreetmap.org/%7Bzoom%7D/%7Bx%7D/%7By%7D.png]
    8283
    83 * WMS layer "landsat" {{{http://irs.gis-lab.info/?layers=landsat&SRS={proj}&WIDTH={width}&HEIGHT={height}&BBOX={bbox} }}}
     84* WMS шар "landsat" {{{http://irs.gis-lab.info/?layers=landsat&SRS={proj}&WIDTH={width}&HEIGHT={height}&BBOX={bbox} }}}
    8485[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]
    8586
    8687=== {{{load_object}}} ===
    8788
    88 Instructs JOSM to download objects with a given id.
    89 {{{
    90 GET /load_object?new_layer=true|false&objects=...
    91 }}}
    92 where
    93 ||= **Parameter** =||= **Required/Optional** =||= **Meaning** =||
    94 || `objects` || R || Comma separated list of object ids, e.g. "{{{n1234,n1235,w84,r958493}}}" ||
    95 || `new_layer` || O || If true, downloads to a new layer ||
    96 
    97 ==== Example ====
     89Надає JOSM інструкції для завантаження об’єктів із зазначеними id.
     90{{{
     91GET /load_object?new_layer=true|false&objects=
     92}}}
     93де
     94||= **Параметр** =||= **Обов’язковий/необов’язковий** =||= **Опис** =||
     95|| `objects` || О || Перелік розділених комами id об’єктів, наприклад "{{{n1234,n1235,w84,r958493}}}" ||
     96|| `new_layer` || Н || Якщо «істина», завантажити до нового шару ||
     97
     98==== Приклад ====
    9899
    99100[http://localhost:8111/load_object?new_layer=true&objects=w106159509]
     
    101102=== {{{add_node}}} ===
    102103
    103 Instructs JOSM to create a new node at the given coordinates.
    104 
    105 **Note**: This action requires the permission ''Create new objects'' which is disabled by default.
    106 
    107 {{{
    108 GET /add_node?lon=...&lat=...
    109 }}}
    110 where
    111 ||= **Parameter** =||= **Required/Optional** =||= **Meaning** =||
    112 || `lon` || R || The longitude of the node ||
    113 || `lat` || R || The latitude of the node ||
    114 
    115 ==== Example ====
     104Надає JOSM інструкції для створення нової точки за вказаними координатами.
     105
     106**Примітка**: Ця дія потребує дозволу на ''Створення нових об’єктів'', який є відключеним у типових налаштуваннях.
     107
     108{{{
     109GET /add_node?lon=…&lat=…
     110}}}
     111де
     112||= **Параметр** =||= **Обов’язковий/необов’язковий** =||= **Опис** =||
     113|| `lon` || О || Довгота точки ||
     114|| `lat` || О || Широта точки ||
     115
     116==== Приклад ====
    116117http://localhost:8111/add_node?lon=13.3&lat=53.2
    117118
    118119=== {{{add_way}}} ===
    119120
    120 Instructs JOSM to create a new way with new way nodes at given coordinates.
    121 
    122 **Note**: This action requires the permission ''Create new objects'' which is disabled by default.
    123 
    124 {{{
    125 GET /add_way?way=lat1,lon1;lat2,lon2;...
    126 }}}
    127 where
    128 ||= **Parameter** =||= **Required/Optional** =||= **Meaning** =||
    129 || `way` || R || Pairs of latitude, longitude coordinates separated by semicolon. ||
    130 
    131 ==== Example ====
     121Надає JOSM інструкції для створення нової лінії з новими точками по заданих координатах.
     122
     123**Примітка**: Ця дія потребує дозволу на ''Створення нових об’єктів'', який є відключеним у типових налаштуваннях.
     124
     125{{{
     126GET /add_way?way=lat1,lon1;lat2,lon2;
     127}}}
     128де
     129||= **Параметр** =||= **Обов’язковий/необов’язковий** =||= **Опис** =||
     130|| `way` || О || Пари довгота та широта, розділені точкою з комою. ||
     131
     132==== Приклад ====
    132133
    133134http://localhost:8111/add_way?way=53.2,13.3;53.3,13.3;53.3,13.2
     
    135136
    136137=== {{{version}}} ===
    137 This 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.
     138Ця команда звітує про версію протоколу інтерфейсу !RemoteControl. Розробники можуть використовувати цей запит для перевірки чи підтримує запущена версія JOSM потрібний функціонал.
    138139{{{
    139140GET /version[?jsonp=callback]
    140141}}}
    141142
    142 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.
    143 
    144 A typical output looks like this:
     143Команда повертає об’єкт json, який містить ідентифікатор застосунка, який завжди буде "JOSM !RemoteControl", основний і додатковий номер версії. Сумісні зміни протоколу збільшують додатковий номер. Несумісні —  основний номер. Отже клієнтський застосунок із протоколом версії 1.0 буде працювати із JOSM, що має версію протоколу 1.1. Але немає ніякої гарантії, що він буде працювати із версією протоколу 2.0. Отже клієнт повинен перевіряти основний номер версії.
     144
     145Типовий вивід виглядатиме приблизно так:
    145146{{{
    146147#!js
     
    153154}
    154155}}}
    155 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.
    156 
    157 Following is some sample code that checks for CORS capabilities and uses [http://en.wikipedia.org/wiki/JSONP JSONP] as a fallback solution.
     156Для старих оглядачів не реалізовано команду [http://en.wikipedia.org/wiki/Cross-Origin_Resource_Sharing Cross-Origin Resource Sharing (CORS)], що надає можливість зворотнього виклику jsonp. Завантажте URL до сценарію додайте відповідні теґи та назву зворотнього виклику, який отримуватиме дані JSON.
     157
     158Тут наводиться зразковий код, який перевіряє можливості CORS capabilities та використовує [http://en.wikipedia.org/wiki/JSONP JSONP] як розв’язання задач зі зворотнім викликом.
    158159{{{
    159160#!js
     
    212213}}}
    213214
    214 === Other commands ===
    215 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.
    216 
    217 Reverter plugin since version 27091 makes use of this feature.
     215=== Інші команди ===
     216Функції Відділеного керування дозволяють іншим втулкам додавати додаткові команди. Їх потрібно реєструвати у класі RequestHandler та визначати команди керуючи цим класом. Синтаксис команд повинен визначатись у цих втулках.
     217
     218Втулок Reverter користується цією можливістю починаючи з версії 27091.
    218219
    219220== Дивись також ==