Module:Coordinates/Documentation

De Wikonsult
Sauter à la navigation Sauter à la recherche

Ceci est la page de documentation pour Module:Coordinates

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 :

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}} : Erreur Lua : callParserFunction: function "#coordinates" was not found
      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}} : Erreur Lua : callParserFunction: function "#coordinates" was not found
      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}} : Erreur Lua : callParserFunction: function "#coordinates" was not found
      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}} : Erreur Lua : callParserFunction: function "#coordinates" was not found
  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}} : Erreur Lua : callParserFunction: function "#coordinates" was not found
  3. dec pour un affichage degrée/minute/seconde
    • {{#Invoke:Coordinates | coord |43|29|4|N|79|23|0|W|format=dec}} : Erreur Lua : callParserFunction: function "#coordinates" was not found

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}} Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Toronto, entrée en écriture décimale
{{#invoke:Coordinates|coord|-33.856111|151.1925}} Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Sydney, entrée en écriture décimale
{{#invoke:Coordinates|coord|43.65|-79.38}} Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Toronto, avec moins de précision
{{#invoke:Coordinates|coord|43.6500|-79.3800}} Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Toronto,avec des zéros supplémentaires
{{#invoke:Coordinates|coord|43.651234|N|79.383333|W}} Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found 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}} Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Toronto, avec degrés et minutes
{{#invoke:Coordinates|coord|43|29|4|N|79|23|0|W}} Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Toronto, avec degrés, minutes et secondes
{{#invoke:Coordinates|coord|43|29|4.5|N|79|23|0.5|W}} Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Toronto, avec degrés, minutes, secondes et fractions de secondes
{{#invoke:Coordinates|coord|43/29/N|79/23/W}} Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found Erreur Lua : callParserFunction: function "#coordinates" was not found 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}} Erreur Lua : callParserFunction: function "#coordinates" was not found Toronto, appel basique
{{#invoke:Coordinates|coord|43.65|-79.38|scale:3000000}} Erreur Lua : callParserFunction: function "#coordinates" was not found 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}} Erreur Lua : callParserFunction: function "#coordinates" was not found 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}} Erreur Lua : callParserFunction: function "#coordinates" was not found 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}} Erreur Lua : callParserFunction: function "#coordinates" was not found Toronto, en mentionnant deux paramètres.
{{#invoke:Coordinates|coord|43.65|-79.38|region:CA}} Erreur Lua : callParserFunction: function "#coordinates" was not found 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}} Erreur Lua : callParserFunction: function "#coordinates" was not found 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}} Erreur Lua : callParserFunction: function "#coordinates" was not found 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}} : Coordonnées : orientation de longitude invalide, devrait être "E" ou "W"

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