wiki:Fr:Help/RemoteControlCommands

Il manque des fonctions de commande sur cette page.

Autres langues:

Commandes de contrôle à distance

  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. Ajout, modification ou suppression d'attributs
  13. Autres commandes

Liste des Commandes

Une liste complète des commandes et des paramètres obligatoires/facultatifs est présentée à l'adresse ​http://127.0.0.1:8111/ (lorsque JOSM est en cours d'exécution).

load_and_zoom

Demande à JOSM de télécharger une zone délimitée à partir de l'API, de zoomer sur la zone téléchargée et de sélectionner éventuellement un ou plusieurs objets. 

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

Détails

Paramètres Obligatoires/
Facultatifs 		Signification
bottom O Latitude minimale
top O Latitude maximale
left O Longitude minimale
right O Longitude maximale
new_layer F Si c'est (vrai) true, les téléchargements se font sur un nouveau calque. (Remplace les préférences de l'utilisateur, voir #19308)
layer_name F Valable uniquement lorsque les données sont chargées dans un nouveau calque ; Donne à JOSM un indice sur la façon de nommer le calque
layer_locked F Valable uniquement lorsque les données sont chargées dans un nouveau calque ; si (vrai) true, le nouveau calque est locked (verrouillé)
download_policy F Valable uniquement lorsque les données sont chargées dans un nouveau calque ; si la valeur est never (jamais) le téléchargement est blocked (bloqué)
upload_policy F Valable uniquement lorsque les données sont chargées dans un nouveau calque ; si la valeur est never (jamais) ou false (faux), l'envoi est blocked (bloqué) ou discouraged (déconseillé)
addtags F Paramètre facultatif pour l'ajout d'attributs. La clé et la valeur sont séparées par "=" et plusieurs attributs peuvent être séparés par un pipe "|". Voir les détails.
select F Liste d'objets à sélectionner, séparés par des virgules. Les spécificateurs d'objets sont des combinaisons des mots "way", "node", ou "relation", et de l'identifiant numérique de l'objet Id). Exemple : select=way38473,node12399,node54646. Depuis r13212, la valeur spéciale currentselection (sélection actuelle) permet à JOSM de conserver sa sélection précédente.
zoom_mode F download | selection, sélection par défaut
changeset_comment F Commentaire du groupe de modifications
changeset_source F Source du groupe de modifications
changeset_hashtags F Hashtags du groupe de modifications (depuis r13109)
changeset_tags F Paramètre optionnel pour ajouter des attributs à un groupe de modifications. La clé et la valeur sont séparées par "=" et plusieurs attributs peuvent être séparés par un pipe "|". Cette commande utilise la même syntaxe que le paramètre ajouter des attributs. Actuellement, changeset_comment et changeset_source remplacent les attributs comment et source passés dans ce paramètre, mais cela pourrait changer dans le futur (depuis r15316)
search F Recherche des objets dans la calque de données actif. Voir Rechercher

Exemple

Démarrez JOSM (n'oubliez pas d'activer la fonction Contrôle à distance "RemoteControl"), puis cliquez sur :

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

JOSM devrait maintenant charger une zone dans le Schwarzwald allemand et avoir sélectionné le nœud spécifié.

zoom

Demande à JOSM de zoomer sur la zone spécifiée et de sélectionner éventuellement un ou plusieurs objets. 

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

Accepte les mêmes paramètres que la commande load_and_zoom et utilise le même code pour le zoom et la sélection. La seule différence est qu'aucune donnée ne sera chargée à partir de l'API.

Conseil : Cette commande peut également être utilisée pour sélectionner uniquement des objets. Il suffit d'entrer une petite zone arbitraire aux entrées left..bottom et d'ajouter la liste d'objets à l'option select=.

import

Demande à JOSM de télécharger le fichier OSM spécifié et de l'ajouter à l'ensemble des données actives. 

GET /import?url=...

Détails

