Voir la source de Modèle:Coord/Documentation

<noinclude>{{documentation modèle vue directement}}</noinclude>
{{Modèle simple importé de Wikipédia
 |url=http://fr.wikipedia.org/w/index.php?title=Mod%C3%A8le:Coord&oldid=38432958
 |url documentation = http://fr.wikipedia.org/w/index.php?title=Mod%C3%A8le:Coord/Documentation&oldid=60866026
}}

__NOTOC__
== 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 {{lang|en|[[Google Maps]]}} par exemple.

Pour insérer des coordonnées dans un article, suivez la procédure suivante (le manuel complet est plus bas) :
# Trouvez les coordonnées de l’endroit, avec un logiciel (comme {{lang|en|[[Google Earth]]}}) ou un site adapté (comme [http://tools.freeside.sk/geolocator/geolocator.html GeoLocator], [http://mapper.acme.com ACME Mapper], [[Géoportail]]…), 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''').
# Écrivez à l’endroit souhaité de l’article le code suivant : <code><nowiki>{{coord|</nowiki>''vos coordonnées''}}</code>, en séparant les coordonnées par une barre verticale. En format décimal, cela donne : <code><nowiki>{{coord|26.456|-3.765}}</nowiki></code> ; en format DM, ceci : <code><nowiki>{{coord|26|24.5|N|3|58.25|W}}</nowiki></code> ; en format DMS, ceci : <code><nowiki>{{coord|26|24|30|N|3|58|15|W}}</nowiki></code>. 
#* <u>Note</u> : pour DM et DMS, n’oubliez pas de préciser N/S/E/W.
# Ajoutez éventuellement des paramètres après une autre barre verticale. Par exemple, pour une ville, ajoutez <code>type:city</code>, pour un bâtiment <code>type:landmark</code> ; vous pouvez préciser l’échelle avec <code>scale:20000</code> (échelle 1:{{nombre|20000}}), la région du monde avec <code>region:FR</code> (FR étant le code [[ISO 3166-1#Table de codage triée par le nom français de pays ou territoire normalisé par l’ISO|ISO 3166-1 alpha 2]] de la France). Pour une ville française vue à l’échelle 1:{{nombre|10000}}, vous écrirez donc : <code><nowiki>{{coord|26|24|30|N|3|58|15|W|type:city_region:FR_scale:10000}}</nowiki></code>.
#* <u>Note</u> : ces paramètres sont séparés par un tiret bas ; liste complète '''[[Modèle:GeoTemplate/Utilisation|sur cette page]]'''.
# Par défaut, les coordonnées sont écrites là où le modèle est placé ; vous pouvez les afficher dans le titre en ajoutant <code><nowiki>|display=title</nowiki></code>. Vous pouvez aussi choisir d’afficher des coordonnées décimales en format DMS en ajoutant <code>|format=dms</code>, ou des coordonnées DM/DMS en format décimal avec <code>format=dec</code>. Exemple : <code><nowiki>{{coord|26.456|-3.765|format=dms}}</nowiki></code>
# Enfin, n’oubliez pas de [[Aide:Sourcer|préciser la source]] des coordonnées, par exemple avec une [[Aide:Notes|note]]. Ainsi, en cas de contestation, on sait comment retrouver l’origine de votre choix.

Le modèle complet peut donc ressembler à ceci : 
: <code><nowiki>{{coord|26|24|30|N|3|58|15|W|type:city_region:FR_scale:10000|format=dec|display=title}}</nowiki></code>. 
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 {{m|coord}}.

__TOC__

