Modification de Aide:GoogleMaps

{{Conventions}}

L'extension Maps permet de visualiser de manière dynamique (avec zoom,  déplacement, etc) un lieu, partout dans le monde.

Cet outil a été ajouté à Scoutopedia pour permettre de mieux rendre compte des différents lieux scouts, et sera donc par conséquent utilisé principalement sur le [[Portail:Scoutisme dans le monde|portail du scoutisme dans le monde]]. Néanmoins, utilisé sur cette page ou ailleurs, voici des informations pour ajouter des lieux à une carte, ou des nouvelles cartes, si vous le jugez nécessaire à tel ou tel endroit de Scoutopedia.

== Cartes statiques ou dynamiques ==

Une carte statique est une carte pour laquelle les données à afficher sont insérées statiquement, c'est à dire directement dans l'article lui-même. Par exemple, si vous éditez la page d'un centre de formation et que vous voulez afficher une vue satellite locale avec les limite de la propriété et les quelques points remarquables, vous utiliserez certainement une carte statique. Si les données évoluent, un contributeur aura d'abord l'idée de modifier la page de l'article et les données qui y sont inscrites. Cala n'empêchera pas le visiteur de pouvoir se déplacer sur la carte, zoomer, changer le fond de carte, etc ...

Les cartes statiques s'opposent aux cartes dynamiques qui vont aller récupérer des informations dans d'autres articles pour se mettre à jour. Typiquement, ce type de carte est utilisé pour le référencement et le géopositionnement des groupes scouts d'un échelon. Lorsque vous affichez la carte dynamique des groupes de l'échelon X, vous récupérez la liste des points de tous les articles géopositionnés qui sont associés à cet échelon, en les filtrant éventuellement (pour n'afficher que les groupes ouverts par exemple) puis vous les affichez sous forme de carte.

Ainsi lorsqu'un contributeur modifie la page d'un groupe de cet échelon pour changer son géopositionnement, le point est dynamiquement modifié sur la carte de la structure. De la même manière, si un contributeur vient modifier la page d'un groupe pour indiquer qu'il est désormais fermé, si vous avez filtré la carte sur les groupes ouverts, alors le point associé au groupe disparaitra de la carte des groupes ouverts de la structure (et apparaitra dans la liste des groupes fermés, si vous en avez mis une, par exemple). Le tout sans avoir à modifier la page de l'échelon !

Bien évidemment les cartes dynamiques ont l'inconvénient de leur avantage. Si elles sont très puissantes et permettent de faire des choses très complexes et automatiques, elles nécessitent de comprendre des notions avancées et auront besoin de plus de travail pour les mettre en place et les maintenir.

== Formatage des coordonnées géographiques ==

Bien que le système de cartographie supporte de nombreux formats, il vous est conseillé d'utiliser la convention en '''degrés décimaux non directionnels'''. Les coordonnées sont établies comme deux nombres décimaux variant entre -90 et +90 pour la latitude et entre -180 et +180 pour la longitude. Les décimales sont séparées des unités par un point. La latitude précède la longitude et elles sont séparées par une virgule et un espace. Les valeurs négatives correspondent au sud et à l'ouest et sont précédées d'un signe moins. Les valeurs positives correspondent au nord et à l'est mais ne sont pas précédées d'un signe.

Exemples :
* 12.12345, -23.12345
* -2.75264, 1.12398

5 chiffres après la virgule suffisent ; ils donnent une précision d'environ 1m.

{{voir article|wp-fr:Coordonnées_géographiques}}

== Créer une carte statique ==


=== Éditeur de carte ===

Pour les utilisateurs débutants, il existe un éditeur de carte [http://semantic-mediawiki.org/wiki/Special:MapEditor ici] {{en}}.

Pour fabriquer une nouvelle carte, élaborez votre carte à l'aide de l'éditeur puis cliquez sur "Export to wiki code".

Une popup s'ouvre avec le code wiki à copier / coller dans sur scoutopédia pour afficher la carte.

=== Syntaxe d'une carte statique ===

Les utilisateurs qui sont suffisamment à l'aise avec le système de cartographie peuvent écrire leur propre code directement :

<pre>{{#display_map:
coordonnées
|width = 400
|height = 300
|zoom = 18
|center = coordonnées
}}
</pre>

* width : largeur de la carte en pixels (par défaut : largeur de la page)
* height : hauteur de la carte en pixels (par défaut : 350 pixels)
* zoom : niveau de zoom de la carte au chargement (par défaut : plus proche permettant d'afficher tous les points)
* center : permet de centrer la carte sur un point précis (par défaut : centre des points affichés)

Les coordonnées sont les points à afficher sur la carte. Vous pouvez utiliser soit des coordonnées au format GPS indiqué plus haut, soit donner une adresse qu'un système de géolocalisation sera chargé de transformer en coordonnées GPS. Pour afficher plusieurs points, il suffit de séparer les coordonnées ou adresses par un point-virgule (un retour de ligne est facultatif mais permet d'améliorer la lisibilité du code). L'ensemble de ces points doivent être déclarés avant le moindre paramètre de carte. Il est aussi possible d'afficher une carte n'affichant aucun point de coordonnées.

Exemple:
<pre>{{#display_map:
22.46383,-62.578125;
31.23347,-52.812525;
Miami, Florida
}}</pre>
{{#display_map:
22.46383,-62.578125;
31.23347,-52.812525;
Miami, Florida
}}

=== Points interactifs ===

Par défaut les points sont manifestés par un marqueur standard et le visiteur ne pourra pas interagir avec eux. Il est cependant possible d'enrichir le comportement des points en ajoutant des paramètres supplémentaires pour en faire des points interactifs, de type bulle ou de type lien. Lorsqu'un utilisateur clique sur un point de type bulle, cela affiche une petite bulle avec une description que vous aurez précisée. Lorsqu'il clique sur un lien, il est directement redirigé vers une nouvelle page.

<pre>{{#display_map:
22.46383,-62.578125 ~ title ~ text ~ icon ~ group ~ label ~ visited;
31.23347,-52.812525 ~ link:address ~ icon ~ group ~ label ~ visited
}}</pre>

Il est possible d'omettre un paramètre en laissant son champ vide.

* title et text : titre et description du point affichés dans la bulle, séparés par une barre horizontale. La syntaxe wiki est active.
* address : URL absolue externe ou titre d'un article de scoutopédia vers lequel l'utilisateur sera redirigé en cliquant sur le marqueur.
* icon : nom de l'image à utiliser à la place du marqueur par défaut. URL ou <nowiki>Fichier:</nowiki>
* group : ''l'utilisation de ce paramètre n'est pas documenté pour l'instant ; le laisser vide''
* label : génère une marqueur de type textuel plutôt que d'utiliser une image.
* visited : nom de l'image à utiliser pour le marqueur après que l'utilisateur ait cliqué dessus.

=== Artéfacts ===

En plus d'ajouter des points, il est possible d'ajouter des artéfacts comme des lignes, des rectangles, des cercles et des polygones. Pour cela, il suffit d'ajouter les paramètres adéquats dans la balise de la carte. Comme pour les autres paramètres de carte ils doivent être déclarés après l'ensemble de la liste des points affichés. Il est possible de déclarer plusieurs artéfacts du même type les uns à la suite des autres.

'''Toutes les coordonnées utilisées par les artéfacts doivent forcément être des points GPS ; les adresses ne seront pas acceptées.''' Si vous voulez tester vos artéfacts sur l'éditeur de cartes, sachez aussi qu'il ne supporte pas très bien les espaces et les retours de ligne. Pensez donc à les supprimer avant de faire un "Import from Wiki code".

Tous les artéfacts peuvent être rendus interactifs ou non-interactifs de la même manière que les points, en utilisant les formats suivants :
* non interactif : <nowiki>|<attribut> = <coordonnées> ~ ~ ~ <autres options></nowiki>
* type bulle : <nowiki>|<attribut> = <coordonnées> ~ titre ~ texte ~ <autres options></nowiki>
* type lien : <nowiki>|<attribut> = <coordonnées> ~ link:address ~ <autres options></nowiki>

Les format des données sont toutes identiques :
* les couleurs sont [http://www.w3schools.com/cssref/css_colors.asp au format CSS HEX].
* les décimales sont séparées des unités par un point (les virgules ne fonctionneront pas)

Les options des artéfacts suivent toutes le même modèle :
* stroke color : la couleur du trait de contour (type couleur)
* fill color : la couleur du remplissage du rectangle (type couleur)
* stroke opacity : l'opacité du trait de contour (nombre décimal, 0 = transparent, 1 = opaque)
* fill opacity : l'opacité du remplissage du rectangle (nombre décimal, 0 = transparent, 1 = opaque)
* stroke weight : épaisseur du trait de contour (nombre entier)

==== Lignes ====

<pre>
|lines =
<point 1> :
<point 2> :
(...)
<point 3>

|lines =
<point 1> :
<point 2> :
(...)
<point 3>
~ title ~ text ~ stroke color ~ stroke opacity ~ stroke weight
</pre>

Pour insérer une ligne ou un polygone vide (un polygone vide est tout simplement une ligne dont le premier et le dernier point sont identiques) il suffit de lister les coordonnées GPS des points qu'ils devront relier en les séparant par deux points. Pour plus de lisibilité il est recommandé de revenir à la ligne entre chaque point.

==== Rectangles ====
<pre>
|rectangles = <point 1> : <point 2>

|rectangles = <point 1> : <point 2>
~ title ~ text ~ stroke color ~ stroke opacity ~ stroke weight ~ fill color ~ fill opacity
</pre>

Pour insérer une forme rectangulaire, il suffit de donner deux points GPS qui constitueront les deux angles opposés du rectangle. Les deux autres points sont automatiquement calculés à partir des premiers en combinant leur latitude et leur longitude.

==== Cercles ====
<pre>
|circles = <point> : <radius>

|circles = <point> : <radius>
~ title ~ text ~ stroke color ~ stroke opacity ~ stroke weight ~ fill color ~ fill opacity
</pre>

Pour insérer un cercle, il suffit de préciser les coordonnées du point central et la longueur du rayon. Ce dernier est fourni sous la forme d'un décimal et l'unité de base est le mettre. Un cercle de rayon 10km aura donc un radius de 10000.0

==== Polygones pleins ====

<pre>
|polygons =
<point 1> :
<point 2> :
(...)
<point 3>

|polygons = 
<point 1> :
<point 2> :
(...)
<point 3>
~ title ~ text ~ stroke color ~ stroke opacity ~ stroke weight ~ fill color ~ fill opacity
</pre>

Pour insérer un polygone plein, il suffit de préciser la liste des coordonnées des différents points qui constituent le polygone de la même manière que pour la ligne ou le polygone vide. Contrairement à eux, il n'est pas nécessaire de répéter le premier point à la fin, puisque l'on sait que l'on va devoir de toutes façons refermer le polygone pour le remplir.

=== Références ===
[http://semantic-mediawiki.org/wiki/Maps Site officiel de l'extension maps] (utile pour les utilisateurs expert)

== Créer une carte dynamique ==

Avant de lancer dans l'aventure de l'élaboration d'une nouvelle carte dynamique, vous devez vous familiariser avec l'utilisation des données relationnelles sur Scoutopédia.

{{voir article|Aide:SemanticMediaWiki}}

=== Géopositionner une article ===

La première étape pour pouvoir afficher une liste de points GPS à partir d'une requête sémantique consiste à géopositionner des articles pour avoir des informations à exploiter. Pour celà, nous avons déjà créé un [[Attribut:Coordonnées GPS]]. Il suffit donc de le quantifier pour l'article, par exemple en insérant le texte suivant : <tt><nowiki>[[Coordonnées GPS::1.12345, 1.12345]]</nowiki></tt>

Note aux utilisateurs connaissant l'ancien système : il n'est plus nécessaire d'utiliser le [[Modèle:Coordonnées]]. En effet, désormais on ne spécifie plus la façon dont la bulle s'affiche au niveau de l'article, mais au niveau de la liste (voir plus bas).

=== Afficher les résultats ===

Fondamentalement, une carte dynamique est rien d'autre qu'un moyen visuel de représenter des coordonnées géographiques extraites d'une requête sémantique. On aurait tout aussi bien pu représenter ces coordonnées par leur valeur textuelle en degrés décimaux ou en degrés sexagésimaux et les lister dans un tableau, mais c'est quand même plus pratique pour les visiteurs de les afficher dans une carte dans laquelle ils vont pouvoir naviguer. Afficher une carte dynamique revient tout simplement à faire une requête sémantique et à préciser le format <tt>map</tt>. Bien évidemment, il faut que la requête retourne un attribut de type GPS pour que cela fonctionne.

Par exemple, pour afficher la carte de tous les hauts lieux du scoutisme en France, il faut écrire :

<pre>
{{#ask: [[Catégorie:Haut_lieu_du_scoutisme_en_France]]
|?Coordonnées GPS
|format = map
|height = 600
|centre = France
|zoom = 6
}}
</pre>

{{#ask: [[Catégorie:Haut_lieu_du_scoutisme_en_France]]
|?Coordonnées GPS
|format = map
|height = 600
|centre = France
|zoom = 6
}}

=== Enrichir le résultat ===

Par défaut, la carte affichée est assez sommaire. Elle affiche tous les points des articles géopositionnés et les rend interactifs. Lorsqu'on clique dessus, une petite bulle s'ouvre avec le nom de l'article et un lien vers celui-ci. Évidemment, nous allons vouloir enrichir un peu ces données pour les rendre plus exploitable.

==== Ajouter des points supplémentaires ====

Reprenons le scénario classique de l'affichage des groupes d'une structure. Nous sommes dans la page de la structure et nous faisons une requête sur les articles géopositionnés de la catégorie associée et nous affichons la carte. Mais en plus de la liste des groupes, nous voulons afficher aussi un point supplémentaire pour le secrétariat de la structure. Il suffit d'ajouter le paramètre <tt>|staticlocations = (...)</tt>. Ce paramètre prend le même format que les points que nous avons placé dans les cartes statiques. On peut donc préciser si le point est interactif ou pas, ajouter le titre, le texte descriptif, ou en faire un lien, changer le marqueur (pour mettre un dessin de boîte à lettres par exemple), etc ...

==== Ajouter des artéfacts ====

Il est possible d'ajouter des artéfacts de la même manière qu'on l'a fait pour les cartes statiques.

La syntaxe est strictement la même !

==== Enrichir les bulles ====

Comme indiqué plus haut, la façon dont les bulles des articles géopositionnés sont élaborées ne dépendent plus de l'article concerné, mais de la liste. Cela apporte l'avantage de pouvoir représenter des informations différentes d'une liste à l'autre. Par exemple, on peut ajouter le nom de l'association d'un groupe dans sa description lorsqu'on liste les groupes d'une région administrative, et ne pas l'afficher quand on liste les groupes d'une structure d'une seule association.

Pour cela, il va falloir créer un [[Aide:Modèle|modèle]].

Ce modèle pourra utiliser 3 paramètres nommés qui correspondent aux infos de l'article dont on veut afficher la bulle :
* {{{title}}}
* {{{latitude}}}
* {{{longitude}}}

Ensuite, ce modèle recevra chacune des [[Spécial:Propriétés|propriété]] qui aura été demandée dans la requête comme paramètre anonyme ({{{1}}}, {{{2}}}, etc.). Il est donc conseillé de commencer par écrire le modèle, puis de créer les propriétés nécessaires, de remplir les valeurs dans les articles (ou via un modèle), et enfin de générer la liste. Pour informer la liste du modèle que nous voulons utiliser pour faire le rendu des bulles, on ajoute le paramètre <tt>|template = (nom du modèle)</tt> dans la requête sémantique.

=== Résoudre les problèmes de "polygons" ===

Si vous voyez une carte d'une structure scoute sous laquelle s'affiche le message indiquant un problème avec les "polygons" ou si les contours géographique d'une structure n’apparaissent pas dans sa carte (on voit seulement les marqueurs des articles), c'est probablement que la liste des points GPS du contour de cette structure n'ont pas encore été migré vers la nouvelle version du système de cartographie.

La correction est très simple. Tout d'abord il faut se rendre sur la page <tt>Catégorie:(Nom de la structure)/Coordonnées GPS</tt>. Cette sous page doit simplement afficher un texte comme <tt>Cette page a pour rôle de stocker les coordonnées GPS du contour xxx</tt>. Si c'est le cas, vous êtes sur la bonne page ! Cliquez ensuite sur "Modifier". Le code doit commencer par quelque chose comme :

<pre>
<includeonly>
#AAFDE5E5 (#AAFDE5E5)
48.502048, -1.098633
48.041365, -1.054687
47.813155, -1.241455

...
</pre>

Si c'est le cas, vous êtes effectivement sur une page de gestion des coordonnées GPS qui n'est pas à jour. Pour la mettre à jour, rien de plus simple. Supprimez la ligne avec les #, puis ajoutez un caractère ':' à la fin de chacune des lignes avec des coordonnées GPS '''sauf la dernière''' (celle qui précède la ligne avec la balise <tt><nowiki></includeonly><noinclude></nowiki></tt>). Sauvegardez les modifications en mettant un commentaire adéquat puis rafraichissez la carte ; ça devrait marcher. Si ce n'est pas le cas, demandez de l'aide.

=== Références ===

[http://semantic-mediawiki.org/wiki/Help:Google_Maps_format Liste des paramètres supportés] (utilisateurs experts)

{{sommaire de l'aide}}

[[catégorie:aide technique]]