FR:GeoOccitania

GeoOccitania est une application web de toponymie et de cartographie collaborative consacrée au domaine occitan. Elle permet de compléter des données en occitan dans OpenStreetMap et de recueillir séparément des enregistrements de prononciation.

Le programme est porté par P. Brechet — IEO, Institut d’Estudis Occitans.

Figure 1 — Menu d’accueil de GeoOccitania : les thèmes sont classés par ordre alphabétique et peuvent être ajoutés aux favoris.

Présentation

GeoOccitania affiche une carte mondiale déplaçable. L’application ne charge que les objets présents dans l’emprise actuellement visible à l’écran. Elle n’est donc pas limitée à une zone pilote prédéfinie.

Les objets proposés dépendent de thèmes et de marqueurs configurés par un administrateur. Chaque marqueur associe :

• un nom fonctionnel ;
• une forme et une couleur ;
• des niveaux de zoom ;
• une requête Overpass ;
• un formulaire de tags OpenStreetMap.

Une contribution écrite confirmée par son auteur est envoyée directement à OpenStreetMap. La vérification par GeoOccitania intervient a posteriori : elle ne constitue pas une validation préalable à la publication dans OSM.

Les enregistrements audio suivent un circuit distinct. OpenStreetMap ne stockant pas de fichier audio pour ce type d’usage, ils restent dans la base et l’espace de fichiers de GeoOccitania. Un audio n’est jamais envoyé à OSM comme s’il s’agissait d’un tag.

La version 1 est actuellement privée. Elle sert à éprouver la chaîne complète avant une ouverture plus large. Le fait que l’application soit privée ne rend pas privées les modifications effectivement envoyées à OpenStreetMap : celles-ci sont publiques dans OSM et soumises aux règles de la communauté.

Figure 2 — GeoOccitania charge les marqueurs du thème uniquement dans l’emprise visible. La forme et la couleur indiquent la fonction de chaque marqueur.

Public concerné et prérequis

GeoOccitania s’adresse à des personnes connaissant les règles de contribution à OpenStreetMap et les règles linguistiques nécessaires à la saisie de toponymes occitans.

La connaissance et l’application des documents suivants constituent un prérequis :

• Règles d’écriture de la Comission Toponimica Occitana ;
• Règles d’adaptation des noms propres.

Les adresses définitives de ces documents devront être publiques et pérennes avant l’ouverture de l’application.

Contributeur

Un contributeur :

• se connecte avec son compte OpenStreetMap ;
• choisit un thème et un marqueur ;
• vérifie l’objet OSM sélectionné ;
• complète les champs autorisés ;
• confirme les tags puis les envoie à OpenStreetMap ;
• peut enregistrer ou déposer une prononciation ;
• peut envoyer un message à l’administrateur.

Toute personne qui se connecte pour la première fois reçoit par défaut le rôle de contributeur.

Vérificateur

Un vérificateur :

• consulte les contributions récentes ;
• ouvre le changeset public dans OpenStreetMap ;
• peut contacter le contributeur avec la messagerie OSM ;
• écoute, valide ou supprime les enregistrements audio ;
• emploie, si nécessaire, les outils OSM existants pour commenter ou corriger un problème.

La vérification est un suivi a posteriori. Un vérificateur ne bloque pas l’envoi d’une contribution écrite vers OSM.

Administrateur

Un administrateur :

• crée et configure les thèmes ;
• crée les marqueurs, leurs requêtes Overpass et leurs formulaires ;
• règle les niveaux de zoom et le regroupement des icônes ;
• attribue les rôles ;
• consulte l’historique interne ;
• consulte les messages ;
• exporte les métadonnées ;
• prépare les copies de sauvegarde.

Utilisation

1. Choisir un thème

Les thèmes actifs apparaissent sur la page d’accueil par ordre alphabétique. Une personne connectée peut marquer ses thèmes favoris et utiliser la recherche.

2. Déplacer et agrandir la carte

La carte peut être déplacée dans le monde entier. GeoOccitania interroge Overpass pour l’emprise visible et pour les marqueurs actifs au niveau de zoom courant.

