Module:Coordinates/Documentation

Ceci est une page protégée.
Une nouvelle de Wikinews, la source d'informations que vous pouvez écrire.

Ceci est la page de documentation pour Module:Coordinates


Utilisation[modifier le wikicode]

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[modifier le wikicode]

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[modifier le wikicode]

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[modifier le wikicode]

Entrée en écriture décimale[modifier le wikicode]

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[modifier le wikicode]

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}}[modifier le wikicode]

Pour la liste exhaustive : GeoTemplate/Utilisation.

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[modifier le wikicode]

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[modifier le wikicode]

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[modifier le wikicode]

Conversion décimal vers sexagésimal[modifier le wikicode]

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[modifier le wikicode]

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[modifier le wikicode]

Modèle:Projet Scribunto