Présentation
OpenLayers Map API (OLA) est un outil permettant d’intégrer facilement des cartes OpenStreetMap interactives dans les pages PmWiki. Développé sur la base de l’API GoogleMap créée par Benjamin C. Wilson en 2006, cet outil offre une alternative libre et open source pour l’affichage cartographique.
Statut : Version alpha (tests uniquement)
Documentation : Disponible sur le Cookbook PmWiki
Code source : Accessible sur GitHub
Syntaxe et paramètres
Commande ola-map : Définir le visualiseur de carte
Cette commande crée le conteneur principal de la carte avec plusieurs options de configuration :
Contrôles de navigation (ctrl)
- small : Affiche des contrôles de navigation compacts
- large : Affiche des contrôles de navigation étendus
- scale : Ajoute l’échelle de la carte
- layer : Active le sélecteur de couches cartographiques
Style de rendu (view)
- mapnik : Rendu OSM par défaut, style équilibré et complet
- cyclemap : Rendu gratuit optimisé pour les cyclistes avec mise en évidence des pistes cyclables
- openmapquest : Rendu gratuit de MapQuest basé sur les données OSM, emphase sur les routes
Paramètres de positionnement
- lat : Latitude du centre de la carte (coordonnées décimales)
- lon : Longitude du centre de la carte (coordonnées décimales)
- zoom : Niveau de zoom, de 1 (vue mondiale) à 19 (vue très détaillée)
- width : Largeur de la carte en pixels ou en pourcentage
- height : Hauteur de la carte en pixels ou en pourcentage
Commande ola-point : Ajouter des marqueurs
Cette commande permet de placer des points d’intérêt sur la carte :
- lat : Latitude du marqueur (position exacte)
- lon : Longitude du marqueur (position exacte)
- text : Texte à afficher au clic sur le marqueur (fonctionnalité actuellement non opérationnelle)
Exemple d’utilisation
Voici un exemple de code PmWiki pour intégrer une carte centrée sur Paris avec un marqueur sur la Tour Eiffel :
(:ola-map lat=48.8566 lon=2.3522 zoom=12 width=100% height=500 view=mapnik ctrl=large scale:)
(:ola-point lat=48.8584 lon=2.2945 text="Tour Eiffel":)
Fonctionnalités et limitations
Points forts
- Alternative libre et gratuite aux solutions propriétaires comme Google Maps
- Basé sur les données collaboratives d’OpenStreetMap
- Plusieurs styles de rendu disponibles selon les besoins
- Contrôles de navigation personnalisables
- Intégration native dans PmWiki
Limitations actuelles
- Version alpha : Instabilité possible, réservé aux tests
- Paramètre text non fonctionnel : L’affichage de texte au clic sur les marqueurs ne fonctionne pas encore
- Documentation encore en développement
Utilisation pratique
Pour visualiser le code PmWiki nécessaire à l’intégration d’une carte OpenStreetMap, il suffit de cliquer sur le bouton « Edit » dans l’interface PmWiki. Le code source complet s’affichera, permettant de comprendre la structure et de l’adapter à vos besoins spécifiques.
Perspectives d’évolution
En tant que version alpha, OpenLayers Map API pour PmWiki est amené à évoluer. Les développements futurs devraient inclure :
- Correction du paramètre text pour l’affichage des informations sur les marqueurs
- Stabilisation de l’API pour un usage en production
- Ajout de nouvelles fonctionnalités cartographiques
- Amélioration de la documentation
Ressources complémentaires
- Cookbook PmWiki : Documentation détaillée et exemples d’utilisation
- GitHub : Code source, rapports de bugs et contributions
- OpenStreetMap : Données cartographiques libres et collaboratives
- OpenLayers : Bibliothèque JavaScript pour la cartographie web
OpenLayers Map API pour PmWiki représente une solution prometteuse pour intégrer des cartes interactives dans un wiki sans dépendre de services propriétaires. Bien qu’encore en phase de test, l’outil offre déjà des fonctionnalités essentielles pour la plupart des usages cartographiques. Son développement continu et sa base open source en font une alternative intéressante pour les projets collaboratifs et éducatifs.