Paramètres Obligatoires/
Facultatifs 		Signification
url O L'URL demandée, incluant les modèles. Doit être le dernier paramètre, tout ce qui suit "&url=" est interprété comme une URL, même s'il contient les caractères "&".
new_layer F Si true (vrai), télécharge vers un nouveau calque. (Remplace les préférences de l'utilisateur, voir #19308)
layer_name F Seulement valable lorsque les données sont chargées dans un nouveau calque ; donne à JOSM l'indication sur la façon de nommer le calque
layer_locked F Valable uniquement lorsque les données sont chargées dans un nouveau calque ; si true (vrai), le nouveau calque est locked (verrouillé)
download_policy F Valable uniquement lorsque les données sont chargées dans un nouveau calque ; si never (jamais), le téléchargement est blocked (bloqué)
upload_policy F Valable uniquement lorsque les données sont chargées dans un nouveau calque ; si never (jamais) ou false (faux), l'envoi est bloqué ou déconseillé
changeset_tags F Paramètre facultatif pour ajouter des attributs à un groupe de modifications. La clé et la valeur sont séparées par "=" et plusieurs attributs peuvent être séparés par un pipe "|". Cette commande utilise la même syntaxe que le paramètre ajout d'attributs. Disponible pour la première fois dans r16324.

load_data

(depuis la version 1.6)

Demande à JOSM de charger les données OSM, directement encodées dans l'URL, au lieu de provenir d'un fichier externe. Cette solution ne convient qu'aux données de petite taille (certains navigateurs limitent la longueur maximale de l'URL), mais elle est plus rapide (puisqu'aucun téléchargement n'est nécessaire) et, dans de nombreux cas où des données générées dynamiquement sont nécessaires, cela est plus facile à générer. 

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

Détails

