~~NOCACHE~~
====== Afficher une carte géographique ======

Le module [[doku>plugin:openlayersmap|OpenLayerMap]] permet d'afficher une carte sur une page.


<WRAP center round important>
Le module OpenLayerMap n'est plus installé sur ce wiki. Cette page a été conservée à titre d'archive.
</WRAP>


===== Carte par défaut =====

Obtenue en utilisant le bouton insérer une carte

<olmap id="olMapOne" width="550px" height="450px" lat="50.0" lon="5.1" zoom="12" controls="1" baselyr="OpenStreetMap" gpxfile="" kmlfile="" geojsonfile="" summary="" >
~~ Plugin olmap help.
~~ Required in the above tag are values for: id (unique on this page), width, heigth.
~~ Also you will want to enter zoomlevel and lat, lon values that make sense for where you~~ want the map to start.

~~ Below is an example of a POI, you can add as many as you want. 
~~ More examples: https://dokuwiki.org/plugin:openlayersmap 
50.0117,5.1287,-90,.8,marker-green.png,Pont de Barbouillons; Daverdisse \\ external link: 
                        [[https://test.com|test.com]] \\ internal link: [[::start]]\\ **DW Formatting** 
</olmap>

==== Code par défaut ====

Voici le code inséré après utilisation du bouton {{http://dokuwikispatial.sourceforge.net/dokuwiki/lib/plugins/openlayersmap/toolbar/map.png}} dans la barre d'outils :

<code xml olmap.xml>
<olmap id="olMapOne" width="550px" height="450px" lat="50.0" lon="5.1" zoom="12" controls="1" baselyr="OpenStreetMap" gpxfile="" kmlfile="" geojsonfile="" summary="" >
~~ Plugin olmap help.
~~ Required in the above tag are values for: id (unique on this page), width, heigth.
~~ Also you will want to enter zoomlevel and lat, lon values that make sense for where you~~ want the map to start.

~~ Below is an example of a POI, you can add as many as you want. 
~~ More examples: https://dokuwiki.org/plugin:openlayersmap 
50.0117,5.1287,-90,.8,marker-green.png,Pont de Barbouillons; Daverdisse \\ external link: 
                        [[https://test.com|test.com]] \\ internal link: [[::start]]\\ **DW Formatting** 
</olmap>
</code>

++++ Voir la carte |
<olmap id="olMapOne" width="800px" height="450px" lat="50.0" lon="5.1" zoom="1" statusbar="1" controls="1" poihoverstyle="0" baselyr="OpenStreetMap" gpxfile="" kmlfile="" geojsonfile="" summary="" >
~~ Plugin xml olmap help.
~~ Required in the above tag are values for: id (unique on this page), width, heigth.
~~ Also you will want to enter zoomlevel and lat, lon values that make sense for where you want the map to start.

~~ Below is an example of a POI, you can add as many as you want. ~~ More examples: http://dokuwiki.org/plugin:openlayersmap 
50.0117,5.1287,-90,.8,marker-green.png,Pont de Barbouillons; Daverdisse \\ external link: [[http://test.com|test.com]] \\ internal link: [[::start]]\\ **DW Formatting** 
</olmap>
++++

==== Paramètres ====
Voici la liste des paramètres de la balise ''olmap'' :

  * **id** Identifiant **unique** de la carte ((Chaine valide pour les normes [[http://www.w3.org/TR/CSS21/syndata.html#characters|CSS]]/[[http://www.w3.org/TR/html4/types.html#type-id|XHTML]]/[[http://mathiasbynens.be/notes/javascript-identifiers|JavaScript]])).
  * **width** Largeur de la carte, par défaut ''400px''.
  * **height** Hauteur de la carte, par défaut ''300px''.
  * **zoom** Niveau de zoom, par défaut ''12''((Valeur entière qui dépend de la carte utilisée)).
  * **controls** Affiche les boutons de contrôle sur la carte. Valeur ''on'' ou ''off'', par défaut ''on''.
  * **statusbar** Montre la barre de statut en bas de carte. Valeur ''1'' ou ''0'', par défaut ''1'' (affichée).
  * **poihoverstyle** Affichage du texte associé au point d'intérêt (survol or clic). Valeur ''1'' ou ''0'', par défaut ''0'' (clic), évitez la fonction survol pour l'accessibilité.
  * **lat** Latitude du centre de la carte en degrés décimaux(([[WP>WGS84]])), de ''-90.0'' à ''90.0'', valeurs négatives au sud de l'équateur.
  * **lon** Longitude du centre de la carte en degrés décimaux(([[WP>WGS84]])), de ''-180.0'' a ''180.0'', valeurs négatives à l'ouest du méridien de Greenwich.
  * **baselyr** La couche géographique utilisée. Les valeurs possibles sont : ''OpenStreetMap'', ''transport'', ''landscape'', ''cycle map'', ''hike and bike map'', ''mapquest road'', ''mapquest sat'', ''google relief'', ''google sat'', ''google hybrid'', ''google road'', ''bing road'', ''bing sat'' or ''bing hybrid''. (Pour Google et Bing il vous faudra peut-être une clé API ou une URL)
  * **gpxfile** fichier [[WP>GPS_eXchange_Format|GPX]]
  * **kmlfile** fichier [[WP>KML]]
  * **geojsonfile**  fichier [[WP>GeoJSON]]
  * **summary** une description de la carte.

<WRAP round important>
Toutes les valeurs par défaut sont définies dans les paramètres de configuration du module.\\
Les cartes Bing et Google doivent être activées dans la configuration du module.
</WRAP>

==== Points d'intérets ====

A l'intérieur de la balise ''olmap'', il est possible de lister une série de points d'intérêts.

Chaque point est défini par la ligne suivante :
<code>lat, lon, angle, opacité, image, texte</code>

  * **lat** latitude du point d'intérêt
  * **lon** longitude du point d'intérêt
  * **angle** de rotation de l'image de 0 à 360, si négatif : rotation vers la gauche.
  * **opacité** de l'image valeur de ''.1'' (transparente) à ''1'' (opaque) par pas de ''.1''.
  * **image** fichier png disponible dans le répertoire ''icon'' du module. 
  * **texte** contenu de la boite d'information qui peut être formaté et contenir des liens DokuWiki.



===== Exemples de cartes =====

==== Simple ====
Carte placée avec toutes les options par défaut de cette configuration et sans point d'intérêt.
<code xml olmap.xml>
<olmap id="Simple" lat="43.838" lon="4.359">
</olmap>
</code>

++++ Voir la carte |
<olmap id="Simple" lat="43.838" lon="4.359">
</olmap>
++++
==== Minimale ====
Carte [[#simple]] sans les boutons de contrôle ni la barre de statut.
<code xml olmap.xml>
<olmap id="Minimale" lat="43.838" lon="4.359" controls="off" statusbar="0">
</olmap>
</code>

++++ Voir la carte |
<olmap id="Minimale" lat="43.838" lon="4.359" controls="off" statusbar="0">
</olmap>
++++

==== Satellite ====
Carte [[#minimale]] utilisant Google satellite.
<code xml olmap.xml>
<olmap id="Satellite" lat="43.838" lon="4.359" controls="off" statusbar="0" baselyr="google sat" >
</olmap>
</code>

++++ Voir la carte |
<olmap id="Satellite" lat="43.838" lon="4.359" controls="off" statusbar="0" baselyr="google sat" >
</olmap>
++++
==== Points d'intérêts ====
Carte [[#minimale]] avec zoom sur deux points d'intérêts.

<code xml olmap.xml>
<olmap id="CafeAnais" lat="43.838" lon="4.359" controls="off" statusbar="0" zoom="16">
43.83941,4.36152,0,.8,marker.png,**Café d'ANAIS**\\ Place des esclafidous \\ Site Web : [[https://cafe.reseauanais.fr]] \\ Wiki : [[https://wikicafe.reseauanais.fr]]\\
43.83206, 4.36533,0,.8,train.png,La Gare
</olmap>
</code>
++++ Voir la carte |
<olmap id="CafeAnais" lat="43.838" lon="4.359" controls="off" statusbar="0" zoom="16">
43.83941,4.36152,0,.8,marker.png,**Café d'ANAIS**\\ Place des esclafidous \\ Site Web : [[https://cafe.reseauanais.fr]] \\ Wiki : [[https://wikicafe.reseauanais.fr]]\\
43.83206, 4.36533,0,.8,train.png,La Gare
</olmap>
++++
==== Autres exemples ====

Vous trouverez d'autres exemples (en anglais) sur le [[https://dokuwikispatial.sourceforge.io/dokuwiki/openlayersmap:start|site de test des développeurs du module]].



<WRAP center round box 95%>


++++ Voir la liste des pages de ce dossier |
<nspages -h1  -exclude -textPages="Pages dans ce dossier" -hideNoPages  -hideNoSubns -actualTitle=4 -nbCol=2>
++++

Retour [[.sommaire]]

</WRAP>