Wikipédia:Jargon/Modèle de paramétrage de carte
Un article de Wikipédia, l'encyclopédie libre.
Cette page définit un jargon de Wikipédia. Cette page est un patch info et peut-être employée en inclusion comme un modèle. |
Cette page décrit les caractéristiques d'un "Modèle de paramétrage de carte".
Sommaire |
[modifier] Définition
Un modèle de paramétrage de carte est une sous-page de Modèle:Géolocalisation
de la forme Modèle:Géolocalisation/<nom de code de la carte>
qui fournit des informations (métadonnées) sur l'image d'une carte géographique. Un tel modèle est employé (entre autres) par le modèle {{Géolocalisation}} où il assure la conversion des coordonnées (latitude, longitude) d'un emplacement, en position (x
, y
) sur la carte ; ce qui permet une géolocalisation.
[modifier] Description détaillée
Un nom d'un modèle de paramétrage de carte est Modèle:Géolocalisation/<nom de code de la carte>
. Ce type de modèle est avant tout employé par le modèle {{Géolocalisation}} ainsi :
{{Géolocalisation|<nom de code de la carte>|<latitude>|<longitude>|...}}
Voici les fonctions que ce type de modèle doit assurer au minimum :
Code Wiki | Explication |
---|---|
{{Géolocalisation/<nom>|y|<latitude>|<longitude>}} |
retourne un coefficient qui, multiplié à une largeur donnée pour l'image, donne la position verticale sur l'image d'un lieu dont les coordonnées géographiques sont passées en paramètres. |
{{Géolocalisation/<nom>|x|<latitude>|<longitude>}} |
retourne un coefficient qui, multiplié à une largeur donnée pour l'image, donne la position horizontale sur l'image d'un lieu dont les coordonnées géographiques sont passées en paramètres. |
{{Géolocalisation/<nom>|image}} |
retourne le nom de l'image (sans l'espace de noms) |
{{Géolocalisation/<nom>|iwidth}} |
retourne la largeur de l'image en pixels |
{{Géolocalisation/<nom>|iheight}} |
retourne la hauteur de l'image en pixels |
Les fonctions supplémentaires suivantes ne sont pas nécessaires à la géolocalisation ; mais apporte des informations très utiles pour la documentation, la catégorisation, et l'utilisation du modèle. Le présence de ces paramètres est donc devenue obligatoire :
Code Wiki | Explication |
---|---|
{{Géolocalisation/<nom>|name}} |
Le nom de la région (zone) représentée. Ce nom doit correspondre au nom de code de la carte. De plus, lorsque la zone est spécifiée, le nom doit logiquement correspondre à un article existant. |
{{Géolocalisation/<nom>|zone}} |
Le type de zone représentée (facultatif). Cela permet la sous-catégorisation du modèle. Actuellement les valeurs possibles sont : monde • pays • planète • région française . |
{{Géolocalisation/<nom>|geo}} |
Un paramètre geo est un numéro de code de région pour World Gazetteer dédié au modèle {{Lien World Gazetteer}} (en savoir plus). |
De même, les modèles annexes de Catégorie:Modèle de fonction mathématique pour la cartographie) réclament certaines des fonctions suivantes :
Code Wiki | Explication |
---|---|
{{Géolocalisation/<nom>|latitude}} |
retourne la latitude au centre de la carte. |
{{Géolocalisation/<nom>|top}} |
retourne la latitude sur le méridien centrale en haut de la carte. |
{{Géolocalisation/<nom>|bottom}} |
retourne la latitude sur le méridien centrale en bas de la carte. |
{{Géolocalisation/<nom>|longitude}} |
retourne la longitude au centre de la carte. |
{{Géolocalisation/<nom>|left}} |
retourne la longitude sur le parallèle centrale à gauche de la carte. |
{{Géolocalisation/<nom>|right}} |
retourne la longitude sur le parallèle centrale à droite de la carte. |
Enfin, lorsque la zone
est planète
, la fonction suivantes est obligatoire :
Code Wiki | Explication |
---|---|
{{Géolocalisation/<nom>|diamètre}} |
retourne la valeur du diamètre (équatorial) de la planète en km. |
Le code wiki de ces modèles prend la forme suivante :
{{#switch:{{{1}}} |y={{#expr: ... }} |x={{#expr: ... }} |image=... |iwidth=... |iheight=... ... }}</includeonly><noinclude> {{Documentation paramétrage de carte}} </noinclude>
[modifier] Les modèles génériques
Cependant ces modèles peuvent être construit à l'aide de modèles génériques (ou méta-modèle) dont le nom prend la forme Modèle:Géolocalisation/Projection <type>
. Les modèles génériques assure une fonction supplémentaire : {{Géolocalisation/<nom>|code}}
qui permet le remplacement du modèle générique par une version optimisée. Un modèle générique doit assurer une fonction supplémentaire : la fonction {{Géolocalisation/<nom>|code}}
qui doit retourner le code d'un modèle équivalent sous une forme optimisée. Il peut également assurer des fonctions pour ses propres arguments (entre autres).
[modifier] La version optimisée
Pour alléger le code d'un modèle de paramétrage de carte qui emploie un modèle générique, les modèles génériques ont une fonction supplémentaire code
{{Géolocalisation/<nom>|code|...}}
qui retourne un code de substitution pour le modèle de paramétrage de carte qui l'emploie. Cette version optimisée simplifie considérablement les formules de conversion.
Attention ! l'écriture de modèles génériques de paramétrage de carte, et particulièrement de leur fonction code
est extrêmement délicate. Il est donc fortement recommandé de ne pas y toucher sans une parfaite connaissance de la syntaxe wiki et de bonnes connaissances en mathématiques.
[modifier] Comparaisons avec la version (en)
Contrairement à la version (en) (cf. en:Template:Location map), un modèle de paramétrage de carte ne contient pas seulement des paramètres d'une carte, mais également les fonctions de conversion coordoonnées géographiques → position sur la carte. Cela présente de multiples avantages :
-
- le procédé n'est pas limité à la projection orthographique, mais est adaptable à tout système de projection.
- le nombre "d'appel" au modèle de paramétrage de carte est réduit
- le modèle {{Géolocalisation}} est très simple
- l'emploie d'une version optimisée permet de réduire le coût des calculs de conversion.
En revanche, un modèle de paramétrage de carte est plus complexe (il suffit de comparer Modèle:Géolocalisation/Iran et en:Template:Location map of Iran). C'est pourquoi un modèle de paramétrage de carte doit d'abord être créé à l'aide d'un modèle générique.
[modifier] Exemples
[modifier] {{Géolocalisation/Iran}}
Code wiki | Rendu |
---|---|
{{Géolocalisation/Iran|image}} |
Iran locator.png |
{{Géolocalisation/Iran|iwidth}} |
723 |
{{Géolocalisation/Iran|iheight}} |
599 |
{{Latitude|Iran}} |
32.46 |
{{Longitude|Iran}} |
53.83 |
{{Déformation cartographique|Iran}} |
1.0856118747491 |
{{Géolocalisation/Iran|x|34.08|49.70 }} |
0.28992878942014 |
{{Géolocalisation/Iran|y|34.08|49.70 }} |
0.32428924758694 |
[modifier] {{Géolocalisation/Russie}}
Coordonnées géographiques des villes du pays : Russie
Code wiki | Rendu |
---|---|
{{Géolocalisation/Russie|image}} |
Blank map of Russia-geoloc.svg |
{{Géolocalisation/Russie|iwidth}} |
636 |
{{Géolocalisation/Russie|iheight}} |
326 |
{{Géolocalisation/Russie|top}} |
90.2 |
{{Géolocalisation/Russie|bottom}} |
49 |
{{Géolocalisation/Russie|left}} |
|
{{Géolocalisation/Russie|right}} |
|
{{Latitude|Russie}} |
69.6 |
{{Longitude|Russie}} |
95.2 |
{{Déformation cartographique|Russie}} |
0.95738194656168 |
{{Géolocalisation/Russie|x|54.71|20.50 }} |
0.089273417126688 |
{{Géolocalisation/Russie|y|54.71|20.50 }} |
0.15184765158207 |
[modifier] Améliorations envisageables
[modifier] Ajout de fonctions
Une amélioration envisageable est l'ajout d'un paramètre pour l'article partitif. Cela permettrait d'écrire « Carte {Géolocalisation/<nom>|article partitif}} <nom>
» (par exemple : « Carte de la Lune » ; « Carte du Gabon » ; ...). Cependant c'est loin d'être satisfaisant :
Code Wiki | Explication |
---|---|
{{Géolocalisation/<nom>|article partitif}} |
retourne l'article partitif pour ce <nom>. |
article partitif
nom de code de la carte | valeur de article partitif |
---|---|
États-unis ... | des |
France | de (la) (encore problématique) |
Gabon | du |
Allemagne ... | d' |
Lune ... | de la |
Mars ... | de |