== Utilisation ==
* Ce modèle {{m|Coord}} permet de créer un lien vers [http://toolserver.org/~geohack/geohack.php?language=fr Geohack], un outil du toolserver 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 (proportion)|é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 <code>globe:moon</code> ou <code>globe:mars</code>, 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 seulement), voir que jusqu’au degrés (D seulement).
* Le '''[[Wikipédia:WikiMiniAtlas|WikiMiniAtlas]]''' est activé, donc un petit globe [[Image:Geographylogo.svg|18px]] 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 [[Geo (microformat)|Géoformat]] : voir [[:en:WP:GEOUF]] et http://microformats.org/wiki/geo {{en}}.
* {{m|Coord}} est également utilisé par des outils qui extraient les coordonnées depuis la base de données, comme [[Google Earth]] ou le [[Wikipédia:WikiMiniAtlas|WikiMiniAtlas]]. <!-- Pour qu’un article soit référencé, il faut que l’option <code>display=title</code> soit utilisée (voir plus bas). Pour plus d’informations, voir [http://earth.google.com/userguide/v4/geoweb_faq.html comment Google utilisent les coordonnées géographiques produites par Wikipédia]. {{en}}-->

== Syntaxe ==
Voici quatre exemples de syntaxe possible :
* <tt><nowiki>{{</nowiki>coord|''latitude''|''longitude''|''paramètres des coordonnées''|''paramètres du modèle''<nowiki>}}</nowiki></tt>
* <tt><nowiki>{{</nowiki>coord|''lat deg''|''N/S''|''lon deg''|''E/W''|''paramètres des coordonnées''|''paramètres du modèle''<nowiki>}}</nowiki></tt>
* <tt><nowiki>{{</nowiki>coord|''lat deg''|''lat min''|''N/S''|''lon deg''|''lon min''|''E/W''|''paramètres des coordonnées''|''paramètres du modèle''<nowiki>}}</nowiki></tt>
* <tt><nowiki>{{</nowiki>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''<nowiki>}}</nowiki></tt>

=== Paramètres du modèle ===
* Les ''[[coordonnées géographiques]]'', celles-ci peuvent être écrites au [[système décimal|format décimal]] (auquel cas « latitude » et « longitude » prennent leurs valeurs décimales, comme par exemple « <code>-45.76843</code> » ou « <code>87.234567</code> » (utilisez un point comme séparateur décimal), ou au [[système sexagésimal|format sexagésimal]] : ''deg'' pour les degrés, ''min'' pour les minutes, ''sec'' pour les secondes avec « <code>N</code> » ou « <code>S</code> » pour la latitude et « <code>E</code> » ou « <code>W</code> » pour la longitude (n’utilisez pas la lettre « <code>O<code> » !)
* ''Les paramètres de coordonnées'', ce sont les paramètres d’[[échelle (proportion)|échelle]] qui pourront être compris par [http://toolserver.org/~geohack/geohack.php?pagename=Wikip%C3%A9dia:WikiMiniAtlas&language=fr Geohack], comme « <code>type:</code> », « <code>scale:</code> », « <code>region:</code> », « <code>altitude:</code> »… Si il y en a plusieurs en même temps, il faut les séparer par un tiret bas « _ » (exemple : « <code>type:landmark_scale:50000</code> »). Pour la liste exhaustive voir '''[[Modèle:GeoTemplate/Utilisation|GeoTemplate/Utilisation]]'''.
* ''Les paramètres du modèle'', ce sont « <code>display</code> », « <code>format</code> » et « <code>name</code> » :
** <code>display</code> peut prendre les valeurs <code>inline</code>, ou <code>title</code>, ou encore <code>inline,title</code>. La syntaxe <code>display=inline</code> (par défaut) permet d’afficher les coordonnées dans le texte, là où le modèle est placé ; <code>display=title</code> affiche les coordonnées juste en dessous de la barre de titre, à droite ; <code>display=inline,title</code> fait les deux à la fois. Note : utilisez <code>title</code> pour signifier que les coordonnées en question concernent tout l’article.
** <code>format</code> force le format d’affichage si on le veut différent du format des coordonnées géographiques entrées. <code>format=dec</code> donne un affichage décimal, <code>format=dms</code> un affichage sexagésimal, et <code>format=dms long</code> un affichage sexagésimal en français sur deux lignes (pratique dans les [[Aide:Infobox|infobox]], mais déconseillé dans les titres, utilisez alors <code>format=dms</code>). Par défaut, l’affichage est dans le même format que les arguments.
** <code>name</code> 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 [[Aide:Infobox|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 ».

== Exemples ==

=== Quelques exemples choisis ===
{|class="wikitable"
|-
! Code !! Résultat !! Notes
|-
| <code><nowiki>{{Coord|43.651234|-79.383333}}</nowiki></code> || {{Coord|43.651234|-79.383333}} || [[Toronto]], entrée et sortie (affichage) en écriture décimale
|-
| <code><nowiki>{{Coord|43.65|-79.38}}</nowiki></code> || {{Coord|43.65|-79.38}} || [[Toronto]], entrée et sortie en écriture décimale mais avec moins de précision
|-
| <code><nowiki>{{Coord|43.6500|-79.3800}}</nowiki></code> || {{Coord|43.6500|-79.3800}} || [[Toronto]], entrée et sortie en écriture décimale avec des zéros supplémentaires
|-
| <code><nowiki>{{Coord|43.651234|N|79.383333|W}}</nowiki></code> || {{Coord|43.651234|N|79.383333|W}} || [[Toronto]], entrée et sortie en écriture décimale, mais écriture N/W plutôt que +/-
|-
| <code><nowiki>{{Coord|43|29|N|79|23|W}}</nowiki></code> || {{Coord|43|29|N|79|23|W}} || [[Toronto]], entrée et sortie en [[Système sexagésimal|écriture sexagésimale]], avec degrés et minutes
|-
| <code><nowiki>{{Coord|43|29|4|N|79|23|0|W}}</nowiki></code> || {{Coord|43|29|4|N|79|23|0|W}} || [[Toronto]], entrée et sortie en [[Système sexagésimal|écriture sexagésimale]], avec degrés, minutes et secondes
|-
| <code><nowiki>{{Coord|43|29|4.5|N|79|23|0.5|W}}</nowiki></code> || {{Coord|43|29|4.5|N|79|23|0.5|W}} || [[Toronto]], entrée et sortie en [[Système sexagésimal|écriture sexagésimale]], avec degrés, minutes, secondes et fractions de secondes
|-
| <code><nowiki>{{Coord|55.752222|N|37.615556|E}}</nowiki></code> || {{Coord|55.752222|N|37.615556|E}} || [[Moscou]], entrée au format décimal avec N/S/E/W (sans +/-), sortie au format décimal avec  +/- (sans N/S/E/W)
|-
| <code><nowiki>{{coord|55.752222|N|37.615556|E</nowiki><br /><nowiki>|format=dms}}</nowiki></code> || {{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.
|-
| <code><nowiki>{{Coord|39.098095|-94.587307</nowiki><br /><nowiki>|format=dms}}</nowiki></code> || {{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.
|-
| <code><nowiki>{{Coord|39.098095|-94.587307</nowiki><br /><nowiki>|format=dms long}}</nowiki></code> || {{Coord|39.098095|-94.587307|format=dms long}} || [[Kansas City]], même chose que précédemment, sauf affichage en français.
|-
| <code><nowiki>{{Coord|22|S|43|W}}</nowiki></code> || {{Coord|22|S|43|W}} || [[Degree Confluence Project|Intersection de degrés]]
|-
| <code><nowiki>{{coord|52|29|N|1|54|W}}</nowiki></code> || {{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.
|-
| <code><nowiki>{{coord|52|28|59|N|1|53|37|W}}</nowiki></code> || {{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.
|-
| <code><nowiki>{{coord|52|28|59|N|1|53|37|W|format=dec}}</nowiki></code> || {{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.
|-
| <code><nowiki>{{coord|52|28|59|N|1|53|37|W</nowiki><br /><nowiki>|display=inline,title</nowiki><br /><nowiki>|region:GB_type:city}}</nowiki></code> || {{coord|52|28|59|N|1|53|37|W|display=inline,title|region:GB_type:city}} || [[Birmingham]], avec paramètres supplémentaires (affichage des coordonnées en haut de cette page, précision de l’échelle de type <code>city</code>).
|-
| <code><nowiki>{{coord|52|28|59|N|1|53|37|W</nowiki><br /><nowiki>|format=dms long</nowiki><br /><nowiki>|scale:100000}}</nowiki></code> || {{coord|52|28|59|N|1|53|37|W|format=dms long|scale:100000}} || [[Birmingham]], visualisation demandée à une échelle de 1:{{nombre|100000}}. <br />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 '''[[Modèle:Coord/Exemple dec|Coord/Exemple en décimal]]'''
* Si les [[coordonnées géographiques]] entrées sont dans le [[système sexagésimal]], voir '''[[Modèle:Coord/Exemple dms|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 à [[Special:Mypage/vector.css|votre vector.css]] :
*: <code>.geo-default { display: inline } .geo-nondefault { display: inline } <br />.geo-dec { display: none }   .geo-dms { display: inline }</code>
* Pour toujours afficher les coordonnées au format décimal, ajoutez le code suivant à [[Special:Mypage/vector.css|votre vector.css]] :
*: <code>.geo-default { display: inline } .geo-nondefault { display: inline }<br />.geo-dec { display: inline } .geo-dms { display: none }</code>
* Pour afficher les deux formats ensemble, ajoutez le code suivant à [[Special:Mypage/vector.css|votre vector.css]] :
*: <code>.geo-default { display: inline } .geo-nondefault { display: inline }<br />.geo-dec { display: inline }   .geo-dms { display: inline }<br />.geo-multi-punct { display: inline }</code>

== Remarque importante ==
* Avant toute modification du modèle présent, notez que les noms de classe « <code>geo</code> », « <code>latitude</code> » et « <code>longitude</code> » sont utilisés pour générer le [[microformat]] avec [[Geo (microformat)|Géoformat]] (voir [http://microformats.org/wiki/microformats microformats.org]) et NE DOIVENT PAS ÊTRE MODIFIÉS.

<includeonly>
[[Catégorie:Modèle de coordonnées| ]]


</includeonly>