Module:Coordinates/Documentation

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)

Ce module complexe utilise de nombreuses fonctions intermédiaire Autres fonctions :

• displaytitle (s, notes) – Permet l'insertion d'une balise HTML affichant le lien en en haut de page des articles géolocalisés.
• displayinline (s, notes) – Permet l'insertion simple dans le corps du texte.
• function parseDec( lat, long, format ) – Charge les différentes notations dans une variable mémoire à partir des coordonnées décimales; d'autres fonctions permettent de savoir quel format est à utiliser
• parseDMS( lat_d, lat_m, lat_s, lat_f, long_d, long_m, long_s, long_f, format ) – Charge les différentes notations dans une variable mémoire à partir des coordonnées sexagésimales ; d'autres fonctions permettent de savoir quel format est à utiliser
• function specPrinter(args, coordinateSpec) – Permet l'insertion des différentes balises HTML pour afficher les coordonnées, mais aussi celles non visibles exploitables par différents gadget comme WikiMiniAtlas
• function errorPrinter(errors) – Permet l'insertion des différentes balises HTML pour afficher les erreurs dans l'appel au module
• function validate( lat_d, lat_m, lat_s, long_d, long_m, long_s, source, strong ) – Détecte les erreurs de valeurs des coordonnées
• function formatTest(args) – Détecte les erreurs dans les différents arguments passées au module

Modules externes et autres éléments dont ce module a besoin pour fonctionner :

• Module:Math – Pour gérer les arrondis et la précision.

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}} : 43° 39′ 04″ N, 79° 23′ 00″ O

     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}} : 43° 29′ 04″ N, 79° 23′ 00″ O

     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.

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}} : 43° 39′ 04″ N, 79° 23′ 00″ O
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}} : 43° 39′ 04″ nord, 79° 23′ 00″ ouest
3. dec pour un affichage degrée/minute/seconde
   • {{#Invoke:Coordinates | coord |43|29|4|N|79|23|0|W|format=dec}} : 43,48444, −79,38333

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}}	43° 39′ 04″ N, 79° 23′ 00″ O	43,651234, −79,383333	43° 39′ 04″ N, 79° 23′ 00″ O	43° 39′ 04″ nord, 79° 23′ 00″ ouest	Toronto, entrée en écriture décimale
{{#invoke:Coordinates|coord|-33.856111|151.1925}}	33° 51′ 22″ S, 151° 11′ 33″ E	−33,856111, 151,1925	33° 51′ 22″ S, 151° 11′ 33″ E	33° 51′ 22″ sud, 151° 11′ 33″ est	Sydney, entrée en écriture décimale
{{#invoke:Coordinates|coord|43.65|-79.38}}	43° 39′ N, 79° 23′ O	43,65, −79,38	43° 39′ N, 79° 23′ O	43° 39′ nord, 79° 23′ ouest	Toronto, avec moins de précision
{{#invoke:Coordinates|coord|43.6500|-79.3800}}	43° 39′ 00″ N, 79° 22′ 48″ O	43,65, −79,38	43° 39′ 00″ N, 79° 22′ 48″ O	43° 39′ 00″ nord, 79° 22′ 48″ ouest	Toronto,avec des zéros supplémentaires
{{#invoke:Coordinates|coord|43.651234|N|79.383333|W}}	43° 39′ 04″ N, 79° 23′ 00″ O	43,651234, −79,383333	43° 39′ 04″ N, 79° 23′ 00″ O	43° 39′ 04″ nord, 79° 23′ 00″ ouest	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}}	43° 29′ N, 79° 23′ O	43,483, −79,383	43° 29′ N, 79° 23′ O	43° 29′ nord, 79° 23′ ouest	Toronto, avec degrés et minutes
{{#invoke:Coordinates|coord|43|29|4|N|79|23|0|W}}	43° 29′ 04″ N, 79° 23′ 00″ O	43,48444, −79,38333	43° 29′ 04″ N, 79° 23′ 00″ O	43° 29′ 04″ nord, 79° 23′ 00″ ouest	Toronto, avec degrés, minutes et secondes
{{#invoke:Coordinates|coord|43|29|4.5|N|79|23|0.5|W}}	43° 29′ 04,5″ N, 79° 23′ 00,5″ O	43,484583, −79,383472	43° 29′ 04,5″ N, 79° 23′ 00,5″ O	43° 29′ 04,5″ nord, 79° 23′ 00,5″ ouest	Toronto, avec degrés, minutes, secondes et fractions de secondes

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}}	43° 39′ N, 79° 23′ O	Toronto, appel basique
{{#invoke:Coordinates|coord|43.65|-79.38|scale:3000000}}	43° 39′ N, 79° 23′ O	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}}}}	40° 41′ 21″ N, 74° 02′ 40″ O}}	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}}	43° 39′ N, 79° 23′ O	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}}	43° 39′ N, 79° 23′ O	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}}	9,7, −20	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}}	43° 39′ N, 79° 23′ O	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|diplay=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|diplay=title}} : Affiche uniquement les coordonnées dans la barre de titre
• {{#invoke:Coordinates|coord|43.65|-79.38|diplay=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é.

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 utilisant un modèle avec une syntaxe erronée.

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

Voir aussi

• {{coord}}