Module:Coordinates/Documentation

Cette page est temporairement protégée
En raison de vandalisme, cette page est temporairement protégée et ne peut être modifiée. Proposer une modification en page de discussion ou à un administrateur

Utilisation

Fonctions exportables :

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

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

fonctions internes

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

variables internes

• globedata : table des planètes prises en charge 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 maximum 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 :

• Module:Math – Pour gérer les arrondis et la précision.
• Module:Wikidata – Pour récupérer les coordonnées sur Wikidata

Exemples basiques

Il existe deux moyens pour renseigner dans un article des coordonnées

1. À partir des coordonnées décimales
   • {{#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

2. À partir des coordonnées sexagésimales
   • {{#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.

   • {{#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

3. À partir des coordonnées géographiques issu de Wikidata seulement pour les coordonnées principale d'un article
   • {{#Invoke:Coordinates | coord }}

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 |format=xxx

1. dms pour un affichage degrée/minute/seconde
   • {{#Invoke:Coordinates | coord |43.651234|-79.383333|format=dms}} :
2. dms long pour un affichage degrée/minute/seconde avec l'orientation en toute lettres
   • {{#Invoke:Coordinates | coord |43.651234|-79.383333|format=dms long}} :
3. dec pour un affichage degrée/minute/seconde
   • {{#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

Code	Résultat	Résultat |format=dec	Résultat |format=dms	Résultat |format=dms long	Notes
{{#invoke:Coordinates|coord|43.651234|-79.383333}}					Toronto, entrée en écriture décimale
{{#invoke:Coordinates|coord|-33.856111|151.1925}}					Sydney, entrée en écriture décimale
{{#invoke:Coordinates|coord|43.65|-79.38}}					Toronto, avec moins de précision
{{#invoke:Coordinates|coord|43.6500|-79.3800}}					Toronto,avec des zéros supplémentaires
{{#invoke:Coordinates|coord|43.651234|N|79.383333|W}}					Toronto, écriture N/W plutôt que +/-

Entrée en écriture sexagésimale

Code	Résultat	Résultat |format=dec	Résultat |format=dms	Résultat |format=dms long	Notes
{{#invoke:Coordinates|coord|43|29|N|79|23|W}}					Toronto, avec degrés et minutes
{{#invoke:Coordinates|coord|43|29|4|N|79|23|0|W}}					Toronto, avec degrés, minutes et secondes
{{#invoke:Coordinates|coord|43|29|4.5|N|79|23|0.5|W}}					Toronto, avec degrés, minutes, secondes et fractions de secondes
{{#invoke:Coordinates|coord|43/29/N|79/23/W}}					Toronto avec les coordonnées en un seul champ séparé par le symbole /

Paramètres de format pour {{GeoTemplate}}

Ici, c'est le lien qui est modifié : il faut cliquer dessus pour voir les différences

Code	Résultat	Notes
{{#invoke:Coordinates|coord|43.65|-79.38}}		Toronto, appel basique
{{#invoke:Coordinates|coord|43.65|-79.38|scale:3000000}}		Toronto, avec une échelle au pays scale:N avec N un nombre sans espace (par défaut 300000)
{{#invoke:Coordinates|coord|40.6892|-74.0445|dim:100}}		Statue de la Liberté avec un diamètre de 100 m autre moyen pour afficher une échelle adaptée.
{{#invoke:Coordinates|coord|43.65|-79.38|type:city}}		Toronto, en mentionnant comme type de structure une ville de grande taille scale:N avec N un nombre sans espace (par défaut 300000)
{{#invoke:Coordinates|coord|43.65|-79.38|region:CA_type:city}}		Toronto, en mentionnant deux paramètres.
{{#invoke:Coordinates|coord|43.65|-79.38|region:CA}}		Toronto, en mentionnant le Canada comme pays utile pour sélectionner des fonds cartographiques appropriés à la région.
{{#invoke:Coordinates|coord|9.7|-20.0|globe:moon}}		cratère Copernic sur la Lune utile pour sélectionner des fonds cartographiques appropriés à la région.
{{#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 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 |display=

• {{#invoke:Coordinates|coord|43.65|-79.38|display=inline}} : Affiche uniquement les coordonnées dans le corps du texte

  C'est le comportement par défaut

• {{#invoke:Coordinates|coord|43.65|-79.38|display=title}} : Affiche uniquement les coordonnées dans la barre de titre
• {{#invoke:Coordinates|coord|43.65|-79.38|display=inline,title}} : Affiche les coordonnées dans le corps du texte et dans la barre de titre

Ce modèle « catégorise » la page qui l’emploie dans la catégorie 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 |formatitle

• {{#invoke:Coordinates|coord|43.65|-79.38|display=inline,title|format=dec|formatitle=dms}} : 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

• {{#invoke:Coordinates|coord|2843.65|-79.38}} :

Ce modèle « catégorise » la page qui l’emploie dans la catégorie 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

{{#Invoke:Coordinates | dec2dms | donnée | direction positive | direction négative | précision}}

• 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

• {{#invoke:Coordinates|dec2dms|43.651234|N|S|DMS}} : 43° 39′ 04″ N
• {{#invoke:Coordinates|dec2dms|43.651234|Nord|Sud|DM}} : 43° 39′ N

Conversion sexagésimal vers décimal

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

{{#Invoke:Coordinates | dms2dec | direction | degrés | minutes | secondes}}

• direction : la direction (N/S/E/O)
• degrés ,minutes ,secondes : la donnée exprimés sous forme de mesure d'arc

Exemple

• {{#invoke:Coordinates|dms2dec|N|43|29|4}} : 43.48444
• {{#invoke:Coordinates|dms2dec|N|43|29}} : 43.483

{{#Invoke:Coordinates | dms2dec | direction | degrés | minutes | secondes}}

Exemple

• {{#invoke:Coordinates|dms2dec|43/29/4/N}} : 43.48444
• {{#invoke:Coordinates|dms2dec|43/29/N}} : 43.483

Voir aussi

• {{coord}}