Modèle:Coord/Documentation

Ceci est la page de documentation de Modèle:Coord [modifier] [purger].

Cette sous-page contient les instructions et les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement.

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 une sous-page bac à sable. Voir le Projet:Scribunto si vous voulez en savoir plus.

Présentation rapide : comment insérer des coordonnées facilement

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 ne mettre que les coordonnées, sans paramètres : ça marchera très bien ainsi. Le reste de cette page explique le fonctionnement en détail du modèle {{coord}}.

Utilisation

• 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.

Syntaxe

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}}

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.

Erreurs courantes

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 ), et en utilisant une des cartes proposées dans la page GeoHack.

Exemples

Quelques exemples choisis

Code	Résultat	Notes
{{Coord|43.651234|-79.383333}}		Toronto, entrée et sortie (affichage) en écriture décimale
{{Coord|43.65|-79.38}}		Toronto, entrée et sortie en écriture décimale mais avec moins de précision
{{Coord|43.6500|-79.3800}}		Toronto, entrée et sortie en écriture décimale avec des zéros supplémentaires
{{Coord|43.651234|N|79.383333|W}}		Toronto, entrée et sortie en écriture décimale, mais écriture N/W plutôt que +/-
{{Coord|43|29|N|79|23|W}}		Toronto, entrée et sortie en écriture sexagésimale, avec degrés et minutes
{{Coord|43|29|4|N|79|23|0|W}}		Toronto, entrée et sortie en écriture sexagésimale, avec degrés, minutes et secondes
{{Coord|43|29|4.5|N|79|23|0.5|W}}		Toronto, entrée et sortie en écriture sexagésimale, avec degrés, minutes, secondes et fractions de secondes
{{Coord|55.752222|N|37.615556|E|format=dec}}		Moscou, entrée au format décimal avec N/S/E/W (sans +/-), sortie au format décimal avec +/- (sans N/S/E/W)
{{coord|55.752222|N|37.615556|E |format=dms}}		Moscou, entrée au format décimal avec N/S/E/W (sans +/-), sortie au format sexagésimal en degrés, minutes, et secondes.
{{Coord|39.098095|-94.587307 |format=dms}}		Kansas City, entrée au format décimal avec +/- (sans N/S/E/W), sortie au format sexagésimal en degrés, minutes, et secondes.
{{Coord|39.098095|-94.587307 |format=dms long}}		Kansas City, même chose que précédemment, sauf affichage en français.
{{Coord|22|S|43|W}}		Intersection de degrés
{{coord|52|29|N|1|54|W}}		Birmingham, entrée au format sexagésimal en degrés et minutes, sortie au même format par défaut.
{{coord|52|28|59|N|1|53|37|W}}		Birmingham, entrée au format sexagésimal en degrés, minutes et secondes, sortie au même format par défaut.
{{coord|52|28|59|N|1|53|37|W|format=dec}}		Birmingham, entrée au format sexagésimal en degrés, minutes et secondes, sortie au format décimal.
{{coord|52|28|59|N|1|53|37|W |display=inline,title |region:GB-BIR_type:city}}		Birmingham, avec paramètres supplémentaires (affichage des coordonnées en haut de cette page, précision de l’échelle de type city). Note : l'échelle fonctionne sur la carte affichée par le lien vers GeoHack, mais ne fonctionne pas actuellement dans la minicarte ajoutée en Javascript par dessus la page de la Wikipédie francophone (grace à display=title) et qui affiche toujours la carte au niveau de zoom 12 sans tenir compte de l'échelle indiquée ou déduite du paramètre 9 (contenant les codes region:, type: ou scale:).
{{coord|52|28|59|N|1|53|37|W |format=dms long |scale:100000}}		Birmingham, visualisation demandée à une échelle de 1/100 000. Notez l’affichage en français (déconseillé dans les titres).
Nouvelles variantes apportées par le module Coordinates
{{coord|52/28/59/N|1/53/37/W}}		Birmingham, entrée au format sexagésimal en degrés, minutes et secondes, sortie au même format par défaut.
{{coord|52/28/59/N|1/53/37/W|format=dec}}		Birmingham, entrée au format sexagésimal en degrés, minutes et secondes, sortie au format décimal

Liste exhaustive des possibilités

• 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.

Personnalisation de l'affichage

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 }

Remarque importante

• 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.

<templatedata> { "params": { "1": { "description": "Latitude avec valeurs décimales ou degrés de latitude", "required": true, "label": "Latitude " }, "2": { "description": "Longitude avec valeurs décimales ou minutes de latitude ou N/S", "required": true, "label": "Longitude " }, "3": { "description": "Longitude avec valeurs décimales ou secondes de latitude ou degrés de longitude ou N/S" }, "4": { "description": "E/W ou N/S ou degrés de longitude" }, "5": { "description": "Degrés de longitude ou minutes de longitude" }, "6": { "description": "Minutes de longitude ou E/W" }, "7": { "description": "Secondes de longitude" }, "8": { "description": "E/W" }, "display": { "label": "Affichage", "description": "Détermine la façon dont les coordonnées sont affichées", "example": "inline, title, inline,title", "default": "inline", "suggested": true }, "format": { "label": "Format d’affichage", "description": "Force le format d’affichage si on le veut différent du format des coordonnées géographiques entrées", "example": "dec donne un affichage décimal, dms un affichage sexagésimal, et dms long un affichage sexagésimal en français sur deux lignes " }, "name": { "label": "Nom", "description": "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" } }, "description": "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.", "format": "{{_|_=_}}\n" } </templatedata>