wiki:Nb:Help/RemoteControlCommands

Denne siden mangler kommandoegenskaper.

Andre språk:

Fjernkontrollkommandoer

  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. Legge til, endre eller slette tags
  13. Andre kommandoer

Liste over Kommandoer

En fullstendig liste over kommandoer og obligatoriske/valgfrie parametere vises på ​http://127.0.0.1:8111/ (når JOSM kjører).

load_and_zoom

Instruerer JOSM om å laste ned en begrensningsboks fra API-en, zoome til det nedlastede området og eventuelt velge ett eller flere objekter. 

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

hvor

Parameter Obligatorisk/
Valgfri 		Betydning
bottom O Minimum breddegrad
top O Maksimum breddegrad
left O Minimum lengdegrad
right O Maksimum lengdegrad
new_layer V Hvis true, laster ned til et nytt lag. (Overstyrer brukerpreferanse, se #19308)
layer_name V Bare gyldig når dataene lastes inn i et nytt lag; Gir JOSM et hint om hvordan laget skal navngis
layer_locked V Bare gyldig når dataene lastes inn i et nytt lag; Hvis true, er det nye laget låst
download_policy V Bare gyldig når dataene lastes inn i et nytt lag; Hvis never, er nedlastning blokkert
upload_policy V Bare gyldig når dataene lastes inn i et nytt lag; Hvis never eller false, er opplasting blokkert eller frarådet
addtags V Valgfri parameter for å legge til tags. Nøkkelen og verdien er separert med "=" og flere tags kan separeres med en Pipe "|". Se detaljer.
select V Kommaseparert liste over objekter som skal velges. Objektspesifikatorer er kombinasjoner av ordene "way", "node", eller "relation", og det numeriske objekt-id. Eksempel: select=way38473,node12399,node54646. Siden r13212 lar spesialverdien currentselection JOSM beholde sitt forrige valg.
zoom_mode V download | selection, standard er selection
changeset_comment V Kommentar til endringssettet
changeset_source V Kilde til endringssettet
changeset_hashtags V Hashtags for endringssettet (siden r13109)
changeset_tags V Valgfri parameter for å legge til endringssett-tags. Nøkkelen og verdien er separert med "=" og flere tags kan separeres med en Pipe "|". Denne kommandoen bruker samme syntaks som addtags-parameteren. changeset_comment og changeset_source overstyrer for øyeblikket comment og source-tagsene som sendes i denne parameteren, men dette kan endres i fremtiden. (siden r15316)
search V Søk etter objekter i det nåværende datalaget. Se Søk

Eksempel

Start JOSM (ikke glem å aktivere RemoteControl-funksjonen), og klikk deretter på:

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

JOSM skal nå laste et område i det tyske Schwarzwald og ha den spesifiserte noden valgt.

zoom

Instruerer JOSM om å zoome til det spesifiserte området og eventuelt velge ett eller flere objekter. 

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

Aksepterer de samme parameterne som load_and_zoom-kommandoen og bruker den samme koden for zoom og valg. Den eneste forskjellen er at ingen data vil bli lastet ned fra API-en.

Hint: Denne kommandoen kan også brukes til bare å velge objekter. Bare skriv inn et lite vilkårlig område til left..bottom-oppføringene og legg til objektlisten til select=-alternativet.

import

Instruerer JOSM om å laste ned den spesifiserte OSM-filen og legge den til i det nåværende datasettet. 

GET /import?url=...

hvor

Parameter Obligatorisk/
Valgfri 		Betydning
url O Forespørsels-URL, inkludert mønstre. Må være den siste parameteren, alt etter "&url=" tolkes som URL, selv om det inneholder "&"-tegn.
new_layer V Hvis true, laster ned til et nytt lag. (Overstyrer brukerpreferanse, se #19308)
layer_name V Bare gyldig når dataene lastes inn i et nytt lag; Gir JOSM et hint om hvordan laget skal navngis
layer_locked V Bare gyldig når dataene lastes inn i et nytt lag; Hvis true, er det nye laget låst
download_policy V Bare gyldig når dataene lastes inn i et nytt lag; Hvis never, er nedlastning blokkert
upload_policy V Bare gyldig når dataene lastes inn i et nytt lag; Hvis never eller false, er opplasting blokkert eller frarådet
changeset_tags V Valgfri parameter for å legge til endringssett-tags. Nøkkelen og verdien er separert med "=" og flere tags kan separeres med en Pipe "|". Denne kommandoen bruker samme syntaks som addtags-parameteren. Først tilgjengelig i r16324.

load_data

(siden versjon 1.6)

Instruer JOSM om å laste OSM-data, direkte kodet i URL-en, i stedet for å komme fra en ekstern fil. Dette er bare egnet for mindre data (noen nettlesere begrenser maksimal URL-lengde), men det er raskere (siden ingen nedlastning er nødvendig), og i mange tilfeller der dynamisk genererte data er nødvendig, er det enklere å generere. 

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

hvor

Parameter Obligatorisk/
Valgfri 		Betydning
data O XML-dataene som skal lastes, disse bør være URL-kodet på en måte som også koder de spesielle tegnene &, = og ? til henholdsvis %26, %3D og %3F. JS ​encodeUriComponent()-metoden gir denne funksjonaliteten ut av boksen.
new_layer V Velg å laste dataene i et nytt lag. (Overstyrer brukerpreferanse, se #19308)
mime_type V Mime-type for dataene, standard er "application/x-osm+xml", som for øyeblikket er den eneste støttede mime-typen, men i fremtiden kan andre mime-typer bli støttet
layer_name V Bare gyldig når dataene lastes inn i et nytt lag; Gir JOSM et hint om hvordan laget skal navngis
layer_locked V Bare gyldig når dataene lastes inn i et nytt lag; Hvis true, er det nye laget låst
download_policy V Bare gyldig når dataene lastes inn i et nytt lag; Hvis never, er nedlastning blokkert
upload_policy V Bare gyldig når dataene lastes inn i et nytt lag; Hvis never eller false, er opplasting blokkert eller frarådet

open_file

Åpne en lokal fil i JOSM. 

GET /open_file?filename=...

hvor

Parameter Obligatorisk/
Valgfri 		Betydning
filename O Den lokale filen som skal åpnes i JOSM (f.eks: /tmp/test.osm)

imagery

Instruerer JOSM om å legge til et bilde (WMS/TMS)-lag. 

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

hvor

Parameter Obligatorisk/
Valgfri 		Betydning
url O eller id Forespørsels-URL, inkludert mønstre. Må være den siste parameteren, alt etter "&url=" tolkes som URL, selv om det inneholder "&"-tegn.
id O eller url Bildets ID i JOSM, se Maps (siden r17655).
title V Visningsnavnet på laget
type V Type lag. Mulige verdier er wms, tms og bing (standard er wms, siden RemoteControl Versjon 1.3)
cookies V
min_zoom V Minimum zoomnivå (siden RemoteControl Versjon 1.4)
max_zoom V Maksimum zoomnivå. For høyere skalaer blir bildene av maksimalnivået forstørret (siden RemoteControl Versjon 1.4)
name V alias for title (siden RemoteControl Versjon 1.10)
attribution-text V (siden RemoteControl Versjon 1.10)
attribution-url V (siden RemoteControl Versjon 1.10)
bestMarked V (siden RemoteControl Versjon 1.10)
bounds V (siden RemoteControl Versjon 1.10)
category V (siden RemoteControl Versjon 1.10)
country-code V (siden RemoteControl Versjon 1.10)
customHttpHeaders V (siden RemoteControl Versjon 1.10)
date V (siden RemoteControl Versjon 1.10)
default-layers V (siden RemoteControl Versjon 1.10)
description V (siden RemoteControl Versjon 1.10)
eula V (siden RemoteControl Versjon 1.10)
icon V (siden RemoteControl Versjon 1.10)
id V (siden RemoteControl Versjon 1.10)
logo-image V (siden RemoteControl Versjon 1.10)
logo-url V (siden RemoteControl Versjon 1.10)
metadataHeaders V (siden RemoteControl Versjon 1.10)
minimumTileExpire V (siden RemoteControl Versjon 1.10)
modTileFeatures V (siden RemoteControl Versjon 1.10)
noTileChecksums V (siden RemoteControl Versjon 1.10)
noTileHeaders V (siden RemoteControl Versjon 1.10)
overlay V (siden RemoteControl Versjon 1.10)
permission-reference-url V (siden RemoteControl Versjon 1.10)
pixel-per-eastnorth V (siden RemoteControl Versjon 1.10)
projections V (siden RemoteControl Versjon 1.10)
shapes V (siden RemoteControl Versjon 1.10)
terms-of-use-text V (siden RemoteControl Versjon 1.10)
terms-of-use-url V (siden RemoteControl Versjon 1.10)
tileSize V (siden RemoteControl Versjon 1.10)
transparent V (siden RemoteControl Versjon 1.10)
type V (siden RemoteControl Versjon 1.10)
valid-georeference V (siden RemoteControl Versjon 1.10)

Eksempler

  • TMS-lag "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-lag "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"-lag

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

load_object

Instruerer JOSM om å laste ned objekter med en gitt id. 

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

hvor

Parameter Obligatorisk/
Valgfri 		Betydning
objects O Kommaseparert liste over objekt-id-er, f.eks. "n1234,n1235,w84,r958493"
new_layer V Hvis true, laster ned til et nytt lag. (Overstyrer brukerpreferanse, se #19308)
addtags V Valgfri parameter for å legge til tags. Nøkkelen og verdien er separert med "=" og flere tags kan separeres med en Pipe "|". Se detaljer.
relation_members V Hvis true, laster også ned objekter som er medlemmer av relasjonene.
referrers V Hvis true, laster også ned referanser til objektet. Dvs. overordnede relasjoner, og for noder, i tillegg, overordnede veier. (siden r6782)
layer_name V Bare gyldig når dataene lastes inn i et nytt lag; Gir JOSM et hint om hvordan laget skal navngis
layer_locked V Bare gyldig når dataene lastes inn i et nytt lag; Hvis true, er det nye laget låst
download_policy V Bare gyldig når dataene lastes inn i et nytt lag; Hvis never, er nedlastning blokkert
upload_policy V Bare gyldig når dataene lastes inn i et nytt lag; Hvis never eller false, er opplasting blokkert eller frarådet

Eksempel

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

add_node

Instruerer JOSM om å opprette en ny node ved de gitte koordinatene.

Merk: Denne handlingen krever tillatelsen Opprette nye objekter som er deaktivert som standard. 

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

hvor

Parameter Obligatorisk/
Valgfri 		Betydning
lon O Lengdegraden til noden
lat O Breddegraden til noden
addtags V Valgfri parameter for å legge til tags. Nøkkelen og verdien er separert med "=" og flere tags kan separeres med en Pipe "|". Se detaljer. (siden v1.5)

Eksempel

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

add_way

Instruerer JOSM om å opprette en ny vei med nye veinoder ved gitte koordinater.

Merk: Denne handlingen krever tillatelsen Opprette nye objekter som er deaktivert som standard. 

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

hvor

Parameter Obligatorisk/
Valgfri 		Betydning
way O Par av breddegrad, lengdegrad koordinater separert med semikolon.
addtags V Valgfri parameter for å legge til tags. Nøkkelen og verdien er separert med "=" og flere tags kan separeres med en Pipe "|". Se detaljer. (siden v1.5)

Eksempel

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

version

Denne kommandoen returnerer den nåværende protokollversjonen av den installerte RemoteControl-grensesnittet. Utviklere kan bruke den til å spørre etter en kjørende forekomst av JOSM og også bestemme om den forespurte funksjonaliteten er tilgjengelig i klienten. 

GET /version[?jsonp=callback]

hvor

Parameter Obligatorisk/
Valgfri 		Betydning
jsonp V Jsonp callback for eldre nettlesere som ikke implementerer ​​Cross-Origin Resource Sharing (CORS)

Kommandoen returnerer et json-objekt som inneholder en applikasjonsidentifikator som alltid er "JOSM RemoteControl", et hovednummer og et undernummer. Kompatible protokollendringer resulterer i en økning av undernummeret. Inkompatible endringer øker hovednummeret. Så en klientapplikasjon som kjenner til protokollversjon 1.0 kan fortsatt snakke med JOSM som har 1.1. Men det er ikke garantert at den vil fungere med 2.0. Så klienten bør verifisere hovednummeret.

En typisk utdata ser slik ut: 

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

For eldre nettlesere som ikke implementerer ​Cross-Origin Resource Sharing (CORS) gir kommandoen muligheten for jsonp callback. Last URL-en i en script-tag og oppgi navnet på en callback som vil motta JSON-dataene.

Følgende er noen eksempelkode som sjekker for CORS-funksjonalitet og bruker ​JSONP som en fallback-løsning. 

// i tillegg til CC-BY-SA av wikien, vær så snill å bruke følgende kilde til enhver hensikt uten restriksjoner (PD)
// kreditter og tillegg verdsatt: https://wiki.openstreetmap.org/wiki/User:Stephankn

function checkJOSM(version){
   alert(version.application + " bruker protokollversjon " + version.protocolversion.major + "." + version.protocolversion.minor);
   // gjør noe nyttig, kanskje vise redigeringsknapp
}

var url = "http://127.0.0.1:8111/version";
var useFallback = false;
// for øyeblikket FF3.5, Safari 4 og IE8 implementerer 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 {
   // ingen XMLHttpRequest tilgjengelig
   useFallback = true;
}

if (useFallback) {
   // Bruk eldre jsonp kall
   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 som ​OpenAPI Specification

Legge til, endre eller slette tags

Prøv dette eksemplet: ​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. (Fungerer også med zoom-kommandoen)

Brukeren må gjennomgå taggene og valget før taggene blir brukt på de valgte objektene. Hvis taggen eksisterer på noen objekter, vil den bli erstattet.

Siden protokollversjon 1.5

  • add_node og add_way kommandoer støtter addtags parameter
  • Det er mulig å bruke = tegn i verdi og alle ledende/avsluttende mellomrom blir trimmet.

​http://localhost:8111/add_node?lon=13.3&lat=53.2&addtags=natural=tree%7Cname=%20%20%20==Great%20Oak== (oppretter node med natural=tree og name="==Great Oak==")

  • Hvis tom verdi blir funnet, skal taggen slettes fra objekter (avkrysningsbokskonfirmasjon er nødvendig)

​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.

Andre kommandoer

Remotecontrol tillater andre plugins å legge til ytterligere kommandoer. Den andre registrerer en RequestHandler-klasse og spesifiserer en kommando som skal håndteres av denne klassen. Kommandosyntaksen må defineres av den andre pluginen.

Reverter

Reverter-plugin siden versjon 27091 bruker denne funksjonen. Se RevertChangesetHandler.java​.

Mapillary

Se ​MapillaryRemoteControl.java. Enten sequence eller photo må spesifiseres, men ikke begge. Siden fjernkontrollklassen ble skrevet for flere bilderessurser, må id for enten sequence eller photo prefikses med Mapillary/.

Kompilering av plugin fjernkontrollkommandoer

Plugin Kommando Parameter Obligatorisk/
Valgfri 		Betydning
Reverter revert_changeset Basekommando for å tilbakeføre et endringssett
id O Endringssett-id som skal brukes (bør matche regex [0-9]+)
MapWithAI mapwithai Basekommando for å laste ned MapWithAI-data
max_obj V Sett maksimalt antall objekter brukeren kan legge til per handling fra MapWithAI-laget. Bør matche regex [0-9]+.
switch_layer V Bruk hvis du vil tvinge brukere til automatisk å bytte lag når de legger til data til OSM. Tar true/false.
bbox V Bbox som skal lastes ned (lat,lon,lat,lon -- antar at bbox ikke krysser meridianen)
crop_bbox V Beskjær nedlastede MapWithAI-data (kun veier) til denne bbox. Oppgaveadministratorer kan også generere et velkjent lag.
url V URL som skal brukes i stedet for de innebygde datakildene. Nyttig for importer (vær sikker på at du har gått gjennom importprosessen).
source V Kilden som skal brukes når du laster opp til OSM (endringssettkilde)
Mapillary photo Basekommando for å laste ned et Mapillary-bilde (kan utvides til andre bilderessurser i fremtiden)
photo O/V Id til bildet som skal vises og lastes ned. Enten dette eller sequence må spesifiseres.
sequence O/V Id til sekvensen som skal vises og lastes ned. Første bilde vises i bildetilskueren.

Tilbake til Fjernkontrollpreferanser
Tilbake til Preferanser
Tilbake til Hovedhjelp

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