Un clic sur un regroupement agrandit la carte et sépare progressivement les marqueurs qu’il contient.

Figure 3 — Un clic sur un regroupement agrandit la carte et sépare les marqueurs qu’il contient.

3. Sélectionner un marqueur

La forme et la couleur du marqueur indiquent sa fonction dans le thème. Le nom du marqueur doit expliquer clairement ce que représente l’objet affiché, par exemple « Arrêts à nommer » ou « Arrêts avec nom occitan ».

La requête Overpass détermine le contenu réel du marqueur. GeoOccitania ne possède pas de fonction séparée « avec nom » ou « sans nom ».

4. Compléter le formulaire

Le formulaire emploie des libellés occitans. Le nom technique du tag OSM est affiché discrètement à côté du champ. Les valeurs fixes et masquées sont ajoutées automatiquement conformément à la configuration.

Avant l’envoi, le contributeur doit contrôler l’objet, les valeurs et les tags présentés.

Figure 4 — Le formulaire présente les tags OSM avec des libellés occitans. Les tags fixes et masqués sont ajoutés automatiquement lors de l’envoi.

5. Envoyer l’écrit ou l’audio

Les deux envois sont indépendants :

• les tags écrits sont envoyés à l’API OpenStreetMap ;
• le fichier audio est envoyé à GeoOccitania sous licence CC BY 4.0.

Une personne peut donc envoyer seulement une contribution écrite, seulement un audio associé à un objet, ou effectuer les deux opérations.

Figure 5 — Après l’envoi, GeoOccitania fournit un lien vers le groupe de modifications publié sur OpenStreetMap.

Thèmes, marqueurs et Overpass

Un thème regroupe un ou plusieurs marqueurs. Chaque marqueur possède :

• un nom fonctionnel et une description ;
• une forme et une couleur propres ;
• un zoom minimal et un zoom maximal ;
• un seuil de regroupement des icônes ;
• une requête Overpass QL ;
• un formulaire de tags OSM.

Les couleurs des marqueurs ne correspondent pas à un état interne imposé par GeoOccitania. Leur sens dépend du nom et de la requête définis par l’administrateur.

La variable {bbox}

La requête doit contenir {bbox}. Au moment de l’appel, GeoOccitania remplace cette variable par les coordonnées de l’emprise visible.

Exemple générique :

nwr
  ["name"]
  ({bbox});
out center;

La sélection avec des tags positifs ou négatifs appartient entièrement à la requête Overpass. Par exemple, une requête peut sélectionner des objets possédant name et ne possédant pas name:oc.

Il est recommandé de préparer la requête dans Overpass Turbo, dans une présentation non compacte, puis de remplacer les coordonnées de la zone par {bbox}. Le reste de la requête doit être conservé.

Figure 9 — L’administrateur configure les thèmes et les marqueurs. Chaque requête Overpass utilise {bbox}, remplacé par l’emprise visible.

Précautions concernant Overpass

• Une requête active doit contenir {bbox}.
• Une emprise très grande ou une requête trop générale peut demander trop d’objets.
• Les niveaux de zoom doivent être adaptés à la densité des objets.
• Le regroupement des marqueurs réduit la surcharge visuelle, mais ne remplace pas une requête bien limitée.
• Overpass est un service extérieur. Il peut répondre lentement ou être temporairement indisponible.
• En cas d’échec, GeoOccitania effectue un nouvel essai automatique et affiche un bouton permettant de relancer le chargement.
• Une réponse Overpass est une vue des données OSM à un instant donné, non une base de données propre à GeoOccitania.

Voir aussi :

• Overpass API ;
• Overpass API/Overpass QL ;
• Bounding box ;
• Overpass Turbo.

Formulaires et tags OpenStreetMap

Pour chaque tag, l’administrateur définit :

• le nom technique OSM ;
• le libellé affiché dans l’interface ;
• une valeur préremplie ou vide ;
• sa visibilité ;
• son caractère modifiable ou fixe ;
• son caractère obligatoire ou facultatif.

