Search:
Login
Preferences
Help/Guide
About Trac
Register
Forgot your password?
Wiki
Timeline
Changelog
Browse Source
View Tickets
New Ticket
Roadmap
Builds
Sonar
Search
Context Navigation
+0
Start Page
Index
History
Editing Nb:Help/RemoteControlCommands
Adjust edit area height:
8
12
16
20
24
28
32
36
40
Edit side-by-side
[[TranslatedPages(revision=25, outdated=Denne siden mangler kommandoegenskaper.)]] [[PageOutline(3-3,Fjernkontrollkommandoer,inline)]] == 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}}} ===#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 [wikitr:/Help/Action/LockedLayer låst] || || `download_policy` || V || Bare gyldig når dataene lastes inn i et nytt lag; Hvis '''never''', er nedlastning [wikitr:/Help/Action/BlockDownload blokkert] || || `upload_policy` || V || Bare gyldig når dataene lastes inn i et nytt lag; Hvis '''never''' eller '''false''', er opplasting [wikitr:/Help/Action/EncourageDiscourageUpload 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 [#addtags 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 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 [wikitr:/Help/Action/Search 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 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 [wikitr:/Help/Action/LockedLayer låst] || || `download_policy` || V || Bare gyldig når dataene lastes inn i et nytt lag; Hvis '''never''', er nedlastning [wikitr:/Help/Action/BlockDownload blokkert] || || `upload_policy` || V || Bare gyldig når dataene lastes inn i et nytt lag; Hvis '''never''' eller '''false''', er opplasting [wikitr:/Help/Action/EncourageDiscourageUpload 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 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 [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent 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 [wikitr:/Help/Action/LockedLayer låst] || || `download_policy` || V || Bare gyldig når dataene lastes inn i et nytt lag; Hvis '''never''', er nedlastning [wikitr:/Help/Action/BlockDownload blokkert] || || `upload_policy` || V || Bare gyldig når dataene lastes inn i et nytt lag; Hvis '''never''' eller '''false''', er opplasting [wikitr:/Help/Action/EncourageDiscourageUpload 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}}} ===#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 [#addtags 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 [wikitr:/Help/Action/LockedLayer låst] || || `download_policy` || V || Bare gyldig når dataene lastes inn i et nytt lag; Hvis '''never''', er nedlastning [wikitr:/Help/Action/BlockDownload blokkert] || || `upload_policy` || V || Bare gyldig når dataene lastes inn i et nytt lag; Hvis '''never''' eller '''false''', er opplasting [wikitr:/Help/Action/EncourageDiscourageUpload 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 [#addtags 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 [#addtags 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: {{{ #!js { "protocolversion": { "major": 1, "minor": 0 }, "application": "JOSM RemoteControl", "version": 16587 // JOSM versjon (siden r16587) } }}} For eldre nettlesere som ikke implementerer [http://en.wikipedia.org/wiki/Cross-Origin_Resource_Sharing 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 [http://en.wikipedia.org/wiki/JSONP JSONP] som en fallback-løsning. {{{ #!js // 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 [https://swagger.io/specification/ OpenAPI Specification] * http://localhost:8111/openapi.json * https://petstore.swagger.io/?url=http://localhost:8111/openapi.json === Legge til, endre eller slette tags === #addtags 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 [source:osm/applications/editors/josm/plugins/reverter/src/reverter/RevertChangesetHandler.java RevertChangesetHandler.java]. ==== Mapillary ==== Se [https://github.com/JOSM/Mapillary/blob/master/src/main/java/org/openstreetmap/josm/plugins/mapillary/io/remotecontrol/MapillaryRemoteControl.java 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 [wikitr:/Help/Preferences/RemoteControl Fjernkontrollpreferanser] \\ Tilbake til [wikitr:/Help/Preferences Preferanser] \\ Tilbake til [wikitr:/Help Hovedhjelp]
Note:
See
WikiFormatting
and
TracWiki
for help on editing wiki content.
Change information
Your email or username:
E-mail address and name can be saved in the
Preferences
Comment about this change (optional):
Note:
See
TracWiki
for help on using the wiki.