FR:ComcomMaker

From OpenStreetMap Wiki
Jump to: navigation, search

ComcomMaker est un outil en ligne pour la synthèse d'entité administratives territoriales.

Installation

ComcomMaker est hébergé à l'adresses suivante : http://comcommaker.openstreetmap.fr

Il n'y a rien à installer !

Sauf peut-être accessoirement Firefox, puisque ComcomMaker n'a pas été testé sur d'autres navigateurs.

Et JOSM, ou peut-être Merkaartor, pour éditer la *relation produite par ComcomMaker.

Son code est consultable sur : https://github.com/FrViPofm/ComcomMaker

Présentation

L'écran de ComcomMaker

La page présente, à l'état basique :

  • à gauche, une carte classique (apparemment) ,
  • une zone, à droite contenant :
    • le nom du programme : ComcomMaker, une boite à cocher : basic et un bouton d'aide qui mène à cette page.
    • deux menus déroulants : Choisir et Construire, avec, respectivement, les valeurs par défaut Commune et Communauté de communes.
    • deux boutons : Effacer et Éditer, tous deux désactivés

Utilisation

Dans la suite, on supposera que vous désirez composer une communauté de commune à partir du pourtour des communes la composant. Lorsque des opérations échappant à ce cas seront nécessaires, elle seront indiquées.

Choisir

Le premier menu déroulant Choisir permet de sélectionner le type d'entités à partir desquelles sera composée l'entité voulue, par exemple des communes pour une communauté de commune.

Si vous devez composer une entité à partir d'autres types de collectivités, sélectionnez la valeur correspondant à ces dernières.

Construire

Le second menu permet de choisir le type d'entité qui sera composé, par défaut une Communauté de commune. Mais vous pouvez choisir une autre valeur : Communauté d’agglomération, Communauté urbaine ou autre.

Éditer les tags

L'éditeur de *tags de ComcomMaker.
Le tag note a été ajouté à la liste.
Le tag ref:INSEE, vide, sera ignoré.

À droite du sélecteur, au survol de celui-ci, une icône apparaît. Un clic sur celle-ci ouvre un éditeur.

Dans l'éditeur, chaque *tag apparaît sur une ligne avec sa *clef et un champ de saisie pour la valeur. Certaines valeurs sont déjà pré-remplies selon le type d'entité à définir.

Au survol d'un champ, un bouton d'aide apparaît sur la droite. Un clic sur ce bouton ouvre la page du présent wiki sur l'article concernant le tag.

An bas de l'éditeur, trois boutons permettent respectivement :

  1. de fermer l'éditeur en annulant les modifications,
  2. d'ajouter un nouveau tag. Une fenêtre permet alors de saisir le nom de la clef.
  3. d'enregistrer les modifications et fermer la fenêtre.


Les tags ayant une valeur vide sont ignorés.
Dans l'exemple ci-contre, le tag ref:INSEE ne sera pas retenu dans l'entité composée.

Sélectionner les entités

Placez la carte sur l'endroit voulu, et zoomez à un niveau suffisant pour le travail.

Choisissez une entité composant votre "communauté de commune" d'un clic au dessus de celles-ci.

ComcomLoading.gif

Pendant que ComcomMaker cherche l'identifiant de relation de cette collectivité, une molette tourne à droite du titre Liste indiquant le travail.

Lorsque les information sur l'entité sont parvenues à ComcomMaker, la molette disparaît, le nom de la collectivité s'affiche dans la liste et le pourtour de celle-ci apparaît sur la carte.

Vous pouvez sélectionner une autre entité. Il n'est pas nécessaire d'attendre le retour d'information pour continuer la sélection : la recherche s’effectue en tâche de fond.

Remarques

Lorsqu'aucune entité correspondant aux critère n'est trouvée à l'endroit du clic, un avertissement est retourné pour en informer l'utilisateur.
Une entité ne peut être ajoutée deux fois. ComcomMaker vérifie qu'une collectivité n'est pas présente dans la liste avant de l'ajouter.
La liste est triée par ordre alphabétique. Toutefois, les caractères accentués pourraient ne pas être traité selon le classement habituel et être renvoyés en fin de liste.
Dès qu'une collectivité est présente dans la liste, les boutons Effacer et Éditer sont activés.

Supprimer une entité

Il est possible de supprimer une entité ajoutée par erreur. Il suffit de cliquer sur l'icône - à gauche de son nom dans la liste. Cette entité pourra être ajoutée à nouveau.

Éditer