Une valeur fixe peut être invisible pour le contributeur tout en étant envoyée à OSM.

Ce tag n’est pas ajouté globalement par le code de l’application : il est défini dans la configuration du marqueur concerné. Le même mécanisme s’applique à tout autre tag fixe, visible ou masqué.

Chaque marqueur doit proposer au moins un tag OSM valide destiné à l’envoi. GeoOccitania ne limite pas a priori la liste des tags, mais l’administrateur doit vérifier leur validité et leur pertinence pour le type d’objet concerné.

Figure 10 — Chaque marqueur définit son formulaire et les tags OSM à envoyer. Un tag peut être visible ou masqué, modifiable ou fixe, obligatoire ou facultatif.

Voir aussi :

• Map features ;
• Multilingual names ;
• Key:name ;
• Key:source ;
• Elements.

Envoi vers OpenStreetMap

La connexion utilise OAuth 2.0. GeoOccitania demande les autorisations nécessaires pour lire les informations du compte et modifier la carte.

Pour chaque contribution écrite, le serveur :

1. relit la version actuelle de l’objet ;
2. ajoute ou modifie uniquement les tags autorisés par le marqueur ;
3. crée un changeset ;
4. met à jour l’objet OSM ;
5. ferme le changeset ;
6. enregistre une trace interne dans GeoOccitania.

OpenStreetMap conserve l’auteur, le changeset et l’historique public des tags. Le lien vers le changeset est affiché après un envoi réussi.

La contribution écrite n’attend pas l’accord d’un vérificateur. Elle est publiée dans OSM dès que le contributeur la confirme et que l’API accepte l’opération.

Conflits et erreurs

Un objet peut être modifié par une autre personne entre sa lecture et son envoi. L’API OSM peut alors refuser l’ancienne version. L’objet doit être rechargé avant une nouvelle tentative.

Si la modification a bien été publiée dans OSM mais que la trace interne n’a pas pu être enregistrée, GeoOccitania le signale et propose d’avertir l’administrateur. Il faut toujours vérifier le changeset OSM avant de recommencer afin de ne pas produire un doublon.

Voir aussi :

• API v0.6 ;
• OAuth 2.0 ;
• Changeset ;
• Version ;
• Good practice ;
• droit d’auteur et licence ODbL.

Enregistrements audio

Le contributeur peut :

• enregistrer sa prononciation avec le microphone ;
• déposer un fichier dans un format accepté ;
• écouter l’enregistrement avant l’envoi ;
• recommencer ;
• envoyer l’audio séparément de la contribution écrite.

Avant le début de l’enregistrement, trois signaux sonores indiquent quand parler. La durée maximale affichée par la V1 est de 20 secondes.

L’interface conseille de sourire avant de parler afin d’obtenir une voix plus naturelle.

Consentement et licence

L’envoi est impossible sans consentement explicite. Le locuteur accepte l’utilisation et la diffusion de son enregistrement sous licence Creative Commons Attribution 4.0.

Il faut enregistrer sa propre voix ou disposer de l’accord clair du locuteur. L’identité associée, la date du consentement et la licence sont conservées dans les métadonnées internes.

Figure 6 — Avant l’enregistrement, le contributeur lit l’avertissement et consent à la diffusion de l’audio sous licence CC BY 4.0.

Figure 7 — Trois signaux sonores annoncent le début. Le contributeur peut écouter l’enregistrement et recommencer avant l’envoi.

Vérification des audios

Un audio nouvellement envoyé apparaît dans l’espace de vérification. Un vérificateur peut :

• l’écouter ;
• le télécharger ;
• le valider ;
• le supprimer.

Une prononciation validée peut ensuite être écoutée sur la fiche de l’objet dans GeoOccitania. Un audio supprimé n’est plus servi, mais l’action de modération reste tracée dans l’historique interne.

Figure 8 — L’espace de vérification permet de suivre les contributions récentes, d’écouter les audios et de les valider ou de les supprimer.

