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

Il existe une catégorie? dédiée à ce sujet : Modèle de paramétrage de carte.

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 :

Les fonctions communes aux modèles de paramétrage de carte
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 :

Les fonctions supplémentaires communes aux modèles de paramétrage de carte
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 : mondepaysplanèteré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 :

Les fonctions supplémentaires requises les modèles annexes : échelle, distance, déformation, ...
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 :

La fonction supplémentaire pour les planètes
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

Il existe une catégorie? dédiée à ce sujet : Modèle générique de paramétrage de carte.

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.

Icône de détail Aide détaillée : Comment optimiser le modèle ?.

[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éographiquesposition sur la carte. Cela présente de multiples avantages :

  1. le procédé n'est pas limité à la projection orthographique, mais est adaptable à tout système de projection.
  2. le nombre "d'appel" au modèle de paramétrage de carte est réduit
  3. le modèle {{Géolocalisation}} est très simple
  4. 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

Il existe une catégorie? dédiée à ce sujet : Exemple de géolocalisation automatisée.

[modifier] {{Géolocalisation/Iran}}

Les paramètres rendus par le modèle de paramétrage de carte {{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

Image:Blank map of Russia-geoloc.svg
Les paramètres rendus par le modèle de paramétrage de carte {{Géolocalisation/Russie}} pour le 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

Coordonnées géographiques des villes du pays : Russie

[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 :

Les fonctions supplémentaires envisagées
Code Wiki Explication
{{Géolocalisation/<nom>|article partitif}} retourne l'article partitif pour ce <nom>.
Exemples de valeurs de 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


[modifier] Voir aussi