Paramètres Obligatoires/
Facultatifs 		Signification
data O Les données XML à charger doivent être codées en URL d'une manière qui code également les caractères spéciaux &, = et ? respectivement vers %26, %3D et %3F. La méthode JS ​encodeUriComponent() fournit cette fonctionnalité dès le départ.
new_layer F Choisissez de charger les données dans un nouveau calque. (Remplace les préférences de l'utilisateur, voir #19308)
mime_type F Type mime des données, par défaut c'est "application/x-osm+xml", qui est actuellement le seul type mime supporté, mais à l'avenir d'autres types mimes pourraient être supportés
layer_name F Seulement valable lorsque les données sont chargées dans un nouveau calque ; donne à JOSM une indication sur la façon de nommer le calque
layer_locked F Valable uniquement lorsque les données sont chargées dans un nouveau calque ; si true (vrai), le nouveau calque est locked (verrouillé)
download_policy F Valable uniquement lorsque les données sont chargées dans un nouveau calque ; si never (jamais), le téléchargement est blocked (bloqué)
upload_policy F Valable uniquement lorsque les données sont chargées dans un nouveau calque ; si never (jamais) ou false (faux), l'envoi est bloqué ou déconseillé

open_file

Ouvre un fichier local dans JOSM. 

GET /open_file?filename=...

Détails

Paramètres Obligatoires/
Facultatifs 		Signification
filename O Le fichier local à ouvrir dans JOSM ( par exemple : /tmp/test.osm)

imagery

Demande à JOSM d'ajouter un calque d'imagerie (WMS/TMS). 

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

Détails

Paramètres Obligatoires/
Facultatifs 		Signification
url O ou id L'URL de la demande, y compris les modèles. Doit être le dernier paramètre, tout ce qui suit "&url=" est interprété comme une URL, même s'il contient des caractères "&".
id O ou url L'ID de l'imagerie dans JOSM, voir les sources d'Imageries (depuis r17655).
title F Le nom affiché du calque
type F Le type de calque. Les valeurs possibles sont wms, tms et bing (par défaut wms, depuis la version 1.3 de RemoteControl)
cookies F
min_zoom F Le niveau de zoom minimum (depuis la Version 1.4 RemoteControl)
max_zoom F Le niveau de zoom maximum. Pour les échelles supérieures, les images du niveau maximum sont agrandies (depuis la Version 1.4 de RemoteControl)
name F alias pour title (depuis la Version 1.10 de RemoteControl)
attribution-text F (depuis la version 1 de RemoteControl)
attribution-url F (depuis la version 1 de RemoteControl)
bestMarked F (depuis la version 1 de RemoteControl)
bounds F (depuis la version 1 de RemoteControl)
category F (depuis la version 1 de RemoteControl)
country-code F (depuis la version 1 de RemoteControl)
customHttpHeaders F (depuis la version 1 de RemoteControl)
date F (depuis la version 1 de RemoteControl)
default-layers F (depuis la version 1 de RemoteControl)
description F (depuis la version 1 de RemoteControl)
eula F (depuis la version 1 de RemoteControl)
icon F (depuis la version 1 de RemoteControl)
id F (depuis la version 1 de RemoteControl)
logo-image F (depuis la version 1 de RemoteControl)
logo-url F (depuis la version 1 de RemoteControl)
metadataHeaders F (depuis la version 1 de RemoteControl)
minimumTileExpire F (depuis la version 1 de RemoteControl)
modTileFeatures F (depuis la version 1 de RemoteControl)
noTileChecksums F (depuis la version 1 de RemoteControl)
noTileHeaders F (depuis la version 1 de RemoteControl)
overlay F (depuis la version 1 de RemoteControl)
permission-reference-url F (depuis la version 1 de RemoteControl)
pixel-per-eastnorth F (depuis la version 1 de RemoteControl)
projections F (depuis la version 1 de RemoteControl)
shapes F (depuis la version 1 de RemoteControl)
terms-of-use-text F (depuis la version 1 de RemoteControl)
terms-of-use-url F (depuis la version 1 de RemoteControl)
tileSize F (depuis la version 1 de RemoteControl)
transparent F (depuis la version 1 de RemoteControl)
type F (depuis la version 1 de RemoteControl)
valid-georeference F (depuis la version 1 de RemoteControl)

Exemples

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

  • calque WMS "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

  • calque "Bing"

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

load_object

Demande à JOSM de télécharger les objets avec un identifiant donné. 

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

Détails

Paramètres Obligatoires/
Facultatifs 		Signification
objects O Liste d'identifiants d'objets séparés par des virgules, par exemple "n1234,n1235,w84,r958493"
new_layer F Si true (vrai), télécharge vers un nouveau calque. (Remplace les préférences de l'utilisateur, voir #19308)
addtags F Paramètre facultatif pour l'ajout d'attributs. La clé et la valeur sont séparées par "=" et plusieurs attributs peuvent être séparés par un pipe "|". Voir les détails sur l'ajout d'attributs.
relation_members F Si true (vrai), télécharge également les objets membres des relations.
referrers F Si true (vrai), télécharge également les référants de l'objet. C'est-à-dire les relations parentes, et pour les nœuds, en plus, les chemins parents. (depuis r6782)
layer_name F Seulement valable lorsque les données sont chargées dans un nouveau calque ; donne à JOSM une indication sur la façon de nommer le calque
layer_locked F Valable uniquement lorsque les données sont chargées dans un nouveau calque ; si true (vrai), le nouveau calque est locked (verrouillé)
download_policy F Valable uniquement lorsque les données sont chargées dans un nouveau calque ; si never (jamais), le téléchargement est blocked (bloqué)
upload_policy F Valable uniquement lorsque les données sont chargées dans un nouveau calque ; si never (jamais) ou false (faux), l'envoi est bloqué ou déconseillé

Exemple

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

add_node

Charge JOSM de créer un nouveau nœud aux coordonnées données.

Note : Cette action nécessite l'autorisation de Créer de nouveaux objets qui est désactivée par défaut. 

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

Détails

Paramètres Obligatoires/
Facultatifs 		Signification
lon O La longitude du nœud
lat O La latitude du nœud
addtags F Paramètre facultatif pour l'ajout d'attributs. La clé et la valeur sont séparées par "=" et plusieurs attributs peuvent être séparés par un pipe "|". Voir les détails sur l'ajout d'attributs. (depuis la v1.5)

Exemple

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

add_way

Charge JOSM de créer un nouveau chemin avec de nouveaux nœuds pour le chemin à des coordonnées données.

Note : Cette action nécessite l'autorisation de Créer de nouveaux objets qui est désactivée par défaut. 

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

Détails

Paramètres Obligatoires/
Facultatifs 		Signification
way O Paires de coordonnées de latitude et de longitude séparées par un point-virgule.
addtags F Paramètre facultatif pour l'ajout d'attributs. La clé et la valeur sont séparées par "=" et plusieurs attributs peuvent être séparés par un pipe "|". Voir les détails sur l'ajout d'attributs. (depuis la v1.5)

Exemple

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

version

Cette commande renvoie la version actuelle du protocole de l'interface RemoteControl installée. Les développeurs peuvent l'utiliser pour demander une instance de JOSM en cours d'exécution et également déterminer si la fonctionnalité demandée est disponible dans le client. 

GET /version[?jsonp=callback]

Détails

Paramètres Obligatoires/
Facultatifs 		Signification
jsonp F Rappel Jsonp pour les navigateurs plus anciens qui ne mettent pas en œuvre le partage de ressources entre origines "​Cross-Origin Resource Sharing" (CORS)

La commande renvoie un objet json contenant un identifiant d'application qui est toujours "JOSM RemoteControl", un nombre majeur et un nombre mineur. Les changements de protocole compatibles entraînent une augmentation du nombre mineur. Les modifications incompatibles entraînent une augmentation du nombre majeur. Ainsi, une application cliente connaissant la version 1.0 du protocole peut toujours parler à JOSM ayant la version 1.1. Mais il n'est pas garanti qu'il fonctionne avec la version 2.0. Le client doit donc vérifier le nombre majeur.

Un résultat classique se présente comme suit : 

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

Pour les navigateurs plus anciens qui ne mettent pas en œuvre le ​partage de ressources entre origines (Cross-Origin Resource Sharing : CORS) la commande offre la possibilité d'un rappel jsonp. Chargez l'URL dans un attribut de script et fournissez le nom d'un rappel qui recevra les données JSON.

Voici un exemple de code qui vérifie les capacités CORS et utilise ​JSONP comme solution de repli. 

// in addition to the CC-BY-SA of the wiki feel free to use the following source for any purpose without restrictions (PD)
// credits and additions appreciated: https://wiki.openstreetmap.org/wiki/User:Stephankn

function checkJOSM(version){
   alert(version.application + " uses protocol version " + version.protocolversion.major + "." + version.protocolversion.minor);
   // do something useful, maybe showing edit button
}

var url = "http://127.0.0.1:8111/version";
var useFallback = false;
// currently FF3.5, Safari 4 and IE8 implement 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 {
   // no XMLHttpRequest available
   useFallback = true;
}

if (useFallback) {
   // Use legacy jsonp call
   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

Le controle à distance de JOSM selon les ​spécifications OpenAPI

Ajout, modification ou suppression d'attributs

Essayez l'exemple suivant : ​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. (Fonctionne également avec la commande de zoom)

L'utilisateur doit examiner les attributs et la sélection avant que les attributs ne soient appliqués aux objets sélectionnés. Si l'attribut existe sur certains objets, il sera remplacé.

Depuis la version 1.5 du protocole

  • Les commandes add_node et add_way supportent le paramètre addtags
  • Il est possible d'utiliser le caractère = en valeur et tous les espaces de début et de fin sont supprimés.

​http://localhost:8111/add_node?lon=13.3&lat=53.2&addtags=natural=tree%7Cname=%20%20%20==Great%20Oak== (crée un nœud avec les attributs natural=tree et name="==Great Oak==")

  • Si une valeur vide est trouvée, l'attribut doit être supprimé des objets (une case à cocher de confirmation est nécessaire)

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

Autres commandes

La télécommande permet à d'autres greffons d'ajouter des commandes supplémentaires. Les autres greffons enregistrent une classe RequestHandler et spécifient une commande à traiter par cette classe. La syntaxe de la commande doit être définie par les autres greffons..

Reverter

Le greffon Reverter utilise cette fonctionnalité, depuis la version 27091. Voir RevertChangesetHandler.java​.

Mapillary

Voir ​MapillaryRemoteControl.java. Il faut spécifier soit sequence soit photo, mais pas les deux. Comme la classe de la télécommande a été écrite pour plusieurs sources d'images, l'identifiant de sequence ou de photo doit être préfixé par Mapillary/.

Compilation des commandes de la télécommande des greffons (Compilation of plugin remote control commands)

Greffon Commande Paramètre Nécessaire/
Facultatif 		Signification
Reverter revert_changeset Commande de base pour annuler un groupe de modifications.
id N L'identifiant de l'ensemble de changement à utiliser (doit correspondre à une expression rationnelle (regex) [0-9]+).
MapWithAI mapwithai Commande de base pour télécharger les données de MapWithAI.
max_obj F Définit le nombre maximum d'objets que l'utilisateur peut ajouter par action à partir de la couche MapWithAI. Doit correspondre à une expression rationnelle (regex) [0-9]+.
switch_layer F Utilisez si vous voulez forcer les utilisateurs à changer automatiquement de couche lorsqu'ils ajoutent des données à OSM. Accepte true/false.
bbox F La zone bbox à télécharger (lat,lon,lat,lon -- suppose que la zone bbox ne traverse pas le méridien)).
crop_bbox F Recadrer les données MapWithAI téléchargées (uniquement les routes) dans cette bbox. Les gestionnaires de tâches peuvent également générer un calque bien connu.
url F L'URL à utiliser à la place des sources de données intégrées. Utile pour les importations (veuillez vous assurer que vous avez suivi le processus d'importation).
source F Source à utiliser lors de l'envoi des données vers OSM (source du groupe de modifications).
Mapillary photo Commande de base pour télécharger une photo Mapillary (pourra être étendue à d'autres sources d'imagerie dans le futur).
photo N/F L'identifiant de l'image à afficher et à télécharger. Il faut spécifier celui-ci, soit sequence.
sequence N/F L'identifiant de la séquence à afficher et à télécharger. La première image est affichée dans le visualiseur d'images.

Voir également

  • La version originale de cette page en anglais

Retour aux Préférences Contrôle à distance
Retour aux Préférences
Retour à l'Aide Principale

Last modified 2 years ago Last modified on 2021-12-16T18:16:04+01:00
Note: See TracWiki for help on using the wiki.