Aide:Modèle de paramétrage de carte

Méridien central (43.95168, 4.06288) d=0.9566747182126 (43.95168, 4.06288) d=0.9566747182126 Figure 1. Test du modèle de paramétrage de la carte du Gard.

Une catégorie est consacrée à ce sujet : Modèle de paramétrage de carte.

Un modèle de paramétrage de carte est une sous-page de Modèle:Géolocalisation qui fournit des informations (métadonnées) sur l'image d'une carte géographique.

Ce type de modèle est avant tout employé par les modèles {{G}}, ({{G/dms}}, {{Géolocalisation}} ou d'autres similaires, où il assure la conversion des coordonnées (latitude, longitude) d'un emplacement, en position (x, y) sur la carte ; ce qui permet la géolocalisation ou encore la création de cartes complétées.

La création de modèles de paramétrage de carte (aussi appelé modèles de géolocalisation) n'est pas aisée au premier abord. Cette page d'aide vous permet de vous familiariser avec les outils qui permettent leur création.

Avant même de choisir une carte, il vous faut déterminer le système de projection qui conviendra le mieux à votre besoin. Un système de projection est une façon de représenter une zone géographique. Pour faire simple : vous avez le choix entre une projection cylindrique (équirectangulaire, de Mercator...) -dite "simple"- et une projection conique (Albers, Lambert...) -dite "complexe".

De toutes les projections existantes, la projection équirectangulaire ou plate carrée est la plus simple à identifier grâce à ses méridiens et parallèles qui forment un quadrillage constitué de carrés de même taille. Elle est parfaitement adaptée aux cartes couvrant une zone de moins de 1 000 km (figure 1). Au delà, elle tend à déformer la zone géographique représentée, sauf si elle est située à proximité de l'équateur (figure 2). Malgré les déformations qu'elle engendre, la projection équirectangulaire reste fréquemment utilisée pour représenter une planète entière, comme ici ou là. Son implémentation dans un modèle de paramétrage de carte est très simple.

Les projections complexes (conique conforme de Lambert, Albers, sinusoïdale...) nécessitent plus de paramètres que la projection équirectangulaire, ce qui complique la création du modèle de paramétrage de carte. Toutefois, elles sont plus fidèles à la réalité puisqu'elles déforment moins les zones représentées. Si la zone à couvrir est très vaste (supérieure à 1 000 km), ou si elle est située à proximité des pôles, il vaut mieux employer une carte utilisant une projection complexe.

Voici un petit guide pour vous aider à choisir :

La zone à représenter se situe près des pôles ?

Alaska, Canada, Groenland, Antarctique, Sibérie... tous ces territoires sont proches du pôle nord ou sud. Si votre carte représente une zone aussi proche des pôles, il faut forcément utiliser une carte à projection conique, de type Lambert ou Albers, même si la zone couvre moins de 1000 km de distance. Sinon le territoire représenté sera fortement déformé (comparez les figures 3 et 4).

La distance maximale couverte par la carte ne dépasse pas 1 000 km ?

Sur des distances aussi "courtes", le modèle {{Géolocalisation/Projection équirectangulaire}} s'adapte parfaitement à tout type de projection, tant que la zone représentée est suffisamment éloignée des pôles. Vous n'êtes dons pas limité dans le choix de la projection de votre carte.

La distance maximale couverte excède de loin les 1 000 km ?

Si vous représentez une planète entière, optez pour une carte à projection équirectangulaire, c'est à dire pour un planisphère.

Si la zone représentée est très proche de l’équateur, vous pouvez tenter d'utiliser une carte à projection équirectangulaire.

Sinon optez pour une projection conique, sans hésiter.

Vous pouvez maintenant choisir une carte adaptée aux contraintes expliquées précédemment. Notez bien que le modèle de paramétrage de carte sera plus aisé à créer si votre carte :

• Affiche les méridiens et parallèles (voir pourquoi)
• Indique son système de projection
• Indique les coordonnées de ses 4 bords
• Couvre une distance inférieure à 1 000 km

Si aucun de ces critères n'est rempli, il faut trouver une autre carte sur Wikimedia Commons ou demander sa création à l'Atelier graphique.

Pour créer un modèle de paramétrage de carte, il faut se baser sur l'un des modèles génériques disponibles. Chacun de ces modèles se base sur un système de projection cartographique particulier. L'observation attentive de la carte choisie doit vous permettre de choisir parmi les modèles génériques existants :

• Si méridiens et parallèles sont rectilignes et forment un quadrillage régulier, il faut utiliser {{Géolocalisation/Projection équirectangulaire}}. Ce modèle convient très bien pour les cartes des pays voisins de l'équateur.
• Si méridiens et parallèles sont quasiment rectilignes, mais si les méridiens sont « en trapèzes », il faut utiliser le méta-modèle {{Géolocalisation/Projection linéaire}}.
• Si les parallèles sont légèrement arqués, si les méridiens sont « en trapèzes » et même légèrement arqués, il faut utiliser le méta-modèle {{Géolocalisation/Projection sinusoïdale}}.
• Si les méridiens sont des droites sécantes en un pôle et si les parallèles forment des cercles concentriques, il faut utiliser le méta-modèle {{Géolocalisation/Projection conique linéaire}}. Voir l'exemple de la carte de la Russie.
• Si le modèle {{Géolocalisation/Projection conique linéaire}} précédent ne fournit pas un bon résultat, utilisez le méta-modèle {{Géolocalisation/Projection conique avec DL}} ou encore {{Géolocalisation/Projection conique modifiée}}. Voir l'exemple de la carte du Canada ou {{Carte/Canada}}.
• Si vous souhaitez représenter la surface totale d'un globe, trouvez une carte utilisant la projection de votre choix parmi : {{Géolocalisation/Projection équirectangulaire}}, {{Géolocalisation/Projection sinusoïdale}} et {{Géolocalisation/Projection polyconique}}.

Vous êtes perdu ?

Si vous partez d'une image dont vous ignorez le système de projection et même si cette projection n'est peut être pas la bonne, il est judicieux d'essayer la projection équirectangulaire en premier. Cela permet de faire un premier cadrage de la carte et de voir ce qui ne va pas. De plus, les valeurs de paramétrage à déterminer sont en partie réemployées par les autres types de projection.

Voici quelques conseils sur la marche à suivre lorsque le paramétrage de la projection pose problème. Ils sont d'ordre indicatif.

• Bien sûr, reporter toutes les informations utiles de la page de l'image employée.
• Bien sûr, reportez-vous à la documentation du modèle générique employé.
• Même si l'on emploie pas la projection équirectangulaire, fixer (au moins approximativement) les valeurs des fonctions left, right, top, bottom (les latitudes et longitudes au centre des bords de la carte) et « publier » (et « purger »). Cela permet de créer la documentation (et donne le point central).
• Créer une carte complétée (avec {{Test de carte}} ; voire {{Test méridiens et parallèles}} éventuellement).
• Déterminer le méridien central : fonction longitude (+ px0 si nécessaire).

Cette section est vide, insuffisamment détaillée ou incomplète. Votre aide est la bienvenue ! Comment faire ?

• Déterminer la latitude centrale (ou les latitudes pour les projections sécantes) : fonction latitude (+ py0 si nécessaire).

Cette section est vide, insuffisamment détaillée ou incomplète. Votre aide est la bienvenue ! Comment faire ?

• À ce stade, le point central doit être correctement projeté.
• Ajuster la projection le long du méridien central : fonction dy (ou t ou encore top, bottom).
• Ajuster la projection hors du méridien central : fonction dx (ou s ou encore left, right).

Cette section est vide, insuffisamment détaillée ou incomplète. Votre aide est la bienvenue ! Comment faire ?

Exemples

{{Géolocalisation/Chine}} • {{Géolocalisation/Europe}} • {{Géolocalisation/Afrique}} • {{Géolocalisation/Russie}} • {{Géolocalisation/Canada}} • {{Géolocalisation/Québec}}

Exemples avec différentes projections

Exemples avec différentes projections
(les paramètres facultatifs sont entre parenthèses)

Modèle, paramètres de la projection, exemple, formules	Carte
{{Géolocalisation/Projection équirectangulaire}} Paramètres : top, bottom, left, right {{Géolocalisation/Loire-Atlantique}} {{Géolocalisation/Projection équirectangulaire |{{{1}}}|{{{2}}}|{{{3}}} |top=47.925 |bottom=46.775 |left=-2.70 |right=-0.80 <!--...--> }} Formules : y={{#expr: ({{{2}}}-47.925)*-86.956521739184}} x={{#expr: ({{{3}}}+ 2.70 )* 52.6315789474}}
{{Géolocalisation/Projection conique équidistante}} Paramètres : top, bottom, longitude, latitude1, latitude2, (dx, x0) {{Géolocalisation/Chine}} (voir {{Carte/Chine/Test}}) {{Géolocalisation/Projection conique équidistante |{{{1}}}|{{{2}}}|{{{3}}} |top=57 |bottom=17.96 <!--...--> |longitude=104 |latitude1=42 |latitude2=30 }} Formules : y={{#expr: 2.5614754098361* ( -57.572395317393 + (114.57239531739-({{{2}}}))* cos(0.010240048192254*({{{3}}}-104) ) ) }} x={{#expr: (50 + 2.0387695895393*(114.57239531739-({{{2}}}))* sin(0.010240048192254*({{{3}}}-104) ) ) }}
{{Géolocalisation/Projection conique avec DL}} Paramètres : latitude, longitude, (x0), y0, s, t {{Géolocalisation/Québec (conique)}} {{Géolocalisation/Projection conique avec DL |{{{1}}}|{{{2}}}|{{{3}}} |latitude=53.975 |longitude=-68.425 |y0=-2230 |s=0.8127604 |t=1.3701197 <!--...--> }} Formules : y={{#expr: -169.19575113809 + ( 1 - ({{{2}}}- 53.975) * (0.023913099911515 + 2.4281155961195E-6 * ({{{2}}}- 53.975) * ({{{2}}}- 53.975) ) ) * ( 219.19575113809 - 0.022053724358958 * ({{{3}}}- -68.425) * ({{{3}}}- -68.425) ) }} |x={{#expr: 50 + ( 1 - ({{{2}}}- 53.975) * (0.023913099911515 + 2.4281155961195E-6 * ({{{2}}}- 53.975) * ({{{2}}}- 53.975) ) ) * ({{{3}}}- -68.425) * ( 3.4612721058717 - 0.00011608184393774 * ({{{3}}}- -68.425) * ({{{3}}}- -68.425) )
{{Géolocalisation/Projection azimutale équivalente de Lambert}} Paramètres : latitude, longitude, kx, ky, (px0, py0) {{Géolocalisation/Afrique}} {{Géolocalisation/Projection azimutale équivalente de Lambert |{{{1}}}|{{{2}}}|{{{3}}} |latitude=0 |longitude=15 |kx=71.1 |ky=75.3 |px0=(100*745/1525) |py0=(100*737/1440) <!--...--> }}
{{Géolocalisation/Projection perspective}} (stereographic) Paramètres : latitude, longitude, d=-1, cx, cy, (x0, y0) {{Géolocalisation/Stéréographique/0/0}} {{Géolocalisation/Projection perspective |{{{1}}}|{{{2}}}|{{{3}}} |longitude=0 |latitude=0 |cx=8.94 |cy=8.94 |d=-1 <!--...--> }}
{{Géolocalisation/Projection sinusoïdale}} Paramètres : (longitude) {{Géolocalisation/Sinusoidal projection}} {{Géolocalisation/Projection sinusoïdale |{{{1}}}|{{{2}}}|{{{3}}} <!--...--> }} Formules : y={{#expr: 50 - ({{{2}}})/1.8 }} x={{#expr: 50 + 0.27777777777778 * cos({{{2}}}*0.01745329252) * ({{{3}}}) }}

 

Utilisez la page de test dédiée Modèle:Géolocalisation/Test, qui facilitera l'ajustement du paramétrage par la suite. Éditez la page et videz-la.

Copiez-collez ce patron et supprimez les commentaires et les paramètres qui ne vous serviront pas. Il faut remplacer type par le nom du système de projection choisi plus haut. Reportez-vous à la documentation du modèle choisi pour savoir comment déterminer les valeurs des paramètres.

<includeonly>{{Géolocalisation/Projection type
 |{{{1}}}|{{{2}}}|{{{3}}}
 <!-- Les paramètres suivants dépendent du type : -->
 |top=
 |bottom=
 |left= <!-- ou |longitude= -->
 |right= <!-- ou |longitude= -->
 <!-- Paramètres plus rarement employés :
 |x0=
 |y0=
 |déformation=
 |latitude=
 |latitude0=
 |a=
 -->
 <!-- Les paramètres obligatoires : -->
 |image=
 |iwidth=
 |iheight=
 |name=
 |zone=
 |genre=
 |geo=
 }}</includeonly><noinclude>
 {{Documentation paramétrage de carte<!--|code=1-->}}
 <!-- Pour construire un exemple de rendu (facultatif) :
 :* ... liens divers

;notes: ...

]
 -->
 </noinclude>

top, bottom, left, right

Commencez par récupérer les coordonnées des bords de votre carte. Elles doivent figurer dans sa page de description, sous la forme "Nord Ouest Sud Est" ou "top left bottom right" (exemple).

Si ces informations sont introuvables, vous pouvez tenter de les déterminer en utilisant et un outil de retouche d'image tel que GIMP.

Reprenons l'exemple de la carte du Pérou. Nous devrions obtenir :

 |top=0.73
 |bottom=-19.36
 |left=-83.25
 |right=-66.75

Notez que certaines valeurs sont négatives. En effet :

• Pour les bords gauches et droits, les valeurs sont positives si le point se situe à l'Est du méridien de Greenwich, et négatives si elles sont à l'Ouest.
• Pour les bords haut et bas, les valeurs sont positives au-dessus de l'équateur, et négatives en-dessous.

image

Nom de l'image (sans File: / Fichier:).

iwidth, iheight

Ce sont simplement les dimensions (largeur, hauteur) de l'image en pixels, que l'on trouvera sur sa page de description.

name

Lien (sans ]) vers l'article correspondant à la région (zone) représentée. Cela correspond donc le plus souvent au nom de code de la carte.

Toutefois, plus rarement, il faut employer la syntaxe page{{!}}nom lorsque l'article correspondant n'a pas le même nom. Par exemple, pour la Géorgie, l'article est Géorgie (pays) ; on écrit donc :

|name=Géorgie (pays){{!}}Géorgie

Lorsque la carte est un pays (|zone=pays), il faut s'assurer que nom de code de la carte est bien présent dans la liste des pays du monde et la catégorie des modèles de pays et drapeaux.

De même, lorsque la carte est un département français (|zone=département français), il faut s'assurer que nom de code de la carte est bien « officiellement » un département.

zone

Article détaillé : Aide:Fonction zone.

genre

Article détaillé : Aide:Fonction genre.

Consulter le tableau de conversion et cette excellente liste de noms de pays et de subdivisions de pays.

Méridien central (36.375, 105) d=0.97430942835926 (36.375, 105) d=0.97430942835926 Test du modèle de paramétrage de la carte de la République populaire de Chine.

Vous pouvez employer le modèle {{Test de carte}} pour visualiser l'utilisation d'un modèle de paramétrage de carte. Il suffit pour cela de se créer une page de brouillon et d'y insérer ce modèle complété avec les informations de votre carte, et un pas, qui fait varier le nombre de points rouges.

Le principe est de vérifier l'alignement de la grille de points rouge (la géolocalisation) avec les intersections des parallèles et méridiens de la carte. La figure ci-contre montre un alignement presque parfait, qui convient parfaitement pour l'utilisation qui en est faite sur Wikipédia.

Notez qu'en plaçant votre souris au-dessus d'un point rouge, vous obtenez ses coordonnées.

La ligne rouge représente le méridien central. Elle doit être alignée avec l'axe nord-sud de la carte. Si ce n'était pas le cas, le modèle de géolocalisation de fonctionnerait pas.

Positionnement imparfait

Lorsqu'après de multiples tentatives (avec divers modèles génériques), les points s'affichent correctement, mais ne se superposent toujours pas à leur position correcte sur l'image. Vous pouvez :

• Demander de l'aide auprès de l'atelier « Cartographie ».
• Demander à l'auteur de l'image des précisions sur les caractéristiques de la projection employée.
• Demander une nouvelle carte à l'atelier graphique.

Autre

Consultez les erreurs courantes de géolocalisation.

Le nom d'un modèle de paramétrage de carte doit impérativement être Modèle:Géolocalisation/nom de code de la carte.

Lorsque la carte représente un pays, il faut s'assurer que le nom de code de la carte est bien présent dans la liste des pays du monde et la catégorie des modèles de pays et drapeaux.

S'il existe déjà d'autres modèles de paramétrage de carte pour la zone traitée, il suffit de rajouter un chiffre à la fin du titre de la page. Exemple : Modèle:Géolocalisation/Espagne, Modèle:Géolocalisation/Espagne2.

Un modèle de paramétrage de carte recourt d'abord à un modèle générique. L'utilisation de ce méta-modèle est coûteuse (en mémoire aussi bien qu'en temps de calcul). Une fois les paramètres convenablement ajustés, un modèle de paramétrage de carte peut-être optimisé. Il s'agit là d'une forme de "substitution" du méta-modèle.

Comment cela fonctionne ?

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 disposent d'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.

Pourquoi optimiser le modèle ?

Un modèle générique emploie des fonctions gourmandes en ressources serveur lorsqu'il est affiché sur une page. La version optimisée simplifie considérablement les formules de conversion. Ainsi, en optimisant un modèle de paramétrage de carte, on économise les ressources des serveurs qui hébergent Wikipédia.

Quand optimiser le modèle ?

Dès que le paramétrage est bon. C'est à dire, dès que le modèle fonctionne parfaitement.

Comment optimiser le modèle ?

Placez dans le code du modèle {{Documentation paramétrage de carte|code=1}} ou {{Documentation paramétrage de carte en sous-page|code=1}} et prévisualisez. La documentation affichera alors la marche à suivre : un code de substitution à copier-coller dans le modèle. Publiez et voilà tout.

{{Géolocalisation/Projection type
 |{{{1}}}|{{{2}}}|{{{3}}}
 <!-- Divers paramètres propres au modèle générique:
 ...
 -->
 <!-- Les paramètres communs : -->
 |image=...
 |iwidth=...
 |iheight=...
 |name=...
 |zone=...
 |genre=...
 |geo=...
 <!--etc -->
 }}

 {{#switch:{{{1}}}
 |y={{#expr: ... }} 
 |x={{#expr: ... }}
 <!-- Les paramètres communs : -->
 |image=...
 |iwidth=...
 |iheight=...
 |name=...
 |zone=...
 |genre=...
 |geo=...
 <!--etc -->
 }}

{{Géolocalisation/Projection conique équidistante
|{{{1}}}|{{{2}}}|{{{3}}}
|top=57
|bottom=17.96
|left=73
|right=135
|image={{#switch: {{{2|}}}
|relief=China edcp relief location map.jpg
|#default=China edcp location map.svg
}}
|iwidth=1181
|iheight=940
|name=Chine
|zone=pays
|geo=-54
|longitude=104
|latitude1=42
|latitude2=30
}}

{{Géolocalisation/Projection conique linéaire
<!-- ... -->
|n=(
(cos({{{latitude1}}}*pi/180)-cos({{{latitude2}}}*pi/180))/
(({{{latitude2}}}-{{{latitude1}}})*pi/180)
)
|latitudeG=(
({{{latitude2}}}-{{{latitude1}}})
*cos({{{latitude1}}}*pi/180)/
(cos({{{latitude1}}}*pi/180)-cos({{{latitude2}}}*pi/180))
+
{{{latitude1}}}
)
|dx={{{dx|1}}}
}}

100*({{#if:{{{x0|}}}| ({{{x0}}})/({{{iwidth}}}) | 0.5}} + 
     ({{{dx|1}}})*(({{{iheight}}})/({{{iwidth}}}))/
     ({{{top}}}-({{{bottom}}}))*({{{latitudeG|90}}}-({{{2}}}))* 
sin(
     ({{{n|sin(({{{latitude0|({{{top}}}+{{{bottom}}})*0.5}}})*pi/180)}}})
     * pi/180 *({{{3}}}-({{{longitude}}})) 
   ) 
)

100*(0.5 + 
     (1)*((940)/(1181))/
     (57-(17.96))*(
     (30-42)
     *cos(42*pi/180)/
     (cos({42*pi/180)-cos(30*pi/180))
     +42
     -({{{2}}}))* 
sin(
     ((
      (cos(42*pi/180)-cos(30*pi/180))/
      ((30-42)*pi/180)
     ))
     * pi/180 *({{{3}}}-(104)) 
   ) 
)

(50 + 
  2.0387695895393*(114.57239531739-({{{2}}}))* 
  sin(0.010240048192254*({{{3}}}-104) ) 
)

Certains modèles de paramétrage de carte incluent plusieurs images représentant une même zone et un même cadrage, mais selon des rendus différents. C'est par exemple le cas du Modèle:Géolocalisation/Corse. Pour que cela fonctionne, il faut impérativement que les images utilisées utilisent les mêmes proportions (largeur / hauteur). Si leur taille en pixels diffère, il faut fournir le paramètre largeur aux modèles.

Pour intégrer d'autres images à un modèle, il faut remplacer :

|image=nom de l'image par défaut

par

|image={{#switch: {{{2|}}}
|départementale
|administrative=autre nom
|relief=autre nom
|blank
|#default=nom de l'image par défaut
}}

Ici administrative, départementale, blank et relief sont les types des images alternatives. On obtient alors le nom de l'image de la carte administrative d'un pays avec :

 {{Géolocalisation/pays|image|administrative}}

En revanche

{{Géolocalisation/pays|image|n'importe quoi}}

ne génère pas d'erreur, mais retournera l'image par défaut.

Suggestion pour le nom des images

Si l'on adopte pour le nom des images la nomenclature

 Fichier:nom de code de la carte (type).svg

on peut alors écrire :

|image={{#ifexist:nom de code de la carte ({{{2|}}}).svg
|nom de code de la carte ({{{2|}}}).svg
|nom de code de la carte (blank).svg
}}

ou simplement (mais c'est moins "fiable")

|image=nom de code de la carte ({{{2|}}}).svg

Ce didacticiel se base sur le modèle de géolocalisation Japon2.

1. Créer un modèle optimisé pour la carte principale.
   • Tester le modèle avec des valeurs valides pour cette zone.
2. Créer un modèle optimisé pour la carte secondaire.
   • Il faut faire attention car les valeurs indiquées comme limites des côtés de la carte sont les limites de l'image et non de la zone couverte par carte secondaire.
   • Tester le modèle avec des valeurs valides pour cette zone.
3. Trouver une valeur de test en longitude ou en latitude.
   • Pour trouver cette valeur, l'idéal est de choisir une valeur en longitude ou en latitude au-delà de laquelle il faudra utiliser la carte secondaire.
4. Créer le code de test logique pour x et y.
   • Voir exemple pour obtenir le code.
5. Changer uniquement les valeurs x et y de la carte principale.

Exemple :

1. Modèles optimisés

{{#switch:{{{1}}}
|y={{#expr: ({{{2}}}-(45.86))*-6.3131313131313}}
|x={{#expr: ({{{3}}}-(128.24))*4.755111745126}}
|image=Japan location map with side map of the Ryukyu Islands.svg
|iwidth=413
|iheight=373
|name=Japon
|zone=pays
|genre=ms
|geo=-111
|top=45.86
|bottom=30.02
|left=128.24
|right=149.27
|projection=Projection équirectangulaire
}}

{{#switch:{{{1}}}
|y={{#expr: ({{{2}}}-(39.54))*-6.3171193935565}}
|x={{#expr: ({{{3}}}-(110.43))*4.7596382674917}}
|image=Japan location map with side map of the Ryukyu Islands.svg
|iwidth=413
|iheight=373
|name=Japon
|zone=pays
|genre=ms
|geo=-111
|top=39.54
|bottom=23.71
|left=110.43
|right=131.44
|projection=Projection équirectangulaire
}}

latitude de séparation La limite inférieure de la carte principale de « Japon2 » sur la carte « Japon ». La latitude est 30.02.

2. Trouver une valeur

Dans le cas de la carte du Japon, la limite inférieure de la carte principale est à 30.02, nous pouvons ainsi conclure que si la coordonnée est au sud de 30.02, il faut utiliser la carte secondaire.

3. Insérer le test logique pour x et y

| y = {{#ifexpr: {{{@}}} < VALEUR
 | VALEUR Y DE LA CARTE SECONDAIRE
 | VALEUR Y DE LA CARTE PRINCIPALE
}}
| x = {{#ifexpr: {{{@}}} < VALEUR
 | VALEUR X DE LA CARTE SECONDAIRE
 | VALEUR X DE LA CARTE PRINCIPALE
}}

• Remplacer le @ par 2 si le test vérifie la latitude et par 3 si le test vérifie la longitude.
• Utiliser le signe < pour tester une valeur plus petite et le signe > pour une valeur plus grande.
• Copier/coller ce qui se trouve après y = et x = de la carte principale et de la carte secondaire au bon endroit.

Résultat pour Japon.

| y = {{#ifexpr: {{{2}}} < 30.02
 |{{#expr: ({{{2}}}-(39.66))*-6.3051702395965}}
 |{{#expr: ({{{2}}}-(45.86))*-6.3371356147022}}
}}
| x = {{#ifexpr: {{{2}}} < 30.02
 |{{#expr: ({{{3}}}-(110.40))*4.7596382674917}}
 |{{#expr: ({{{3}}}-(128.24))*4.7596382674917}}
}}

4. Remplacer les valeurs

Remplacer uniquement les valeurs x et y modifiées dans le modèle principal (conserver les autres valeurs).

{{#switch:{{{1}}}
| y = {{#ifexpr: {{{2}}} < 30.02
 | {{#expr: ({{{2}}}-(39.54))*-6.3171193935565}}
 | {{#expr: ({{{2}}}-(45.86))*-6.3131313131313}}
}}
| x = {{#ifexpr: {{{2}}} < 30.02
 | {{#expr: ({{{3}}}-(110.43))*4.7596382674917}}
 | {{#expr: ({{{3}}}-(128.24))*4.755111745126}}
}}
|image=Japan location map with side map of the Ryukyu Islands.svg
|iwidth=413
|iheight=373
|name=Japon
|zone=pays
|genre=ms
|geo=-111
|top=45.86
|bottom=30.02
|left=128.24
|right=149.27
|projection=Projection équirectangulaire
}}

Exemples

{{Géolocalisation/États-Unis}} (l'exemple des États-Unis) • {{Géolocalisation/Japon2}} • {{Géolocalisation/Espagne2}}

Le moyen le plus simple de créer un nouveau modèle de paramétrage de carte est sûrement d'employer un modèle déjà existant (tout modèle de paramétrage de carte valide peut convenir) et d'utiliser le modèle générique {{Géolocalisation/Projection découpée}}.

Prenons l'exemple de la carte Monde ({{Géolocalisation/Monde}}) qui constitue une très bonne carte de base à condition de ne pas découper un confetti. On montre ici comment construire une nouvelle carte de la Méditerranée ({{Géolocalisation/Méditerranée}}) en découpant dans la carte Monde.

La première étape (la plus laborieuse) consiste à découper l'image. Il faut d'abord récupérer le fichier de l'image de base. Son nom est donné par {{Géolocalisation/Monde|image}} ; il s'agit ici de « World location map (equirectangular 180).svg ». Attention veillez à bien obtenir le fichier d'origine au bon format (ici le format SVG) et non l'image réduite.

À l'aide d'un éditeur graphique (Inkscape par exemple pour le format SVG) découpez un rectangle dans l'image de base.

Cette section est vide, insuffisamment détaillée ou incomplète. Votre aide est la bienvenue ! Comment faire ?

Puis enregistrez et importez cette nouvelle image sur   Commons . Ici la nouvelle image est « Mediterranean Sea location map.svg ».

Le point essentiel est qu'il faut soigneusement noter les coordonnées du rectangle prélevé. Il s'agit de :

• (iheight, iwidth) la taille en pixels de la nouvelle image.
• (ileft, itop) les coordonnées en pixels du coin supérieur gauche de l'image découpée par rapport au coin supérieur gauche de l'image originale. (Attention, Inkscape utilise le coin inférieur gauche comme point origine.)

mer Méditerranée

Coordonnées du rectangle découpé : iheight = 862 ; iwidth = 1754 ; ileft =  ; itop =

La deuxième étape consiste à créer le nouveau modèle de paramétrage de carte.

Pour l'exemple donné, le modèle est Modèle:Géolocalisation/Méditerranée et son code est :

 <includeonly>{{Géolocalisation/Projection découpée
 |{{{1}}}|{{{2}}}|{{{3}}}
 |carte=Monde
 |image=Mediterranean Sea location map.svg
 |iwidth=1754
 |iheight=862
 |ileft=
 |itop=
 |name=Méditerranée
 |zone=mer
 |genre=fs<!-- =féminin singulier -->
 |geo=-4<!-- =europe -->
 }}</includeonly><noinclude>
 {{Documentation paramétrage de carte}}
 </noinclude>

Il suffit de copier-coller le code suivant et de le compléter par vos valeurs.

<includeonly>{{Géolocalisation/Projection découpée
|{{{1}}}|{{{2}}}|{{{3}}}
|carte=<!-- la carte d'origine -->
|image=<!-- la nouvelle image -->
|iwidth=
|iheight=
|ileft=
|itop=
|name=
|zone=<!-- pays, mer, ... ou vierge -->
|genre=
|geo=<!-- code du pays sur World Gazeeter, 0 ou vierge -->
}}</includeonly><noinclude>
{{Documentation paramétrage de carte}}
</noinclude></nowiki>

Une catégorie est consacrée à ce sujet : Modèle générique de paramétrage de carte.

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.

Voici les fonctions que ce type de modèle doit assurer au minimum pour que la géolocalisation fonctionne :

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. La présence de ces paramètres est donc devenue obligatoire :

|name=Géorgie (pays){{!}}Géorgie

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 :

Important

Si le paramétrage de la carte n'est pas satisfaisant, vous devez blanchir le paramétre iwidth. En effet, un modèle de paramétrage de carte est susceptible d'être employé automatiquement dans des infobox telles que {{Infobox Montagne}}. Cependant si iwidth est laissé vierge, le modèle est considéré « pas fini » et ne sera pas utilisé.

Les images alternatives:

La projection employée :

Enfin, lorsque la zone est planète, la fonction suivantes est obligatoire :

Cette section est vide, insuffisamment détaillée ou incomplète. Votre aide est la bienvenue ! Comment faire ?

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>

Exemple

Une catégorie est consacrée à ce sujet : Modèle exemple de géolocalisation automatisée.

{{Géolocalisation/Russie}}

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}}	Russia administrative location map.svg
{{Géolocalisation/Russie|iwidth}}	2362
{{Géolocalisation/Russie|iheight}}	1299
{{Géolocalisation/Russie|top}}	88.52
{{Géolocalisation/Russie|bottom}}	44.0
{{Géolocalisation/Russie|left}}	-20
{{Géolocalisation/Russie|right}}	180
{{Latitude|Russie}}	66.26
{{Longitude|Russie}}	97.0
{{Déformation cartographique centrale|Russie}}	1.0250130375713
{{Géolocalisation/Russie|x|54.71|20.50 }}	5.5640684009861
{{Géolocalisation/Russie|y|54.71|20.50 }}	27.575498332488

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 :

1. le procédé n'est pas limité à la seule projection équirectangulaire, mais est adaptable à tout système de projection.
2. le procédé permet également de paramétrer des "sous-cartes" en encadré (par exemple, l'Alaska et Hawaï pour le modèle {{Géolocalisation/États-Unis}} ; voir {{Carte/États-Unis}})
3. plusieurs points, pictogrammes, signalétiques, toponymies peuvent être placées sur une carte
4. le paramétrage est plus complet et permet des calculs annexes : échelle, déformation, cadrage, taille de la signalétique (voir Liste des mers lunaires)
5. le nombre "d'appel" au modèle de paramétrage de carte est réduit
6. le modèle {{Géolocalisation}} est très simple
7. 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 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.

Une catégorie est consacrée à ce sujet : Modèle de paramétrage de carte problématique.

• Liste des paramétrages encore inexistant
• Tables : Pays • Département de France métropolitaine • Région de France métropolitaine • Département français d'outre-mer

Projet cartographie
Géolocalisation (en)	Requêtes Modèles Paramétrage des cartes (Maintenance) Amélioration (discussion)
Cartographie	Requêtes Didacticiel Toutes les cartes, Atlas Compléter une carte / image, liste des points Cartes complétées
Recommandations	Fonds Relief Signalétique
Modèles	{{Palette Projet cartographie}} {{Palette Géolocalisation}} {{Palette Navigation Cartographie}} {{Atelier graphique carte}} {{G}}
Autres aides	Image Quelle licence utiliser ? SVG Prise en charge des images SVG WikiMiniAtlas