wiki:Eo:Help/RemoteControlCommands

Ĉi tiu paĝo mankas komandajn trajtojn.

Lingvoj:

Foraj kontrolaj komandoj

  1. load_and_zoom
  2. zoom
  3. import
  4. load_data
  5. open_file
  6. imagery
  7. load_object
  8. add_node
  9. add_way
  10. version
  11. openapi.json
  12. Aldoni, ŝanĝi aŭ forigi etikedojn
  13. Aliaj komandoj

Listo de Komandoj

Plena listo de komandoj kaj devigaj/libervolaj parametroj estas montrita ĉe ​http://127.0.0.1:8111/ (kiam JOSM funkcias).

load_and_zoom

Instruas JOSM elŝuti limigan skatolon de la API, zomi al la elŝutita areo kaj laŭvole elekti unu aŭ plurajn objektojn. 

GET /load_and_zoom?left=...&right=...&top=...&bottom=...&select=object[,object...]

kie

Parametro Deviga/
Libervola 		Signifo
bottom D Minimuma latitudo
top D Maksimuma latitudo
left D Minimuma longitudo
right D Maksimuma longitudo
new_layer L Se vera, elŝutas al nova tavolo. (Anstataŭigas uzantpreferon, vidu #19308)
layer_name L Nur valida kiam la datumoj estas ŝarĝitaj en nova tavolo; Donas al JOSM sugeston pri kiel nomi la tavolon
layer_locked L Nur valida kiam la datumoj estas ŝarĝitaj en nova tavolo; Se vera, nova tavolo estas ŝlosita
download_policy L Nur valida kiam la datumoj estas ŝarĝitaj en nova tavolo; Se neniam, elŝuto estas blokita
upload_policy L Nur valida kiam la datumoj estas ŝarĝitaj en nova tavolo; Se neniam aŭ malvera, alŝuto estas blokita aŭ malrekomendita
addtags L Libervola parametro por aldoni etikedojn. La ŝlosilo kaj valoro estas apartigitaj per "=" kaj multoblaj etikedoj povas esti apartigitaj per vertikala streko "|". Vidu detalojn.
select L Komo-apartigita listo de objektoj, kiuj devas esti elektitaj. Objekto-specifiloj estas kombinaĵoj de la vortoj "way", "node", aŭ "relation", kaj la nombra objekto-id. Ekzemplo: select=way38473,node12399,node54646. Ekde r13212 la speciala valoro currentselection permesas al JOSM konservi sian antaŭan elekton.
zoom_mode L elŝuto | elekto, defaŭlte al elekto
changeset_comment L Komento de la ŝanĝaro
changeset_source L Fonto de la ŝanĝaro
changeset_hashtags L Hashtag-oj de la ŝanĝaro (ekde r13109)
changeset_tags L Libervola parametro por aldoni ŝanĝarajn etikedojn. La ŝlosilo kaj valoro estas apartigitaj per "=" kaj multoblaj etikedoj povas esti apartigitaj per vertikala streko "|". Ĉi tiu komando uzas la saman sintakson kiel la addtags parametro. changeset_comment kaj changeset_source nuntempe anstataŭigas la comment kaj source etikedojn pasitajn en ĉi tiu parametro, sed ĉi tio povus ŝanĝi en la estonteco. (ekde r15316)
search L Serĉi objektojn en la nuna datumtavolo. Vidu Serĉo

Ekzemplo

Startigu JOSM (ne forgesu ebligi la RemoteControl trajton), poste alklaku:

​http://127.0.0.1:8111/load_and_zoom?left=8.19&right=8.20&top=48.605&bottom=48.590&select=node413602999

JOSM nun ŝarĝu areon en la Germana Nigra Arbaro kaj havu la specifitan nodon elektitan.

zoom

Instruas JOSM zomi al la specifita areo kaj laŭvole elekti unu aŭ plurajn objektojn. 

GET /zoom?left=...&right=...&top=...&bottom=...&select=object[,object...]

Akceptas la samajn parametrojn kiel la load_and_zoom komando kaj uzas la saman kodon por zomado kaj elekto. La sola diferenco estas, ke neniu datumoj estos ŝarĝitaj de la API.

Sugesto: Ĉi tiu komando ankaŭ povas esti uzata por nur elekti objektojn. Simple enigu malgrandan arbitran areon al la left..bottom enigoj kaj aldonu la objekto-liston al la select= opcio.

import

Instruas JOSM elŝuti la specifitan OSM-dosieron kaj aldoni ĝin al la nuna datumaro. 

GET /import?url=...

kie

Parametro Deviga/
Libervola 		Signifo
url D La Peto-URL, inkluzive ŝablonojn. Devas esti la lasta parametro, ĉio post "&url=" estas interpretita kiel URL, eĉ se ĝi enhavas "&" signojn.
new_layer L Se vera, elŝutas al nova tavolo. (Anstataŭigas uzantpreferon, vidu #19308)
layer_name L Nur valida kiam la datumoj estas ŝarĝitaj en nova tavolo; Donas al JOSM sugeston pri kiel nomi la tavolon
layer_locked L Nur valida kiam la datumoj estas ŝarĝitaj en nova tavolo; Se vera, nova tavolo estas ŝlosita
download_policy L Nur valida kiam la datumoj estas ŝarĝitaj en nova tavolo; Se neniam, elŝuto estas blokita
upload_policy L Nur valida kiam la datumoj estas ŝarĝitaj en nova tavolo; Se neniam aŭ malvera, alŝuto estas blokita aŭ malrekomendita
changeset_tags L Libervola parametro por aldoni ŝanĝarajn etikedojn. La ŝlosilo kaj valoro estas apartigitaj per "=" kaj multoblaj etikedoj povas esti apartigitaj per vertikala streko "|". Ĉi tiu komando uzas la saman sintakson kiel la addtags parametro. Unue havebla en r16324.

load_data

(ekde versio 1.6)

Instruu JOSM ŝarĝi OSM-datumojn, rekte koditajn en la URL, anstataŭ venantajn de ekstera dosiero. Ĉi tio nur taŭgas por malgrandaj datumoj (iuj retumiloj limigas la maksimuman URL-longon), sed ĝi estas pli rapida (ĉar neniu elŝuto estas necesa), kaj en multaj kazoj kie dinamike generitaj datumoj estas bezonataj, ĝi estas pli facila generi. 

GET /load_data?new_layer=(true/false)&layer_name=...&mime_type=...&data=...

kie

Parametro Deviga/
Libervola 		Signifo
data D La XML-datumoj por ŝarĝi, ĉi tio devas esti URL-kodita tiel, ke ankaŭ la specialaj signoj &, = kaj ? estas koditaj al resp. %26, %3D kaj %3F. La JS ​encodeUriComponent() metodo provizas ĉi tiun funkcionalon el la skatolo.
new_layer L Elektu ŝarĝi la datumojn en nova tavolo. (Anstataŭigas uzantpreferon, vidu #19308)
mime_type L Mime-tipo de la datumoj, defaŭlte ĉi tio estas "application/x-osm+xml", kiu estas nuntempe la sola subtenata mime-tipo, sed en la estonteco aliaj mime-tipoj povus esti subtenataj
layer_name L Nur valida kiam la datumoj estas ŝarĝitaj en nova tavolo; Donas al JOSM sugeston pri kiel nomi la tavolon
layer_locked L Nur valida kiam la datumoj estas ŝarĝitaj en nova tavolo; Se vera, nova tavolo estas ŝlosita
download_policy L Nur valida kiam la datumoj estas ŝarĝitaj en nova tavolo; Se neniam, elŝuto estas blokita
upload_policy L Nur valida kiam la datumoj estas ŝarĝitaj en nova tavolo; Se neniam aŭ malvera, alŝuto estas blokita aŭ malrekomendita

open_file

Malfermu lokan dosieron en JOSM. 

GET /open_file?filename=...

kie

Parametro Deviga/
Libervola 		Signifo
filename D La loka dosiero por malfermi en JOSM (Ekz: /tmp/test.osm)

imagery

Instruas JOSM aldoni bildan (WMS/TMS) tavolon. 

GET /imagery?title=...&type=...&url=...

kie

Parametro Deviga/
Libervola 		Signifo
url D aŭ id La Peto-URL, inkluzive ŝablonojn. Devas esti la lasta parametro, ĉio post "&url=" estas interpretita kiel URL, eĉ se ĝi enhavas "&" signojn.
id D aŭ url La bilda ID en JOSM, vidu Maps (ekde r17655).
title L La montrita nomo de la tavolo
type L Tipo de la tavolo. Eblaj valoroj estas wms, tms kaj bing (defaŭlte al wms, ekde RemoteControl Versio 1.3)
cookies L
min_zoom L La minimuma zoma nivelo (ekde RemoteControl Versio 1.4)
max_zoom L La maksimuma zoma nivelo. Por pli altaj skaloj, la bildoj de la maksimuma nivelo estas pligrandigitaj (ekde RemoteControl Versio 1.4)
name L aliaso por title (ekde RemoteControl Versio 1.10)
attribution-text L (ekde RemoteControl Versio 1.10)
attribution-url L (ekde RemoteControl Versio 1.10)
bestMarked L (ekde RemoteControl Versio 1.10)
bounds L (ekde RemoteControl Versio 1.10)
category L (ekde RemoteControl Versio 1.10)
country-code L (ekde RemoteControl Versio 1.10)
customHttpHeaders L (ekde RemoteControl Versio 1.10)
date L (ekde RemoteControl Versio 1.10)
default-layers L (ekde RemoteControl Versio 1.10)
description L (ekde RemoteControl Versio 1.10)
eula L (ekde RemoteControl Versio 1.10)
icon L (ekde RemoteControl Versio 1.10)
id L (ekde RemoteControl Versio 1.10)
logo-image L (ekde RemoteControl Versio 1.10)
logo-url L (ekde RemoteControl Versio 1.10)
metadataHeaders L (ekde RemoteControl Versio 1.10)
minimumTileExpire L (ekde RemoteControl Versio 1.10)
modTileFeatures L (ekde RemoteControl Versio 1.10)
noTileChecksums L (ekde RemoteControl Versio 1.10)
noTileHeaders L (ekde RemoteControl Versio 1.10)
overlay L (ekde RemoteControl Versio 1.10)
permission-reference-url L (ekde RemoteControl Versio 1.10)
pixel-per-eastnorth L (ekde RemoteControl Versio 1.10)
projections L (ekde RemoteControl Versio 1.10)
shapes L (ekde RemoteControl Versio 1.10)
terms-of-use-text L (ekde RemoteControl Versio 1.10)
terms-of-use-url L (ekde RemoteControl Versio 1.10)
tileSize L (ekde RemoteControl Versio 1.10)
transparent L (ekde RemoteControl Versio 1.10)
type L (ekde RemoteControl Versio 1.10)
valid-georeference L (ekde RemoteControl Versio 1.10)

Ekzemploj

  • TMS tavolo "osm" https://tile.openstreetmap.org/{zoom}/{x}/{y}.png

​http://localhost:8111/imagery?title=osm&type=tms&min_zoom=1&max_zoom=20&url=https://tile.openstreetmap.org/%7Bzoom%7D/%7Bx%7D/%7By%7D.png

  • WMS tavolo "landsat" http://irs.gis-lab.info/?layers=landsat&SRS={proj}&WIDTH={width}&HEIGHT={height}&BBOX={bbox}

​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

  • "Bing" tavolo

​http://localhost:8111/imagery?id=Bing

load_object

Instruas JOSM elŝuti objektojn kun donita id. 

GET /load_object?new_layer=true|false&objects=...

kie

Parametro Deviga/
Libervola 		Signifo
objects D Komo-apartigita listo de objekto-id-oj, ekz. "n1234,n1235,w84,r958493"
new_layer L Se vera, elŝutas al nova tavolo. (Anstataŭigas uzantpreferon, vidu #19308)
addtags L Libervola parametro por aldoni etikedojn. La ŝlosilo kaj valoro estas apartigitaj per "=" kaj multoblaj etikedoj povas esti apartigitaj per vertikala streko "|". Vidu detalojn.
relation_members L Se vera, elŝutas ankaŭ objektojn membrojn de la rilatoj.
referrers L Se vera, elŝutas ankaŭ referencojn de la objekto. T.e. patraj rilatoj, kaj por nodoj, krome, patraj vojoj. (ekde r6782)
layer_name L Nur valida kiam la datumoj estas ŝarĝitaj en nova tavolo; Donas al JOSM sugeston pri kiel nomi la tavolon
layer_locked L Nur valida kiam la datumoj estas ŝarĝitaj en nova tavolo; Se vera, nova tavolo estas ŝlosita
download_policy L Nur valida kiam la datumoj estas ŝarĝitaj en nova tavolo; Se neniam, elŝuto estas blokita
upload_policy L Nur valida kiam la datumoj estas ŝarĝitaj en nova tavolo; Se neniam aŭ malvera, alŝuto estas blokita aŭ malrekomendita

Ekzemplo

​http://localhost:8111/load_object?new_layer=true&objects=w106159509

add_node

Instruas JOSM krei novan nodon ĉe la donitaj koordinatoj.

Noto: Ĉi tiu ago postulas la permeson Krei novajn objektojn kiu estas malaktiva defaŭlte. 

GET /add_node?lon=...&lat=...

kie

Parametro Deviga/
Libervola 		Signifo
lon D La longitudo de la nodo
lat D La latitudo de la nodo
addtags L Libervola parametro por aldoni etikedojn. La ŝlosilo kaj valoro estas apartigitaj per "=" kaj multoblaj etikedoj povas esti apartigitaj per vertikala streko "|". Vidu detalojn. (ekde v1.5)

Ekzemplo

​http://localhost:8111/add_node?lon=13.3&lat=53.2

add_way

Instruas JOSM krei novan vojon kun novaj vojo-nodoj ĉe donitaj koordinatoj.

Noto: Ĉi tiu ago postulas la permeson Krei novajn objektojn kiu estas malaktiva defaŭlte. 

GET /add_way?way=lat1,lon1;lat2,lon2;...

kie

Parametro Deviga/
Libervola 		Signifo
way D Paroj de latitudo, longitudo koordinatoj apartigitaj per punktokomo.
addtags L Libervola parametro por aldoni etikedojn. La ŝlosilo kaj valoro estas apartigitaj per "=" kaj multoblaj etikedoj povas esti apartigitaj per vertikala streko "|". Vidu detalojn. (ekde v1.5)

Ekzemplo

​http://localhost:8111/add_way?way=53.2,13.3;53.3,13.3;53.3,13.2

version

Ĉi tiu komando redonas la aktualan protokolversion de la instalita RemoteControl interfaco. Disvolvistoj povas uzi ĝin por pridemandi pri funkcianta ekzemplo de JOSM kaj ankaŭ determini ĉu la petita funkcieco estas havebla en la kliento. 

GET /version[?jsonp=callback]

kie

Parametro Deviga/
Libervola 		Signifo
jsonp L Jsonp reapliko por malnovaj retumiloj ne implementantaj ​​Cross-Origin Resource Sharing (CORS)

La komando redonas json-objekton enhavantan aplikan identigilon kiu estas ĉiam "JOSM RemoteControl", ĉefan numeron kaj malĉefan numeron. Kongruaj protokolŝanĝoj rezultigas pliigon de la malĉefa numero. Malkongruaj ŝanĝoj pliigas la ĉefan numeron. Do klienta aplikaĵo scianta pri protokolversio 1.0 povas ankoraŭ paroli kun JOSM havanta 1.1. Sed ne estas garantie, ke ĝi funkcios kun 2.0. Do la kliento devus kontroli la ĉefan numeron.

Tipa eligo aspektas tiel: 

{
   "protocolversion": {
      "major": 1, 
      "minor": 0
   }, 
   "application": "JOSM RemoteControl",
   "version": 16587 // JOSM versio (ekde r16587)
}

Por malnovaj retumiloj ne implementantaj ​Cross-Origin Resource Sharing (CORS) la komando provizas la eblecon por jsonp reapliko. Ŝarĝu la URL en skripto-etikedo kaj provizu la nomon de reapliko kiu ricevos la JSON-datumojn.

Jen iu specimenkodo kiu kontrolas por CORS kapabloj kaj uzas ​JSONP kiel rezerva solvo. 

// krom la CC-BY-SA de la vikio libere uzu la jenan fonton por iu ajn celo sen limigoj (PD)
// kreditoj kaj aldonaĵoj aprezataj: https://wiki.openstreetmap.org/wiki/User:Stephankn

function checkJOSM(version){
   alert(version.application + " uzas protokolversion " + version.protocolversion.major + "." + version.protocolversion.minor);
   // faru ion utilan, eble montrante redaktbutonon
}

var url = "http://127.0.0.1:8111/version";
var useFallback = false;
// nuntempe FF3.5, Safari 4 kaj IE8 implementas 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 {
   // neniu XMLHttpRequest havebla
   useFallback = true;
}

if (useFallback) {
   // Uzu heredan jsonp alvokon
   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);
   }
    
}

openapi.json

JOSM RemoteControl kiel ​OpenAPI Specification

Aldoni, ŝanĝi aŭ forigi etikedojn

Provu ĉi tiun ekzemplon: ​http://localhost:8111/load_and_zoom?addtags=wikipedia%3Ade=Weiße_Gasse%7Cmaxspeed=5&select=way23071688,way23076176,way23076177,&left=13.739727546842&right=13.740890970188&top=51.049987191025&bottom=51.048466954325. (Funkcias ankaŭ kun la zoom-komando)

La uzanto devas revizii la etikedojn kaj la elekton antaŭ ol la etikedoj estas aplikitaj al la elektitaj objektoj. Se la etikedo ekzistas sur iuj objektoj, ĝi estos anstataŭigita.

Ekde protokolversio 1.5

  • add_node kaj add_way komandoj subtenas addtags parametron
  • Eblas uzi = signon en valoro kaj ĉiuj gvidaj/finalaj spacoj estas forigitaj.

​http://localhost:8111/add_node?lon=13.3&lat=53.2&addtags=natural=tree%7Cname=%20%20%20==Great%20Oak== (kreas nodon kun natural=tree kaj name="==Great Oak==")

  • Se malplena valoro estas trovita, etikedo estas forigota de objektoj (markobutono-konfirmo estas necesa)

​http://localhost:8111/load_and_zoom?addtags=wikipedia%3Ade=%7Cmaxspeed=&select=way23071688,way23076176,way23076177,&left=13.739727546842&right=13.740890970188&top=51.049987191025&bottom=51.048466954325.

Aliaj komandoj

Remotecontrol permesas aliajn kromprogramojn aldoni pliajn komandojn. La alia registras RequestHandler-klason kaj specifas komandon por esti traktita de ĉi tiu klaso. La komando-sintakso devas esti difinita de la alia kromprogramo.

Reverter

Reverter kromprogramo ekde versio 27091 uzas ĉi tiun trajton. Vidu RevertChangesetHandler.java​.

Mapillary

Vidu ​MapillaryRemoteControl.java. Ĉu sequence aŭ photo devas esti specifita, sed ne ambaŭ. Ekde la fora kontrolklaso estis skribita por multaj bildaj fontoj, la id por ĉu sequence aŭ photo devus esti prefiksita kun Mapillary/.

Kompilo de kromprogramaj foraj kontrolaj komandoj

Kromprogramo Komando Parametro Deviga/
Libervola 		Signifo
Reverter revert_changeset Baza komando por reverti ŝanĝaron
id D La ŝanĝaro-id por uzi (devus kongrui kun regex [0-9]+)
MapWithAI mapwithai Baza komando por elŝuti MapWithAI datumojn
max_obj L Agordi la maksimuman nombron de objektoj kiujn la uzanto povas aldoni per ago de la MapWithAI tavolo. Devus kongrui kun regex [0-9]+.
switch_layer L Uzu se vi volas devigi uzantojn aŭtomate ŝalti tavolojn kiam ili aldonas datumojn al OSM. Prenas vera/malvera.
bbox L La bbox por elŝuti (lat,lon,lat,lon -- supozas ke la bbox ne transiros meridianon)
crop_bbox L Tondi elŝutitajn MapWithAI datumojn (vojojn nur) al ĉi tiu bbox. Taskaj administriloj povas ankaŭ generi bone-konatan tavolon.
url L La URL por uzi anstataŭ la enkonstruitaj datumfontoj. Utila por importoj (bonvolu certi ke vi trairis la importan procezon).
source L La fonto por uzi kiam alŝutante al OSM (ŝanĝara fonto)
Mapillary photo Baza komando por elŝuti Mapillian foton (povas esti etendita al aliaj bildaj fontoj en la estonteco)
photo D/L La id de la bildo por montri kaj elŝuti. Ĉu ĉi tiu aŭ sequence devas esti specifita.
sequence D/L La id de la sekvenco por montri kaj elŝuti. Unua bildo estas montrita en bilda vidilo.

Reen al Foraj kontrolpreferoj
Reen al Preferoj
Reen al Ĉefa Helpo

Last modified 5 days ago Last modified on 2025-03-08T21:11:13+01:00
Note: See TracWiki for help on using the wiki.