Modèle:Coord/Documentation

Ceci est la sous-page de documentation du modèle {{Coord}} ; elle est insérée sur la page de celui-ci à l’aide du modèle {{Documentation}}. C’est également sur cette page que vous placerez les liens interwiki et les catégories du modèle.

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

Ce modèle sert à insérer des coordonnées géographiques dans une page ; 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 une page, 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é, 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 la page 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^e), la région du monde avec region:FR (FR étant le code ISO 3166-1 alpha 2 de la France). Pour une ville française vue à l’échelle 1:10 000^e, 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 qui donne une liste de liens sources vers des cartes, des vues satellites, des photos etc... ce 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 rentrés 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 seulemnt), voir 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 anglais.
• {{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 toute la page.
  • 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 dans le même format que les arguments.
  • name sert à annoter les coordonnées pour les services externes. S'il est activé, le nom spécifié remplace le nom de la page 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 une page le modèle "Coord" pour situer un point géographique mais qui n'est pas celui de la page 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 ».

Exemples

Quelques exemples choisis

Code	Résultat	Notes
{{Coord|43.651234|-79.383333}}	43.651234, -79.383333	Toronto, entrée et sortie (affichage) en écriture décimale
{{Coord|43.65|-79.38}}	43.65, -79.38	Toronto, entrée et sortie en écriture décimale mais avec moins de précision
{{Coord|43.6500|-79.3800}}	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}}	43.651234, -79.383333	Toronto, entrée et sortie en écriture décimale, mais écriture N/W plutôt que +/-
{{Coord|43|29|N|79|23|W}}	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}}	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}}	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}}	55.752222, 37.615556	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}}	55° 45′ 08″ N 37° 36′ 56″ E	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}}	39° 05′ 53″ N 94° 35′ 14″ W	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}}	39° 05′ 53″ Nord          94° 35′ 14″ Ouest	Kansas City, même chose que précédement, sauf affichage en français.
{{Coord|22|S|43|W}}	22° S 43° W	Intersection de degrés
{{coord|52|29|N|1|54|W}}	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}}	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}}	52.48306, -1.89361	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_type:city}}	52°28′59″N 1°53′37″W	Birmingham, avec paramètres supplémentaires (affichage des coordonnées en haut de cette page, précision de l'échelle de type city).
{{coord|52|28|59|N|1|53|37|W |format=dms long |scale:100000}}	52° 28′ 59″ Nord          1° 53′ 37″ Ouest	Birmingham, visualisation demandée à une échelle de 1:100 000. Notez l'affichage en français (déconseillé dans les titres).

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 monobook.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 monobook.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 monobook.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 http://microformats.org/wiki/microformats) et NE DOIVENT PAS ETRE MODIFIÉS.