Module:CoordinatesEN/Documentation

Avertissement important

Ce module sert uniquement pour le modèle:Carte de localisations multiples, car le module:Coordinates ne permet pas une conversion de certaines coordonnées géographiques et renvoie un message d'erreur.

Le module:Coordinates doit être utilisé pour tous les autres usages.

Ce modèle module:CoordinatesEN est utilisé avec le modèle:Coord2.

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.
• coordinates.dec2dms(frame) – Fonction permettant de convertir des coordonnées exprimées dans le système décimal dans le système sexagésimal
• coordinates.dms2dec(frame) – Fonction permettant de convertir des coordonnées dans l'autre sens (du système sexagésimal dans le système décimal)
• coordinates._coord(args) – similaire à p.coord, mais à utiliser depuis un autre module Lua
• coordinates._dms2dec(dmsobject) – similaire à p.dms2dec, mais à utiliser depuis un autre module Lua
• coordinates._dec2dms(coordtype, precision) – similaire à p.dec2dms, mais à utiliser depuis un autre module Lua

[…]

fonctions internes

• 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
• convert_dec2dms_d - convertit une coordonnées décimale en coordonnées dms de niveau de précision degré
• convert_dec2dms_dm - convertit une coordonnées décimale en coordonnées dms de niveau de précision minute
• convert_dec2dms_dms - convertit une coordonnées décimale en coordonnées dms de niveau de précision seconde

[…]

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:Arguments

Exemples basiques

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

1. À partir des coordonnées décimales
   • {{#Invoke:CoordinatesEN | coord |43.651234|-79.383333}} : 43.651234°N 79.383333°W / 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:CoordinatesEN | coord |43|29|4|N|79|23|0|W}} : 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.

   • La syntaxe {{#Invoke:CoordinatesEN | coord |43/29/4/N|79/23/0/W}} n'est pas n'est pas acceptée et génère une erreur :
     
3. À partir des coordonnées géographiques issu de Wikidata seulement pour les coordonnées principale d'un article
   • {{#Invoke:CoordinatesEN | 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:CoordinatesEN | coord |43.651234|-79.383333|format=dms}} : 43°39′04″N 79°23′00″W
2. dec pour un affichage degrée/minute/seconde
   • {{#Invoke:CoordinatesEN | coord |43|29|4|N|79|23|0|W|format=dec}} : 43.48444°N 79.38333°W / 43.48444; -79.38333
3. Il n'y a pas de format dms long.

Exemples détaillés

Entrée en écriture décimale

Code	Résultat	Résultat |format=dec	Résultat |format=dms	Notes
{{#invoke:CoordinatesEN | coord|43.651234|-79.383333}}	43.651234°N 79.383333°W / 43.651234; -79.383333	43.651234°N 79.383333°W / 43.651234; -79.383333	43°39′04″N 79°23′00″W	Toronto, entrée en écriture décimale
{{#invoke:CoordinatesEN | coord|-33.856111|151.1925}}	33.856111°S 151.1925°E / -33.856111; 151.1925	33.856111°S 151.1925°E / -33.856111; 151.1925	33°51′22″S 151°11′33″E	Sydney, entrée en écriture décimale
{{#invoke:CoordinatesEN | coord|43.65|-79.38}}	43.65°N 79.38°W / 43.65; -79.38	43.65°N 79.38°W / 43.65; -79.38	43°39′N 79°23′W	Toronto, avec moins de précision
{{#invoke:CoordinatesEN | coord|43.6500|-79.3800}}	43.6500°N 79.3800°W / 43.6500; -79.3800	43.6500°N 79.3800°W / 43.6500; -79.3800	43°39′00″N 79°22′48″W	Toronto,avec des zéros supplémentaires
{{#invoke:CoordinatesEN | coord|43.651234|N|79.383333|W}}	43.651234°N 79.383333°W / 43.651234; -79.383333	43.651234°N 79.383333°W / 43.651234; -79.383333	43°39′04″N 79°23′00″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	Notes
{{#invoke:CoordinatesEN | coord|43|29|N|79|23|W}}	43°29′N 79°23′W	43.483°N 79.383°W / 43.483; -79.383	43°29′N 79°23′W	Toronto, avec degrés et minutes
{{#invoke:CoordinatesEN | coord|43|29|4|N|79|23|0|W}}	43°29′4″N 79°23′0″W	43.48444°N 79.38333°W / 43.48444; -79.38333	43°29′4″N 79°23′0″W	Toronto, avec degrés, minutes et secondes
{{#invoke:CoordinatesEN | coord|43|29|4.5|N|79|23|0.5|W}}	43°29′4.5″N 79°23′0.5″W	43.484583°N 79.383472°W / 43.484583; -79.383472	43°29′4.5″N 79°23′0.5″W	Toronto, avec degrés, minutes, secondes et fractions de secondes
{{#invoke:CoordinatesEN | 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:CoordinatesEN|coord|43.65|-79.38}}	43.65°N 79.38°W / 43.65; -79.38	Toronto, appel basique
{{#invoke:CoordinatesEN|coord|43.65|-79.38|scale:3000000}}	43.65°N 79.38°W / 43.65; -79.38	Toronto, avec une échelle au pays scale:N avec N un nombre sans espace (par défaut 300000)
{{#invoke:CoordinatesEN|coord|40.6892|-74.0445|dim:100}}	40.6892°N 74.0445°W / 40.6892; -74.0445	Statue de la Liberté avec un diamètre de 100 m autre moyen pour afficher une échelle adaptée.
{{#invoke:CoordinatesEN|coord|43.65|-79.38|type:city}}	43.65°N 79.38°W / 43.65; -79.38	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:CoordinatesEN|coord|43.65|-79.38|region:CA_type:city}}	43.65°N 79.38°W / 43.65; -79.38	Toronto, en mentionnant deux paramètres.
{{#invoke:CoordinatesEN|coord|43.65|-79.38|region:CA}}	43.65°N 79.38°W / 43.65; -79.38	Toronto, en mentionnant le Canada comme pays utile pour sélectionner des fonds cartographiques appropriés à la région.
{{#invoke:CoordinatesEN|coord|9.7|-20.0|globe:moon}}	9.7°N 20.0°W / 9.7; -20.0	cratère Copernic sur la Lune utile pour sélectionner des fonds cartographiques appropriés à la région.
{{#invoke:CoordinatesEN|coord|43.65|-79.38|name=Toronto}}	43.65°N 79.38°W / 43.65; -79.38 (Toronto)	Toronto, en présisant non pas le titre de la page mais le nom de l'article utile pour des pages avec homonymies.

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:CoordinatesEN|coord|2843.65|-79.38}} : 2843.65°N 79.38°W / 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:CoordinatesEN|dec2dms|43.651234|N|S|DMS}} : 43°39′04″N
• {{#invoke:CoordinatesEN|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:CoordinatesEN | 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:CoordinatesEN|dms2dec|N|43|29|4}} : 43.48444
• {{#invoke:CoordinatesEN|dms2dec|N|43|29}} : 43.483

La syntaxe suivante n'est pas accepté : {{#Invoke:CoordinatesEN | dms2dec | degrés/minutes/secondes/direction}}

Exemple d'appel erronés

• {{#invoke:CoordinatesEN|dms2dec|43/29/4/N}} :

Voir aussi

• {{coord}}
• {{coord2}}