Module:Coordinates/Documentation
Ceci est la page de documentation pour Module:Coordinates
Sommaire
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ésimalp.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îtesp.longitude(frame)
– récupère la longitude de coordonnées (locale ou stockées sur Wikidata). Surtout utile pour les infoboîtesp.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 Luap._dms2dec(dmsobject)
– similaire à p.dms2dec, mais à utiliser depuis un autre module Luap._dec2dms(coordtype, precision)
– similaire à p.dec2dms, mais à utiliser depuis un autre module Luap._distance(a, b, globe)
– calcule la distance entre deux points dont on précise les latitudes et longitudesp._parsedmsstring(str, dimension)
- créé une table dms à partir d'une chaîne de type "48/22/16/W".
fonctions internes
makeerror
- gestion des erreursmakeerror
- 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 " Nvaliddms
- 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 dmsdisplaydec
- 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écimalesconvertprcision
- 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éesdec2dms_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 minutedec2dms_dms
- convertit une coordonnées décimale en coordonnées dms de niveau de précision secondewikidatacoords
- récupère des coordonnées sur Wikidata
variables internes
- globedata : table des planètes supportées 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 maimum 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 :
Module:Math
– Pour gérer les arrondis et la précision.Module:Wikidata
– Pour récupérer les coordonnées sur Wikidata
Exemples basiques
Il existe deux moyens pour renseigner dans un article des coordonnées
- À 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
- À 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
- À 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
- 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
- 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
- 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