Les fichiers audio ne sont pas enregistrés dans OpenStreetMap. Leur éventuelle publication future sur Wikimedia Commons demanderait une sélection, des métadonnées adaptées et le respect des règles de Commons. La V1 ne réalise pas cet envoi automatiquement.

Voir aussi :

• Wikimedia Commons — Pronunciation ;
• Structured Data on Commons ;
• Wikidata.

Données conservées par GeoOccitania

GeoOccitania possède une base propre parce qu’OpenStreetMap ne conserve pas tous les éléments nécessaires au fonctionnement du programme.

La base interne contient notamment :

• la configuration des thèmes, marqueurs et formulaires ;
• les comptes OSM connus par l’application et leurs rôles ;
• la trace des contributions écrites ;
• les métadonnées des fichiers audio ;
• les consentements ;
• l’état de vérification et les décisions des vérificateurs ;
• les messages envoyés à l’administrateur ;
• les thèmes favoris.

Les fichiers audio sont conservés dans un espace de stockage séparé de la base SQL.

Les tokens d’accès OSM sont des secrets de session. Ils ne doivent jamais apparaître dans un export administratif, un dépôt de code, une capture d’écran ou cette page.

Demandes des utilisateurs

Une personne connectée peut utiliser le bouton « Message » pour demander une information, une correction ou la suppression d’une donnée interne. L’historique public d’OpenStreetMap suit les règles propres à OSM et ne peut pas être supprimé par GeoOccitania.

Figure 11 — Un contributeur connecté peut demander de l’aide à l’administrateur ou signaler un problème.

Avant une ouverture publique, le responsable devra publier les durées de conservation retenues et un moyen de contact pérenne.

Exports et sauvegardes

L’administrateur peut :

• télécharger les contributions et leurs métadonnées en CSV ou JSON ;
• exporter puis restaurer la configuration ;
• télécharger une copie des tables de la base.

Une copie de la base contient les métadonnées audio, mais pas nécessairement les fichiers eux-mêmes. Une stratégie complète doit donc inclure :

• la base SQL ;
• l’espace des fichiers audio ;
• la configuration ;
• des copies régulières dans un autre espace ;
• un essai périodique de restauration.

Les exports administratifs contiennent des données internes et ne doivent pas être publiés sans contrôle.

Architecture simplifiée

Navigateur
  ├─ interface GeoOccitania
  ├─ fonds de carte OSM / OSM-oc
  └─ requêtes Overpass

Serveur GeoOccitania
  ├─ authentification OAuth 2 OSM
  ├─ envoi vers l’API OSM
  ├─ configuration et rôles
  ├─ vérification et exports
  ├─ base de données
  └─ espace des fichiers audio

Services extérieurs
  ├─ API OpenStreetMap
  ├─ API Overpass
  └─ serveurs de tuiles cartographiques

Les principales dépendances extérieures sont :

• OpenStreetMap pour l’authentification et les contributions ;
• Overpass pour sélectionner les objets visibles ;
• les fonds OSM générique et OSM-oc ;
• un service de base SQL ;
• un espace de stockage d’objets pour les audios.

Installation et déploiement

Le dépôt de code est privé pendant la phase d’essai. Cette section décrit donc seulement les principes généraux, sans publier de secret ni d’adresse interne.

Un déploiement demande :

1. un espace de travail protégé ;
2. l’installation des dépendances ;
3. une base SQL et l’application des migrations ;
4. un espace de stockage des fichiers audio ;
5. une application OAuth 2 enregistrée sur OpenStreetMap ;
6. une URI de retour OAuth correspondant au site ;
7. des secrets définis dans l’interface sécurisée de l’hébergeur ;
8. la construction et les contrôles du programme ;
9. le déploiement d’une version enregistrée ;
10. des essais de connexion, Overpass, envoi OSM, audio, vérification et export.

Ne jamais publier :

• le secret OAuth OSM ;
• les tokens d’accès ;
• les cookies ou identifiants de session ;
• les clés d’API ;
• les accès à la base ou au stockage ;
• une copie de base contenant des données personnelles.

