Voir la source de Modèle:Coord/Documentation

{{Sous-page de documentation}}
{{Modèle utilisant les modules Lua|Coordinates}}
__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 « [[Aide:Geohack|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://mapper.acme.com ACME Mapper], [http://tools.freeside.sk/geolocator/geolocator.html GeoLocator], [[Géoportail (France)|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''').
# É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/{{unité|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). Si possible, préférez le code [[ISO 3166-2]]. Pour une ville française vue à l’échelle 1/{{unité|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.}}, 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 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 '''[[Aide:WikiMiniAtlas|WikiMiniAtlas]]''' est activé, donc un petit globe [[Fichier: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 [[Aide: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 :
* <code><nowiki>{{</nowiki>coord|''latitude''|''longitude''|''paramètres des coordonnées''|''paramètres du modèle''<nowiki>}}</nowiki></code>
* <code><nowiki>{{</nowiki>coord|''lat deg''|''N/S''|''lon deg''|''E/W''|''paramètres des coordonnées''|''paramètres du modèle''<nowiki>}}</nowiki></code>
* <code><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></code>
* <code><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></code>

=== 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 dms pour les coordonnées terrestres.
** <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''' ».
* 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é <small>(par exemple {{coord|37|47|24|N|122|24|20|W|type:city}})</small>, et en utilisant une des cartes proposées dans la page GeoHack.

== 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|format=dec}}</nowiki></code> || {{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)
|-
| <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 (Kansas)|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 (Kansas)|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-BIR_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>).<br /> '''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 à <code>display=title</code>) 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 <code>region:</code>, <code>type:</code> ou <code>scale:</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/{{unité|100000}}. <br />Notez l’affichage en français (déconseillé dans les titres).
|-
! colspan="3" | Nouvelles variantes apportées par le module [[module:Coordinates|Coordinates]]
|-
| <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
|}

=== 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 utilisant du code JavaScript|{{BASEPAGENAME}}]]
[[Catégorie:Modèle de coordonnées| ]]
</includeonly>
<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>