Aller au contenu

Module:Coordinates/Documentation

Une page de Wikipédia, l'encyclopédie libre.
Ceci est une version archivée de cette page, en date du 6 mai 2013 à 09:40 et modifiée en dernier par Xfigpower (discuter | contributions). Elle peut contenir des erreurs, des inexactitudes ou des contenus vandalisés non présents dans la version actuelle.

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
  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
  2. dms long pour un affichage degrée/minute/seconde avec l'orientation en toute lettres
  3. dec pour un affichage degrée/minute/seconde

Exemples

Pour des exemples, voir la page de test permettant de tester diverses modifications apportées.