La documentation peut citer les noms des variables nécessaires avec des valeurs fictives. Les vraies valeurs doivent rester dans l’espace sécurisé de l’hébergeur.

Limites connues de la V1

La V1 est une application web privée d’essai. Ses limites connues comprennent :

• l’accès est réservé à des personnes autorisées ;
• Overpass peut être lent, surchargé ou indisponible ;
• les requêtes trop générales ou les emprises trop larges peuvent échouer ;
• la géolocalisation et le microphone dépendent des autorisations du navigateur et du système ;
• l’autorisation donnée au site dans le navigateur n’est pas indépendante de l’autorisation générale du navigateur ;
• la V1 n’est pas encore une application installable ou native ;
• les audios restent extérieurs à OpenStreetMap ;
• les sauvegardes OSM et GeoOccitania sont séparées ;
• la création d’un marqueur demande une connaissance minimale d’Overpass QL et des tags OSM ;
• la publication automatique d’audios vers Wikimedia Commons n’est pas comprise dans la V1 ;
• une sauvegarde externe automatisée complète reste à organiser avant une exploitation durable.

Ces limites ne changent pas la règle fondamentale : toute contribution écrite acceptée par l’API est immédiatement publique dans OpenStreetMap.

Développements envisagés

Les travaux postérieurs à la V1 pourront comprendre :

• un guide illustré avec des captures d’écran ;
• des formats courts de formation ;
• des vidéos courtes de présentation ;
• une application installable ou native ;
• une stratégie de publication d’audios sélectionnés sur Wikimedia Commons ;
• des liens avec Wikidata lorsque cela est pertinent ;
• l’automatisation des copies et des essais de restauration ;
• des statistiques agrégées respectueuses des données personnelles ;
• un accès organisé pour des visiteurs autorisés.

Ces pistes ne décrivent pas des fonctions déjà disponibles.

Aide intégrée

L’aide de GeoOccitania résume les cinq étapes de contribution, les trois rôles et les licences. Elle donne également accès aux règles linguistiques requises.

Figure 12 — L’aide résume le processus de contribution et donne accès aux règles linguistiques nécessaires avant de compléter la carte.

Illustrations à produire

Les noms ci-dessous sont des emplacements de travail. Avant publication, chaque fichier doit être produit avec des données de démonstration, contrôlé, puis téléversé sur l’espace retenu :

1. GeoOccitania-01-acuelh.jpg — ordinateur ;
2. GeoOccitania-02-mapa-e-balisas.jpg — ordinateur ;
3. GeoOccitania-03-regropament.jpg — tablette ;
4. GeoOccitania-04-formulari.jpg — tablette ;
5. GeoOccitania-05-mandadis-osm.jpg — ordinateur ;
6. GeoOccitania-06-consentiment-audio.jpg — téléphone ;
7. GeoOccitania-07-enregistrament.jpg — téléphone en mode paysage ;
8. GeoOccitania-08-verificacion.jpg — tablette ;
9. GeoOccitania-09-administracion.jpg — ordinateur ;
10. GeoOccitania-10-tags.jpg — ordinateur ;
11. GeoOccitania-11-messatge.jpg — téléphone ;
12. GeoOccitania-12-ajuda.jpg — tablette.

Les captures ne doivent révéler ni secret, ni message privé, ni adresse électronique, ni position personnelle précise, ni donnée de production non publiée.

Liens

• OpenStreetMap
• OpenStreetMap France
• UMap
• Overpass API
• Overpass API/Overpass QL
• OAuth 2.0
• Changeset
• Multilingual names
• Open Data Commons Open Database License 1.0
• Creative Commons Attribution 4.0
• Institut d’Estudis Occitans

Crédits

GeoOccitania est un programme de P. Brechet — IEO, Institut d’Estudis Occitans.

Les données cartographiques sont fournies par OpenStreetMap et ses contributeurs sous licence ODbL. Le rendu OSM-oc est fourni par OpenStreetMap France. Les enregistrements audio validés sont diffusés sous licence CC BY 4.0.