osm-bzh-kartenn
Visualiseur cartographique du service de tuiles OpenStreetMap en langue bretonne
(https://tile.openstreetmap.bzh/br/), basé sur mviewer v4.1.
L'application est un site statique (HTML/JS) : aucune étape de compilation, il suffit de servir le dossier
avec un serveur web.
Fonctionnalités
Fonds de plan
Le bouton en bas à droite de la carte ouvre une galerie de fonds de plan :
| Fond | Source | Zoom max |
|---|
| OpenStreetMap e brezhoneg (par défaut) | https://tile.openstreetmap.bzh/br/{z}/{x}/{y}.png | 18 |
| OpenStreetMap FR | https://{a-c}.tile.openstreetmap.fr/osmfr/{z}/{x}/{y}.png | 20 |
| OpenStreetMap standard | https://tile.openstreetmap.org/{z}/{x}/{y}.png | 19 |
| Plan IGN | WMTS Géoplateforme, couche GEOGRAPHICALGRIDSYSTEMS.PLANIGNV2 | 19 |
| Photographie aérienne | WMTS Géoplateforme, couche ORTHOIMAGERY.ORTHOPHOTOS | 19 |
La carte est limitée au zoom 18 (limite du fond breton). Les vignettes de la galerie sont dans img/basemap/.
Couche « Klokter ar gartenn »
Surcouche de contrôle OSM Breizh (https://tile.openstreetmap.bzh/br_control/{z}/{x}/{y}.png), disponible dans le
panneau de gauche, thématique « Kartenn ».
- elle est désactivée au départ : il faut la cocher ;
- elle n'est affichée que jusqu'au zoom 12 inclus (
maxZoom: 12) ;
- elle est déclarée par un script
customlayer : apps/customlayers/osm_br_control.js.
Recherche de lieux
La barre de recherche interroge le service Nominatim d'OpenStreetMap
(https://nominatim.openstreetmap.org/search) :
- les résultats ne sont pas limités à l'emprise de la carte (
bbox="false" dans <searchparameters>) ; avec
bbox="true", la recherche est restreinte à la vue affichée (viewbox et bounded=1) ;
- les noms sont demandés en breton (
accept-language=br) ;
- un clic sur un résultat zoome au niveau 18 (
searchmaxzoomlevel) et place un repère ;
- la recherche se déclenche 500 ms après la dernière frappe.
Le service public Nominatim est limité à 1 requête par seconde et déconseille la recherche au fil de la frappe.
En cas de trafic important, passer le délai timeoutToWait de js/search.js à 1000 ms ou plus, ou utiliser
sa propre instance.
Outils de la carte
- zoom avant / arrière, zoom par double-clic, retour à l'étendue de départ, localisation de l'utilisateur ;
- mesure de distances et de surfaces ;
- partage de la carte (permalien, QR code, code d'intégration en iframe) ;
- export de la carte en image PNG et impression de la vue courante ;
- affichage des coordonnées de la souris ;
- légende et panneau des thématiques.
Interface en breton
L'interface est en breton par défaut (lang="br"). La traduction est dans le bloc br de
mviewer.i18n.json, qui a les mêmes clés que le bloc français (fr).
Pour une nouvelle clé non encore traduite, la convention est de garder le texte français suivi de (TODO) ;
on les retrouve avec :
grep -n "(TODO)" mviewer.i18n.json
Méthode utilisée : chaque texte français est décomposé en termes, cherchés dans le lexique An Drouizig
(gerva-an-drouizig-2017.csv) puis sur geriafurch.bzh (Termofis en priorité, puis
Brezhoneg21 et Preder). Les phrases complètes ont ensuite été relues à la main.
Zoom au double-clic
Un double-clic sur la carte zoome d'un niveau. mviewer le désactive en dur dans son code ; il est réactivé dans
js/mviewer.js (ajout d'un écouteur sur les interactions de la carte). Il est suspendu automatiquement pendant
les outils de mesure et de dessin, où le double-clic sert à terminer un tracé, puis rétabli à la fin du tracé.
À reporter en cas de mise à jour de mviewer.
Fenêtre de documentation
Elle s'ouvre au chargement (showhelp="true"). Son contenu est dans mviewer_help.html
(onglets « Raktres » et « Kredoù »). Un interrupteur permet à chaque visiteur de ne plus l'afficher au démarrage
(mémorisé dans le navigateur).
Recherche
La recherche utilise le service Nominatim, basé sur les données OpenStreetMap.
La configuration se fait dans js/search.js :
- le libellé des résultats utilise
display_name (mviewer ne lit que le format label du géocodeur de l'IGN) ;
- avec Nominatim, les paramètres
viewbox et bounded limitent les résultats à l'emprise de la carte ;
- le zoom après un clic sur un résultat vient de
searchmaxzoomlevel.
À reporter en cas de mise à jour de mviewer.
Utilisation
Test en local :
python3 -m http.server 8099
puis ouvrir http://localhost:8099/. Pour la mise en ligne, servir le dossier avec n'importe quel serveur web
statique. Après une modification, vider le cache du navigateur (Cmd+Shift+R).
Configuration
Toute la configuration de l'application est dans apps/default.xml :
| Élément | Rôle |
|---|
<application> | titre, logo, langue, outils actifs, fenêtre d'aide |
<mapoptions> | projection, centre, zoom initial, zoom maximal |
<baselayers> | fonds de plan |
<searchparameters> et <olscompletion> | recherche de lieux (Nominatim) |
<themes> | couches thématiques (ici « Klokter ar gartenn ») |
Documentation de mviewer : https://mviewerdoc.readthedocs.io/fr/stable/.
Organisation du dépôt
apps/default.xml configuration de l'application
apps/customlayers/ couches personnalisées (script JS)
mviewer.i18n.json traductions de l'interface (fr, en, de, sk, br)
mviewer_help.html contenu de la fenêtre de documentation
img/basemap/ vignettes des fonds de plan
js/, css/, lib/, pages/ code de mviewer
tools/ outils annexes (comparaison de cartes, schéma de tuiles)
Licences et crédits
- mviewer est sous licence GPL (voir
LICENSE.mviewer et CREDITS.mviewer).
- Données : © les contributeurs d'OpenStreetMap (ODbL).
- Fonds IGN : © IGN - Géoplateforme.
- Projet OpenStreetMap.bzh, avec l'Office public de la langue bretonne.
