Modèle:Coord

Ce modèle à risque est inclus sur un très grand nombre de pages et ne peut pas être modifié.

Cette protection ne constitue pas obligatoirement une approbation de la version actuelle. Vous pouvez proposer une modification en page de discussion. Lorsqu'un compromis sera trouvé en page de discussion, vous pourrez demander la modification auprès des administrateurs (voir le journal des protections).

Ce modèle utilise le module Coordinates, un script écrit dans le langage de programmation Lua. Toute expérimentation devrait être conduite d'abord via sa sous-page bac à sable. Voir le projet Scribunto si vous voulez en savoir plus.

Ce modèle sert à insérer des coordonnées géographiques dans un article ; il insère en même temps un lien vers l’outil « GeoHack », qui donne accès à de nombreux outils de vues satellites, cartes, etc. comme Google Maps par exemple.

Pour insérer des coordonnées dans un article, suivez la procédure suivante (le manuel complet est plus bas) :

1. Trouvez les coordonnées de l’endroit, avec un logiciel (comme Google Earth) ou un site adapté (comme ACME Mapper, GeoLocator, Géoportail, etc.), ou d’après une source digne de foi. Vous pouvez les trouver dans trois formats, en général : soit sous la forme « 26.456, -3.765 » (degrés décimaux ou dec), soit « 26°24.5′ N, 3°58.25′ W » (degrés et minutes puis fractions de minutes, ou DM), soit « 26°24′30″ N 3°58′15″ » (degrés minutes et secondes, DMS).
2. Écrivez à l’endroit souhaité de l’article le code suivant : {{coord|vos coordonnées}}, en séparant les coordonnées par une barre verticale. En format décimal, cela donne : {{coord|26.456|-3.765}} ; en format DM, ceci : {{coord|26|24.5|N|3|58.25|W}} ; en format DMS, ceci : {{coord|26|24|30|N|3|58|15|W}}.
   • Note : pour DM et DMS, n’oubliez pas de préciser N/S/E/W.
3. Ajoutez éventuellement des paramètres après une autre barre verticale. Par exemple, pour une ville, ajoutez type:city, pour un bâtiment type:landmark ; vous pouvez préciser l’échelle avec scale:20000 (échelle 1/20 000), la région du monde avec region:FR (FR étant le code ISO 3166-1 alpha 2 de la France). Si possible, préférez le code ISO 3166-2. Pour une ville française vue à l’échelle 1/10 000, vous écrirez donc : {{coord|26|24|30|N|3|58|15|W|type:city_region:FR_scale:10000}}.
   • Note : ces paramètres sont séparés par un tiret bas ; liste complète sur cette page.
4. Par défaut, les coordonnées sont écrites là où le modèle est placé ; vous pouvez les afficher dans le titre en ajoutant |display=title. Vous pouvez aussi choisir d’afficher des coordonnées décimales en format DMS en ajoutant |format=dms, ou des coordonnées DM/DMS en format décimal avec format=dec. Exemple : {{coord|26.456|-3.765|format=dms}}
5. Enfin, n’oubliez pas de préciser la source des coordonnées, par exemple avec une note. Ainsi, en cas de contestation, on sait comment retrouver l’origine de votre choix.

Le modèle complet peut donc ressembler à ceci :

{{coord|26|24|30|N|3|58|15|W|type:city_region:FR_scale:10000|format=dec|display=title}}.

En cas de doute sur les paramètres, mieux vaut ne pas recopier le modèle d’une autre page mais se contenter de n'écrire que les coordonnées, sans paramètre.

• Ce modèle {{Coord}} permet de créer un lien vers Geohack, un outil du toolserver qui donne une liste de liens sources vers des cartes, des vues satellites, des photos, etc., pour une position géographique donnée par sa latitude, sa longitude, et son échelle) de visualisation.
• Ce modèle permet également de standardiser la notation des coordonnées géographiques. Il utilise principalement des coordonnées terrestres (il est possible de préciser globe:moon ou globe:mars, sans réel effet pour l’instant) de type WGS84 (latitude - longitude). Ces coordonnées peuvent être entrées et affichées de manière indépendante dans :
  • le système décimal avec des degrés décimaux (DD). La précision dépend alors du nombre de chiffres après la virgule.
  • le système sexagésimal ou degrés-minutes-secondes (DMS). La précision dépend alors du fait que l’on rentre les coordonnées jusqu’au secondes (DMS), ou que jusqu’au minutes (DM seulement), voire que jusqu’au degrés (D seulement).
• Le WikiMiniAtlas est activé, donc un petit globe s’affiche juste avant les coordonnées et montre un atlas interactif : cliquez pour afficher une carte configurable.
• Ces coordonnées géographiques sont lisibles et exportables en Géoformat : voir en:WP:GEOUF et http://microformats.org/wiki/geo (en).
• {{Coord}} est également utilisé par des outils qui extraient les coordonnées depuis la base de données, comme Google Earth ou le WikiMiniAtlas.

Voici quatre exemples de syntaxe possible :

