Voir la source de Module:Coordinates/Documentation

{{Protection}}
== Utilisation ==

Fonctions exportables :
* <code>coordinates.coord(frame)</code> – Fonction qui permet 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.
* <code>p.dec2dms(frame)</code> – Fonction permettant de convertir des coordonnées exprimées dans le [[système décimal]] dans le [[système sexagésimal]]
* <code>p.dms2dec(frame)</code> – Fonction permettant de convertir des coordonnées dans l'autre sens (du [[système sexagésimal]] dans le [[système décimal]])
* <code>p.latitude(frame)</code> – récupère la latitude de coordonnées (locale ou stockées sur Wikidata). Surtout utile pour les infoboîtes
* <code>p.longitude(frame)</code> –  récupère la longitude de coordonnées (locale ou stockées sur Wikidata). Surtout utile pour les infoboîtes
* <code>p.distance(frame)</code> –  calcule la distance entre deux points dont on précise les latitudes et longitudes. 

* <code>p._coord(args)</code> – similaire à p.coord, mais à utiliser depuis un autre module Lua
* <code>p._dms2dec(dmsobject)</code> – similaire à p.dms2dec, mais à utiliser depuis un autre module Lua
* <code>p._dec2dms(coordtype, precision)</code> – similaire à p.dec2dms, mais à utiliser depuis un autre module Lua
* <code>p._distance(a, b, globe)</code> –  calcule la distance entre deux points dont on précise les latitudes et longitudes
* <code>p._parsedmsstring(str, dimension)</code> - créé une table dms à partir d'une chaîne de type "48/22/16/W".