Lorsque toutes les entités composant la collectivité sont présentes dans la liste, le bouton Éditer permet une série d'actions en cascades :

  • La liste des identifiants de relations et des *balises est envoyée au serveur,
  • Le serveur demande la description de celles-ci au serveur d'OpenStreetMap,
  • Lorsqu'il reçoit les descriptions, il extrait les *chemins de celles-ci,
  • puis il élimine les chemins en double, correspondant à une frontière mitoyenne interne à l'entité définitive et ne garde que les frontières extérieures.
  • Il compose une nouvelle relation comprenant les chemins,
  • et ajoute les *balises voulues.
  • Il enregistre la relation dans un fichier *.osm en cache,
  • et renvoie l'adresse de ce fichier au navigateur.
  • Le navigateur transmet à *JOSM, via remoteControl l'adresse du ficher.
  • JOSM charge le fichier pour permettre de compléter les informations.
Le résultat de ComcomMaker dans JOSM

Remarques

Il faut ouvrir JOSM avant d'envoyer les données au serveur pour édition et l'outil remoreControl doit être activé dans les préférences de JOSM.
Le fichier chargé par JOSM est un fichier minimal qui ne comprend que les identifiant de chemins composant la relation mais qui ne comprend pas ces chemins. C'est dans JOSM qu'il faut charger les membres de celle_ci.
ComcomMaker ne sait pas encore traiter le cas d'un problème de connexion entre le serveur et la base OpenStreetMap. Si le cas se produit, il est possible que la molette tournera indéfiniment. Un second clic sur le bouton envoyer devrait permettre de relancer le processus de synthèse, mais sans faire disparaître la molette.

Effacer

Le bouton Effacer vide la liste et supprime les pourtours de la carte, et permet de commencer une nouvelle sélection.

Utilisation avancée

L'écran de ComcomMaker en mode expert

Un clic sur la case à cocher basic change le libellé de celle-ci en expert.

Ce mode avancé fait apparaître des zones de texte et ajoute des options supplémentaires dans les menus déroulants.

Les deux premières zones de texte permettent de changer manuellement la présélection de balises pour le choix des entités à sélectionner ou à composer.

Ces balises doivent être composées chacune sur une ligne sous la forme clef=valeur. Les clefs et valeurs ne peuvent contenir de virgule qui est le caractère séparateur de sérialisation lors de l'envoi au serveur.
L'accès restreint en lecture seule à la table polygon base de donnée d'openstreetmap.fr ne permet pas toutes les combinaisons de recherche, mais des recherches sur des polygones avec les critères landuse=forest, ou bluiding=yes sont possibles pour des utilisations exotiques de l'outil. Le seul opérateur logique de recherche est AND.

La zone de texte sous la liste présente la liste des identifiants de relation sous la forme abrégée rN1,rN2...

Cette liste peur être copiée et collée dans JOSM (fichier > télécharger un objet) pour charger l'ensemble des collectivités. Les frontières mitoyennes ne sont alors pas supprimées

Quelques liens utiles

Suggestions et remarques

Les suggestions de fonctionnalités ou les remarques sont les bienvenues dans la page de discussion.

Les questions ou demandes d'aide sont les bienvenues sur la liste de diffusion talk-fr.

Maintenance, Nouveautés et Améliorations

  • TODO
    • Ajouter une bbox dans le fichier .osm transmis à JOSM
    • Ajouter un contrôle "keep in mind" de la zone ouverte précédemment.
  • 10 mai 2012
    • bug : correction d'une régression, non export des tags du select in dans la textarea
  • 21 avril 2012
    • bug : correction d'une régression, non détection de clic ; comcom.js
    • bug : mise à zéro du compteur de process lors de l'effacement de la liste ; comcom.js
  • 14 avril 2012
    • ajout : permalink; comcom.js
    • mise à jour : render.js
  • 13 avril 2012
    • ajout : édition des tags en mode basic; overlays.js, comcom.js, index.html, style.css
    • bug : mise à zéro du compteur de process à l'effacement.
  • 25 mars 2012
    • mise à jour : overlays.js mise à jour de la table des overlays sur layers.openstreetmap.fr
  • 16 mars 2012
    • bug : correction d'une régression dans la sélection des tags out ; comcom.js
  • 15 mars 2012
    • bugs :
      • adaptation du code à python 2.6 (version production) pour l'analyse des tags ; comcommaker.py :
      • correction d'adresse de serveur pour le remotecontrol ; comcom.js
  • 14 mars 2012
    • maintenance : nettoyage de fichiers
    • mise à jour : adresses des overlays sur beta.letuffe ; overlays.js
  • 5 mars 2012
    • Ajout d'un overlay pour l'affichage des entités existantes avec sélection automatique de l'overlay selon le type d'entitée.
  • 24 février 2012
    • Ajout d'un compteur d'entités.
    • Correction d'un bug sur chemins sélectionnés : l'identifiant n'était pas précédé de 'w' dans la liste.
    • Ajout au menu out d'une entrée Circonscription législative