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` || Н || Якщо «істина», завантажити до нового шару || |
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 | {{{ |
| 54 | GET /zoom?left=…&right=…&top=…&bottom=…&select=object[,object…] |
| 55 | }}} |
| 56 | Приймає тіж самі параметри що й команда {{{load_and_zoom}}} та використовує таке саме кодування для масштабування та виділення. Існує тільки одна різниця — вона не завантажує дані через API. |
| 57 | |
| 58 | **Підказка**: Ця команда може використовуватись тільки для виділення об’єктів. Просто введіть координати довільної маленької ділянки (left..bottom) та додайте перелік об’єктів до параметра select= . |
| 59 | |
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 | {{{ |
| 71 | GET /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}}} |
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 | {{{ |
| 91 | GET /load_object?new_layer=true|false&objects=… |
| 92 | }}} |
| 93 | де |
| 94 | ||= **Параметр** =||= **Обов’язковий/необов’язковий** =||= **Опис** =|| |
| 95 | || `objects` || О || Перелік розділених комами id об’єктів, наприклад "{{{n1234,n1235,w84,r958493}}}" || |
| 96 | || `new_layer` || Н || Якщо «істина», завантажити до нового шару || |
| 97 | |
| 98 | ==== Приклад ==== |
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 | {{{ |
| 109 | GET /add_node?lon=…&lat=… |
| 110 | }}} |
| 111 | де |
| 112 | ||= **Параметр** =||= **Обов’язковий/необов’язковий** =||= **Опис** =|| |
| 113 | || `lon` || О || Довгота точки || |
| 114 | || `lat` || О || Широта точки || |
| 115 | |
| 116 | ==== Приклад ==== |
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 | {{{ |
| 126 | GET /add_way?way=lat1,lon1;lat2,lon2;… |
| 127 | }}} |
| 128 | де |
| 129 | ||= **Параметр** =||= **Обов’язковий/необов’язковий** =||= **Опис** =|| |
| 130 | || `way` || О || Пари довгота та широта, розділені точкою з комою. || |
| 131 | |
| 132 | ==== Приклад ==== |
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 | Типовий вивід виглядатиме приблизно так: |
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] як розв’язання задач зі зворотнім викликом. |