fonctions internes
*<code>makeerror</code> - gestion des erreurs
*<code>makeerror</code> - buildHTML (construit le HTML pour la fonction p.coord()
*<code>displaydmsdimension</code> - transforme une table dms contenant degrees, minutes, seconds, directions et coordtype (=latitude ou longitude) en une chaîne du type 48° 29' 32 " N
*<code>validdms</code> - vérifie qu'une table dms est valide (direction valides et coordtype valide, valeurs autorisées pour les dégrés, minutes et secondes)
*<code>builddmsdimension</code> - crée une table dms
*<code>displaydec</code> - transforme une latitude et une longitude décimal en chaîne du type "34.294, 12.321"
*<code>parsedec</code> - analyse et valide des coordonnées décimales
*<code>convertprcision</code> - transforme la précision trouvée par module:Math.precision en "d", "dm" ou "dms"
*<code>convertwikidataprecision</code> -  transforme la précision indiquée par les données Wikidata en "d", "dm" ou "dms"
*<code>determinedmsprec</code> - calcule le degré de précision le plus adaptées pour des coordonnées décimales données
*<code>dec2dms_d</code> - convertit une coordonnées décimale en coordonnées dms de niveau de précision degré
*<code>dec2dms_dm</code> - convertit une coordonnées décimale en coordonnées dms de niveau de précision minute
*<code>dec2dms_dms</code> - convertit une coordonnées décimale en coordonnées dms de niveau de précision seconde
*<code>wikidatacoords</code> - récupère des coordonnées sur Wikidata

variables internes
* globedata : table des planètes supportées par geohack, en indiquant le rayon (pour calculer les distances), la catégorie de maintenance, et le format d'affichage des coordonnées par défaut
* wikidatathreshold : distance maimum par défaut entre les coordonnées données sur Wikipédia et celles de Wikidata. Au delà du seuil. la page est catégorisée dans [[:Catégorie:Page avec coordonnées différentes sur Wikidata]]

Modules externes et autres éléments dont ce module a besoin pour fonctionner :
* <code>[[Module:Math]]</code> – Pour gérer les arrondis et la précision.
* <code>[[Module:Wikidata]]</code> – Pour récupérer les coordonnées sur Wikidata

==Exemples basiques==
Il existe deux moyens pour renseigner dans un article des coordonnées
#À partir des '''coordonnées décimales'''
#* <code><nowiki>{{#Invoke:Coordinates | coord |43.651234|-79.383333}}</nowiki></code> : {{#Invoke:Coordinates | coord|43.651234|-79.383333}}
#*:la latitude(''43.651234'') et la longitude (''-79.383333'') de [[Toronto]] sont renseignés sous formes décimale
#À partir des '''coordonnées sexagésimales'''
#* <code><nowiki>{{#Invoke:Coordinates | coord |43|29|4|N|79|23|0|W}}</nowiki></code> : {{#Invoke:Coordinates | coord|43|29|4|N|79|23|0|W}}
#*:la latitude(''43/29/4/N'') et la longitude (''79/23/0/W'') de [[Toronto]] sont renseignés sous forme d'un quadruplet Heure/Minute/Seconde/Sens représentant le calcul sous forme de minutes d'arc.
#* <code><nowiki>{{#Invoke:Coordinates | coord |43/29/4/N|79/23/0/W}}</nowiki></code> : {{#Invoke:Coordinates | coord|43/29/4/N|79/23/0/W}}
#*:la latitude(''43/29/4/N'') et la longitude (''79/23/0/W'') de [[Toronto]] sont renseignés directement
#À partir des '''[[d:Property:P625|coordonnées géographiques]]''' issu de Wikidata <u>seulement pour les coordonnées principale d'un article</u>
#* <code><nowiki>{{#Invoke:Coordinates | coord }}</nowiki></code>

Le format de sortie est par défaut le format d'entrée mais on peut le changer en passant un argument supplémentaire sous la forme <code>|format=xxx</code>
#'''dms''' pour un affichage degrée/minute/seconde
#* <code><nowiki>{{#Invoke:Coordinates | coord |43.651234|-79.383333|format=dms}}</nowiki></code> : {{#Invoke:Coordinates | coord|43.651234|-79.383333|format=dms}}
#'''dms long''' pour un affichage degrée/minute/seconde avec l'orientation en toute lettres
#* <code><nowiki>{{#Invoke:Coordinates | coord |43.651234|-79.383333|format=dms long}}</nowiki></code> : {{#Invoke:Coordinates | coord|43.651234|-79.383333|format=dms long}}
#'''dec''' pour un affichage degrée/minute/seconde
#* <code><nowiki>{{#Invoke:Coordinates | coord |43|29|4|N|79|23|0|W|format=dec}}</nowiki></code> : {{#Invoke:Coordinates | coord|43|29|4|N|79|23|0|W|format=dec}}

== Options de la fonction p.coord ==
Option de la fonction p.coord (utilisable depuis Lua)
* latitude = 
* longitude =
* globe = (voir la table globedata pour la liste 
* format = format d'affichage : dms, dec, dms long (affiche la direction en entier), dec east (calcule la latitude dans la direction Est et l'affiche, dms west calcule la longitude dans la direction Ouest et l'affiche
* displaytitle = mettre sur "true" si l'on veut afficher les coordonnées dans le titre
* formattitle = si l'on souhaite un format particulier pour les coordonnées de titre
* wikidata = mettre sur "true" lorsque l'on souhaite récupérer les coordonnées Wikidata
* wikidataquery = pour effectuer une requête Wikidata personnalisée (voir [[Module:Wikidata]])

== Exemples détaillés ==
=== Entrée en écriture décimale ===
{|class="wikitable" width="100%"
|-
! Code !! Résultat !! Résultat <br />''<nowiki>|format=dec</nowiki>'' !! Résultat <br />''<nowiki>|format=dms</nowiki>'' !! Résultat <br />''<nowiki>|format=dms long</nowiki>'' !! Notes
|-
| <nowiki>{{#invoke:Coordinates|coord|43.651234|-79.383333}}</nowiki>
| {{#invoke:Coordinates|coord|43.651234|-79.383333}} || {{#invoke:Coordinates|coord|43.651234|-79.383333|format=dec}} || {{#invoke:Coordinates|coord|43.651234|-79.383333|format=dms}}|| {{#invoke:Coordinates|coord|43.651234|-79.383333|format=dms long}}
 |[[Toronto]], entrée en écriture décimale
|-
| <nowiki>{{#invoke:Coordinates|coord|-33.856111|151.1925}}</nowiki>
| {{#invoke:Coordinates|coord|-33.856111|151.1925}} || {{#invoke:Coordinates|coord|-33.856111|151.1925|format=dec}} || {{#invoke:Coordinates|coord|-33.856111|151.1925|format=dms}}|| {{#invoke:Coordinates|coord|-33.856111|151.1925|format=dms long}}
 |[[Sydney]], entrée en écriture décimale
|-
| <nowiki>{{#invoke:Coordinates|coord|43.65|-79.38}}</nowiki>
| {{#invoke:Coordinates|coord|43.65|-79.38}} || {{#invoke:Coordinates|coord|43.65|-79.38|format=dec}} || {{#invoke:Coordinates|coord|43.65|-79.38|format=dms}}|| {{#invoke:Coordinates|coord|43.65|-79.38|format=dms long}}
| [[Toronto]], avec moins de précision
|-
| <nowiki>{{#invoke:Coordinates|coord|43.6500|-79.3800}}</nowiki>
| {{#invoke:Coordinates|coord|43.6500|-79.3800}} || {{#invoke:Coordinates|coord|43.6500|-79.3800|format=dec}} || {{#invoke:Coordinates|coord|43.6500|-79.3800|format=dms}}|| {{#invoke:Coordinates|coord|43.6500|-79.3800|format=dms long}}
| [[Toronto]],avec des zéros supplémentaires
|-
| <nowiki>{{#invoke:Coordinates|coord|43.651234|N|79.383333|W}}</nowiki>
| {{#invoke:Coordinates|coord|43.651234|N|79.383333|W}} || {{#invoke:Coordinates|coord|43.651234|N|79.383333|W|format=dec}} || {{#invoke:Coordinates|coord|43.651234|N|79.383333|W|format=dms}}|| {{#invoke:Coordinates|coord|43.651234|N|79.383333|W|format=dms long}}
| [[Toronto]], écriture N/W plutôt que +/-
|}

=== Entrée en écriture sexagésimale ===
{|class="wikitable" width="100%"
|-
! Code !! Résultat !! Résultat <br />''<nowiki>|format=dec</nowiki>'' !! Résultat <br />''<nowiki>|format=dms</nowiki>'' !! Résultat <br />''<nowiki>|format=dms long</nowiki>'' !! Notes
|-
| <nowiki>{{#invoke:Coordinates|coord|43|29|N|79|23|W}}</nowiki>
| {{#invoke:Coordinates|coord|43|29|N|79|23|W}} || {{#invoke:Coordinates|coord|43|29|N|79|23|W|format=dec}} || {{#invoke:Coordinates|coord|43|29|N|79|23|W|format=dms}}|| {{#invoke:Coordinates|coord|43|29|N|79|23|W|format=dms long}}
 |[[Toronto]], avec degrés et minutes
|-
| <nowiki>{{#invoke:Coordinates|coord|43|29|4|N|79|23|0|W}}</nowiki>
| {{#invoke:Coordinates|coord|43|29|4|N|79|23|0|W}} || {{#invoke:Coordinates|coord|43|29|4|N|79|23|0|W|format=dec}} || {{#invoke:Coordinates|coord|43|29|4|N|79|23|0|W|format=dms}}|| {{#invoke:Coordinates|coord|43|29|4|N|79|23|0|W|format=dms long}}
 |[[Toronto]], avec degrés, minutes et secondes
|-
| <nowiki>{{#invoke:Coordinates|coord|43|29|4.5|N|79|23|0.5|W}}</nowiki>
| {{#invoke:Coordinates|coord|43|29|4.5|N|79|23|0.5|W}} || {{#invoke:Coordinates|coord|43|29|4.5|N|79|23|0.5|W|format=dec}} || {{#invoke:Coordinates|coord|43|29|4.5|N|79|23|0.5|W|format=dms}}|| {{#invoke:Coordinates|coord|43|29|4.5|N|79|23|0.5|W|format=dms long}}
 |[[Toronto]], avec degrés, minutes, secondes et fractions de secondes
|-
| <nowiki>{{#invoke:Coordinates|coord|43/29/N|79/23/W}}</nowiki>
| {{#invoke:Coordinates|coord|43/29/N|79/23/W}} || {{#invoke:Coordinates|coord|43/29/N|79/23/W|format=dec}} || {{#invoke:Coordinates|coord|43/29/N|79/23/W|format=dms}}|| {{#invoke:Coordinates|coord|43/29/N|79/23/W|format=dms long}}
 |[[Toronto]] avec les coordonnées en un seul champ séparé par le symbole /
|}

=== Paramètres de format pour {{m|GeoTemplate}} ===
{{Article détaillé|amorce=Pour la liste exhaustive|modèle:GeoTemplate/Utilisation{{!}}GeoTemplate/Utilisation}}
Ici, c'est le lien qui est modifié : il faut cliquer dessus pour voir les différences
{|class="wikitable" width="100%"
|-
! Code !! Résultat !! Notes
|-
| <nowiki>{{#invoke:Coordinates|coord|43.65|-79.38}}</nowiki>
| {{#invoke:Coordinates|coord|43.65|-79.38}}
| [[Toronto]], appel basique
|-
| <nowiki>{{#invoke:Coordinates|coord|43.65|-79.38|scale:3000000}}</nowiki>
| {{#invoke:Coordinates|coord|43.65|-79.38|scale:3000000}}
| [[Toronto]], avec une échelle au pays<br/>''scale:N'' avec N un nombre sans espace (par défaut 300000)
|-
| <nowiki>{{#invoke:Coordinates|coord|40.6892|-74.0445|dim:100}}</nowiki>
| {{#invoke:Coordinates|coord|40.6892|-74.0445|dim:100}}
| [[Statue de la Liberté]] avec un diamètre de 100 m<br/>autre moyen pour afficher une échelle adaptée.
|-
| <nowiki>{{#invoke:Coordinates|coord|43.65|-79.38|type:city}}</nowiki>
| {{#invoke:Coordinates|coord|43.65|-79.38|type:city}}
| [[Toronto]], en mentionnant comme type de structure une ville de grande taille<br/>''scale:N'' avec N un nombre sans espace (par défaut 300000)
|-
| <nowiki>{{#invoke:Coordinates|coord|43.65|-79.38|region:CA_type:city}}</nowiki>
| {{#invoke:Coordinates|coord|43.65|-79.38|region:CA_type:city}}
| [[Toronto]], en mentionnant deux paramètres.
|-
| <nowiki>{{#invoke:Coordinates|coord|43.65|-79.38|region:CA}}</nowiki>
| {{#invoke:Coordinates|coord|43.65|-79.38|region:CA}}
| [[Toronto]], en mentionnant le Canada comme pays<br/>utile pour sélectionner des fonds cartographiques appropriés à la région.
|-
| <nowiki>{{#invoke:Coordinates|coord|9.7|-20.0|globe:moon}}</nowiki>
| {{#invoke:Coordinates|coord|9.7|-20.0|globe:moon}}
| [[Copernic (cratère)|cratère Copernic]] sur la Lune<br/>utile pour sélectionner des fonds cartographiques appropriés à la région.
|-
| <nowiki>{{#invoke:Coordinates|coord|43.65|-79.38|name=Toronto}}</nowiki>
| {{#invoke:Coordinates|coord|43.65|-79.38|name=Toronto}}
| [[Toronto]], en présisant non pas le titre de la page mais le nom de l'article<br/>utile pour des pages avec homonymies.
|}

=== Affichage dans la barre de titre ===
Il est possible de renseigner les coordonnées en haut de la page en précisant l'argument <code>|display=</code>
*<nowiki>{{#invoke:Coordinates|coord|43.65|-79.38|display=inline}}</nowiki> : Affiche uniquement les coordonnées dans le corps du texte
*:C'est le comportement par défaut
*<nowiki>{{#invoke:Coordinates|coord|43.65|-79.38|display=title}}</nowiki> : Affiche uniquement les coordonnées dans la barre de titre
*<nowiki>{{#invoke:Coordinates|coord|43.65|-79.38|display=inline,title}}</nowiki> : Affiche les coordonnées dans le corps du texte et dans la barre de titre
{{catégorise|article géolocalisé}}

Pour un affichage différent entre les coordonnées dans le texte et celui dans le titre, on peut utiliser l'argument <code>|formatitle</code>
*<nowiki>{{#invoke:Coordinates|coord|43.65|-79.38|display=inline,title|format=dec|formatitle=dms}}</nowiki> : Affiche les coordonnées dans le corps du texte en décimal et dans la barre de titre au format sexagésimal

=== Gestion des erreurs ===
Si les paramètres sont mal renseignés ou incorrects, une balise est affiché à coté des coordonnées précisant le type d'erreur.

;Exemple d'appel erronés
*<nowiki>{{#invoke:Coordinates|coord|2843.65|-79.38}}</nowiki> : {{#invoke:Coordinates|coord|2843.65|-79.38}}
{{catégorise|Page avec des balises de coordonnées mal formées}}

== Utilisation des sous-fonctions ==
=== Conversion décimal vers sexagésimal ===
Permet de convertir une des deux coordonnées (latitude ou longitude) d'un système vers l'autre

<code><nowiki>{{#Invoke:Coordinates</nowiki> | '''dec2dms''' | ''donnée'' | ''direction positive'' | ''direction négative'' | ''précision''<nowiki>}}</nowiki></code>
*''donnée'' : le nombre décimal
*''direction positive'' : la direction (N pour la latitude / E pour la longitude)
*''direction négative'' : la direction (S pour la latitude / O pour la longitude)
*''précision'' : D , DM ou DMS

;Exemple
* <code><nowiki>{{#invoke:Coordinates|dec2dms|43.651234|N|S|DMS}}</nowiki></code> : {{#invoke:Coordinates|dec2dms|43.651234|N|S|DMS}}
* <code><nowiki>{{#invoke:Coordinates|dec2dms|43.651234|Nord|Sud|DM}}</nowiki></code> : {{#invoke:Coordinates|dec2dms|43.651234|N|S|DM}}

=== Conversion sexagésimal vers décimal ===
Permet de convertir une des deux coordonnées (latitude ou longitude) d'un système vers l'autre

<code><nowiki>{{#Invoke:Coordinates</nowiki> | '''dms2dec''' | ''direction'' | ''degrés'' | ''minutes'' | ''secondes''<nowiki>}}</nowiki></code>
*''direction'' : la direction (N/S/E/O)
*''degrés'' ,''minutes'' ,''secondes'' : la donnée exprimés sous forme de mesure d'arc

;Exemple
* <code><nowiki>{{#invoke:Coordinates|dms2dec|N|43|29|4}}</nowiki></code> : {{#invoke:Coordinates|dms2dec|N|43|29|4}}
* <code><nowiki>{{#invoke:Coordinates|dms2dec|N|43|29}}</nowiki></code> : {{#invoke:Coordinates|dms2dec|N|43|29}}


<code><nowiki>{{#Invoke:Coordinates</nowiki> | '''dms2dec''' | ''direction'' | ''degrés'' | ''minutes'' | ''secondes''<nowiki>}}</nowiki></code>

;Exemple
* <code><nowiki>{{#invoke:Coordinates|dms2dec|43/29/4/N}}</nowiki></code> : {{#invoke:Coordinates|dms2dec|43/29/4/N}}
* <code><nowiki>{{#invoke:Coordinates|dms2dec|43/29/N}}</nowiki></code> : {{#invoke:Coordinates|dms2dec|43/29/N}}

== Voir aussi ==
* {{m|coord}}
<noinclude>
[[Catégorie:Documentation de module]]
</noinclude><includeonly>[[Catégorie:Module protégé]]</includeonly>