• {{coord|latitude|longitude|paramètres des coordonnées|paramètres du modèle}}
• {{coord|lat deg|N/S|lon deg|E/W|paramètres des coordonnées|paramètres du modèle}}
• {{coord|lat deg|lat min|N/S|lon deg|lon min|E/W|paramètres des coordonnées|paramètres du modèle}}
• {{coord|lat deg|lat min|lat sec|N/S|lon deg|lon min|lon sec|E/W|paramètres des coordonnées|paramètres du modèle}}

• Les coordonnées géographiques, celles-ci peuvent être écrites au format décimal (auquel cas « latitude » et « longitude » prennent leurs valeurs décimales, comme par exemple « -45.76843 » ou « 87.234567 » (utilisez un point comme séparateur décimal), ou au format sexagésimal : deg pour les degrés, min pour les minutes, sec pour les secondes avec « N » ou « S » pour la latitude et « E » ou « W » pour la longitude (n’utilisez pas la lettre « O » !)
• Les paramètres de coordonnées, ce sont les paramètres d’échelle qui pourront être compris par Geohack, comme « type: », « scale: », « region: », « altitude: »… Si il y en a plusieurs en même temps, il faut les séparer par un tiret bas « _ » (exemple : « type:landmark_scale:50000 »). Pour la liste exhaustive voir GeoTemplate/Utilisation.
• Les paramètres du modèle, ce sont « display », « format » et « name » :
  • display peut prendre les valeurs inline, ou title, ou encore inline,title. La syntaxe display=inline (par défaut) permet d’afficher les coordonnées dans le texte, là où le modèle est placé ; display=title affiche les coordonnées juste en dessous de la barre de titre, à droite ; display=inline,title fait les deux à la fois. Note : utilisez title pour signifier que les coordonnées en question concernent tout l’article.
  • format force le format d’affichage si on le veut différent du format des coordonnées géographiques entrées. format=dec donne un affichage décimal, format=dms un affichage sexagésimal, et format=dms long un affichage sexagésimal en français sur deux lignes (pratique dans les infobox, mais déconseillé dans les titres, utilisez alors format=dms). Par défaut, l’affichage est dms pour les coordonnées terrestres.
  • name sert à annoter les coordonnées pour les services externes. S’il est activé, le nom spécifié remplace le nom de l’article sur les cartes générées automatiquement. Par défaut, le nom est le titre de la page, il n’y a donc pas besoin de le spécifier pour les coordonnées dans les infobox ou dans le titre. Il est utile dans le cas où l’on souhaite utiliser dans un article le modèle « Coord » pour situer un point géographique mais qui n’est pas celui de l’article en question.

Les erreurs courantes suivantes sont à éviter, ou le modèle ne fonctionnera pas correctement :

• N’utilisez pas de virgule comme séparateur décimal, mais uniquement un point.
• Ne mettez pas d’espace entre le signe négatif (-) et les nombres : -2.876 est correct, - 2.876 ne l’est pas.
• N’écrivez pas « O » pour Ouest mais « W ».
• Ne pas confondre coordonnées décimales (valeur numérique avec décimales) et coordonnées DMS (degrés/minutes/secondes) : les valeurs DMS ne peuvent pas dépasser 60 pour les minutes ou les secondes ; la latitude ne peut pas dépasser 90°, la longitude ne peut dépasser 180°.
• Ne pas confondre latitude (N ou S) et longitude (E ou W).

Conseil : il est toujours possible de vérifier les coordonnées en cliquant sur le lien généré (par exemple 37° 47′ 24″ N, 122° 24′ 20″ O), et en utilisant une des cartes proposées dans la page GeoHack.

• Si les coordonnées géographiques entrées sont dans le système décimal, voir Coord/Exemple en décimal.
• Si les coordonnées géographiques entrées sont dans le système sexagésimal, voir Coord/Exemple en sexagésimal.

Par défaut, les coordonnées s’affichent dans le format dans lequel elles sont données. Il vous est possible de changer ce comportement.

• Pour toujours afficher les coordonnées au format DMS, ajoutez le code suivant à votre vector.css :

  .geo-default { display: inline } .geo-nondefault { display: inline }
.geo-dec { display: none } .geo-dms { display: inline }

• Pour toujours afficher les coordonnées au format décimal, ajoutez le code suivant à votre vector.css :

  .geo-default { display: inline } .geo-nondefault { display: inline }
.geo-dec { display: inline } .geo-dms { display: none }

• Pour afficher les deux formats ensemble, ajoutez le code suivant à votre vector.css :

  .geo-default { display: inline } .geo-nondefault { display: inline }
.geo-dec { display: inline } .geo-dms { display: inline }
.geo-multi-punct { display: inline }

• Avant toute modification du modèle présent, notez que les noms de classe « geo », « latitude » et « longitude » sont utilisés pour générer le microformat avec Géoformat (voir microformats.org) et NE DOIVENT PAS ÊTRE MODIFIÉS.

• {{Angle}}, pour afficher un angle sans lien
• {{DMS}}, pour convertir des unités d'angle
• Wikipédia:Conventions typographiques#Unités de mesure