Voir la source de Modèle:Location map+/Documentation

{{Sous-page de documentation}}

== Utilisation ==
Sert à créer des cartes avec des lieux (villes, villages, etc.)

== Syntaxe ==
* <code><nowiki>{{</nowiki>Location map+<nowiki>|paramètre1|nom1param=valeur1}}</nowiki></code>

{{Location map+|Angleterre|width=300|AlternativeMap=England_locator_map_with_North_East_England_highlighted.svg|alt=Carte de l'Angleterre montrant les villes et les batailles. Bosworth est au centre, au nord-ouest de Londres.|float=right|caption=<span style="font-size:95%;">[[Fichier:Battle icon active (crossed swords).svg|16px|link=]] [[Bataille de Bosworth]] [[Fichier:Battle icon (crossed swords).svg|14px|link=]] autres batailles</span> |places=
  {{Location map~ |Angleterre |label='''[[Bataille de Bosworth|Bosworth]]''' |label_size=86 |position=right |lat=52.591265 |long=-1.410327 |mark=Battle_icon_active_(crossed_swords).svg |marksize=18 |link=Bataille de Bosworth}}
  {{Location map~ |Angleterre |label=[[Bataille de Blore Heath|Blore Heath]] |label_size=86 |position=top |lat=52.913611 |long=-2.424722 |mark=Battle_icon_(crossed_swords).svg |marksize=16 |link=Bataille de Blore Heath}}
  {{Location map~ |Angleterre |label=[[Bataille de Barnet|Barnet]] |label_size=86 |position=top |lat=51.662233 |long=-0.200039 |mark=Battle_icon_(crossed_swords).svg |marksize=16 |link=Bataille de Barnet}}
  {{Location map~ |Angleterre |label=[[Bataille de Stoke|Stoke]] |label_size=86 |position=top |lat=53.029058 |long=-0.892586 |mark=Battle_icon_(crossed_swords).svg |marksize=16 |link=Bataille de Stoke}}
  {{Location map~ |Angleterre |label=[[Bataille de Tewkesbury|Tewkesbury]] |label_size=86 |position=top |lat=51.986389 |long=-2.161389 |mark=Battle_icon_(crossed_swords).svg |marksize=16 |link=Bataille de Tewkesbury}}
  {{Location map~ |Angleterre |label=Berwick |label_size=86 |position=bottom |lat=55.771 |long=-2.007 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |Angleterre |label=Londres |label_size=86 |position=bottom |lat=51.507778 |long=-0.128056 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |Angleterre |label=York |label_size=86 |position=bottom |lat=53.958333 |long=-1.096667 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |Angleterre |label=Plymouth |label_size=86 |position=bottom |lat=50.371397 |long=-4.142431 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |Angleterre |label=Poole |label_size=86 |position=bottom |lat=50.71942 |long=-1.98113 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |Angleterre |label=Wem |label_size=86 |position=left |lat=52.8555 |long=-2.7211 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |Angleterre |label=Northumberland |label_size=86 |position=right |lat=55.1 |long=-1.68 |mark=Steel pog.svg |marksize=1}}
  {{Location map~ |Angleterre |label=Shrewsbury |label_size=86 |position=bottom |lat=52.7077 |long=-2.7541 |mark=Steel pog.svg |marksize=6}}
  {{Location map~ |Angleterre |label=Milford Haven |label_size=86 |position=bottom |lat=51.71418 |long=-5.04274 |mark=Steel pog.svg |marksize=6}}
}}

Ce modèle inscrit des marqueurs et des légendes sur une carte.

Ce modèle fait appel au [[Modèle:Location map~]], autant de fois qu'il y a de lieux.

==États-Unis ==

{|
|- valign=top
|<pre style="width:15em; margin-right:2em;">
{{Location map+
| {{{1}}}
| width          =
| float          =
| border         =
| caption        =
| alt            =
| relief         =
| AlternativeMap =
| overlay_image  =
| places         =
}}</pre>
|<pre style="width:15em;">
{{Location map~
| {{{1}}}
| label      =
| label_size =
| position   =
| background =
| mark       =
| marksize   =
| link       =
| lat_deg    =
| lat_min    =
| lat_sec    =
| lat_dir    =
| lon_deg    =
| lon_min    =
| lon_sec    =
| lon_dir    =
}}</pre>
|}

{{clear}}

== Paramètres ==
{| class="wikitable" style="width:100%;"
|+ Paramètres pour [[Modèle:Location map+]]
! Paramètres
! Description
|-
| <code>{{{1}}}</code>
| Obligatoire. Nom de la carte. Par exemple, inscrire ''Angleterre'' pour utiliser {{m|géolocalisation/Angleterre}}. Voir les [[#Exemples|exemples]] plus bas.
|-
| <code>width</code>
| Largeur de la carte en [[pixel]]s. Si aucune valeur fournie, le modèle utilise une valeur par défaut. Ne pas insérer <code>px</code> (par exemple, <code>width=300</code>, pas <code>width=300<s>px</s></code>.
|-
| <code>default_width</code>
| Largeur par défaut de la carte en pixels. Utile si la carte est inscrite dans un modèle (infobox, par exemple). La valeur par défaut est 240. Ne pas insérer <code>px</code>. Cette valeur sera multipliée par le paramètre <code>defaultscale</code>, si un autre modèle le fournit, ce qui permet de calculer la hauteur pour les cartes verticales. Par exemple, si <code>default_width=200</code>, alors une carte de la Thaïlande aura une largeur de 200 * 0.57 = 114 pixels.
|-
| <code>float</code>
| Indique la position horizontale dans la page. Valeurs reconnues : <code>left</code> (gauche), <code>right</code> (droite), <code>center</code> (centré) et <code>none</code> (rien). La valeur par défaut est <code>right</code>.
|-
| <code>border</code>
|  Indique la couleur de la bordure de la carte (large de 1 px). La valeur par défaut est ''lightgrey'' (voir [[Couleurs du Web]]). Si mis à <code>none</code>, aucune bordure.
|-
| <code>caption</code>
| Légende qui s'affiche sous la carte. Indiquer une légende force l'affichage d'un cadre. Si <code>caption</code> apparaît et sa valeur est vide, alors la carte n'affiche pas de cadre. Si <code>caption</code> n'apparaît pas, alors la carte n'est pas encadrée et une légende par défaut est insérée. Le texte est la valeur de <code>label</code> (ou le nom de la page si <code>label</code> n'est pas défini) et d'un autre paramètre. Voir les [[#Exemples|exemples]] plus bas.
|-
| <code>alt</code>
| Texte alternative pour la carte (qui est utilisé par les [[lecteur d'écran|lecteurs d'écran]].

<!-- Pas encore reconnu (2013-06-05)|-
| <code>relief</code>
| Any non-blank value (1, yes, etc.) will cause the template to display the map specified in the map definition template as <code>image1</code>, which is usually a [[Relief mapping (computer graphics)|relief map]]. See the example at [[Modèle:Location map+/relief|Location map+/relief]]. -->
|-
| <code>AlternativeMap</code>
| Permet d'utiliser une autre carte d'arrière-plan. Les bords de cette carte doivent avoir les mêmes coordonnées que ceux de la carte d'arrière-plan par défaut
|-
| <code>overlay_image</code>
| Image à ajouter en surimpression.
|-
| <code>places</code>
| Indique un ou plusieurs marqueurs de lieu reconnu par [[Modèle:Location map~]] (voir immédiatement ci-dessous).
|}

{| class="wikitable" style="width:100%;"
|+ Paramètres de [[Modèle:Location map~]]
! Paramètre
! Description
|-
| <code>{{{1}}}</code>
| Obligatoire. Nom de la carte. Par exemple, inscrire ''Angleterre'' pour utiliser {{m|géolocalisation/Angleterre}}. Voir les [[#Exemples|exemples]] plus bas.
|-
| <code>label</code>
| Le texte de la légende à inscrire à côté du marqueur. Un wikilien peut être utilisé. Si aucun label, alors aucun texte sur la carte, juste le marqueur.
|-
| <code>label_size</code>
| La taille des caractères du <code>label</code>, en pourcentage (<100 = plus petit, >100 = plus grand). La valeur par défaut est 90. Ne pas inclure <code>%</code> (ar exemple, <code>label_size=80</code>, par <code>label_size=80<s>%</s></code>.
|-
| <code>position</code>
| La position relative du <code>label</code> du marqueur. Les valeurs reconnues sont : <code>left</code>, <code>right</code>, <code>top</code> et <code>bottom</code>. La valeur par défaut est <code>right</code>.
|-
| <code>background</code>
| La couleur d'arrière-plan du <code>label</code>. Voir [[Couleurs du Web]]. Par défaut, aucune couleur d'arrière-plan (ce qui ne cache pas la carte).
|-
| <code>mark</code>
| Le titre de l'image à afficher comme marqueur. Le titre par défaut est [[:File:Red pog.svg|Red pog.svg]] ([[Fichier:Red pog.svg|8px]]). Voir les exemples dans [[Commons:Location markers]] et [[Commons:Category:Map icons]].
|-
| <code>marksize</code>
| La taille du marqueur en [[pixel]]s. La valeur par défaut est 8. Ne pas inscrire <code>px</code> (par exemple, <code>marksize=10</code>, pas <code>marksize=10<s>px</s></code>.
|-
| <code>link</code>
| Wikilien que le lecteur peut suivre s'il clique sur le marqueur. Le titre de la page apparaît lorsque le pointeur de la souris survole le marqueur.
|-
|<code>lat_deg</code>
| Obligatoire. Le nombre de degrés de la [[latitude]]. Cette valeur peut être en degrés décimaux<ref group=Note name="precision" />.
|-
| <code>lat_min</code>
| Le nombre de minutes de latitude<ref group=Note name="precision" />.
|-
| <code>lat_sec</code>
| Le nombre de secondes de la latitude. Habituellement superflu<ref group=Note name="precision" />.
|-
| <code>lat_dir</code>
| N pour le nord (valeur par défaut) ou S pour le sud de l'[[équateur terrestre|équateur]]. Toute autre valeur sera ignorée. Superflu si la mesure des degrés est signée (+ ou -).
|-
| <code>lon_deg</code>
| Obligatoire. Le nombre de degrés de la [[longitude]]. Cette valeur peut être en degrés décimaux<ref group=Note name="precision" />.
|-
| <code>lon_min</code>
| Le nombre de minutes de longitude<ref group=Note name="precision" />.
|-
| <code>lon_sec</code>
| Le nombre de secondes de la longitude. Habituellement superflu<ref group=Note name="precision" />.
|-
| <code>lon_dir</code>
| E pour l'est (valeur par défaut) ou W pour l'ouest du [[premier méridien]]. Toute autre valeur sera ignorée. Superflu si la mesure des degrés est signée (+ ou -).
|}

;Notes
{{Références
| groupe = Note
| références =
<ref group=Note name="precision">Une précision pertinente devrait être utilisée. Par exemple, la carte complète des États-Unis, avec une largeur de {{unité|1000|pixels}}, a une résolution d'environ {{unité|5|km/pixel}}.</ref>
}}

== Modèles de cartes disponibles ==

Les modèles de carte pouvant servir à [[Modèle:Location map+]] se trouvent dans :
*[[:en:Template:Location map/List]] (environ 1050 modèles à l'époque)
*[[:en:Category:Location map templates]] (modèles triés par catégorie)
*[[:Special:WhatLinksHere/Template:Location map/Info]] (une recherche qui peut aider)
*[[:Special:Prefixindex/Template:Location map]] (une autre recherche qui peut aider)

== Exemples ==

Cet exemple n'indique pas <code>caption</code>. Il ne fait que montrer les valeurs par défaut. La légende par défaut est le titre de cette page suivi du nom de la carte entre parenthèses. La position du <code>label</code> est automatiquement ajustée si le marqueur est trop près d'un bord.

{{Location map+ |Australie
| places =
  {{Location map~ |Australie
    | label = Sydney
    | lat_deg = -33.86
    | lon_deg = 151.21 }}
  {{Location map~ |Australie
    | label = Melbourne
    | lat_deg = -37.81
    | lon_deg = 144.96 }}
}}
<pre style="width:35em;">
{{Location map+ |Australie
| places =
  {{Location map~ |Australie
    | label = Sydney
    | lat_deg = -33.86
    | lon_deg = 151.21 }}
  {{Location map~ |Australie
    | label = Melbourne
    | lat_deg = -37.81
    | lon_deg = 144.96 }}
}}</pre>

{{clear}}

Cet exemple utilise un <code>caption</code> vide. Il montre l'usage des coordonnées en degrés décimaux et un marqueur de 10 px avec un wikilien.

{{Location map+ |France
| caption =
| places =
  {{Location map~ |France
    | label = Paris
    | position = top
    | marksize = 10
    | link = Paris
    | lat_deg = 48.8567
    | lon_deg = 2.3508
  }}
  {{Location map~ |France
    | label = Marseille
    | position = top
    | marksize = 10
    | link = Marseille
    | lat_deg = 43.2964
    | lon_deg = 5.3610
  }}
}}
<pre style="width:35em;">
{{Location map+ |France
| caption =
| places =
  {{Location map~ |France
    | label = Paris
    | position = top
    | marksize = 10
    | link = Paris
    | lat_deg = 48.8567
    | lon_deg = 2.3508
  }}
  {{Location map~ |France
    | label = Marseille
    | position = top
    | marksize = 10
    | link = Marseille
    | lat_deg = 43.2964
    | lon_deg = 5.3610
  }}
}}
</pre>
{{clear}}

Cet exemple montre <code>caption</code> avec une valeur. Il montre l'usage d'une carte avec reliefs, de coordonnées en degrés, minutes et secondes, une couleur d'arrière-plan pour les légendes associées aux marqueurs et des légendes avec wikilien.

{{Location map+ |États-Unis
| width = 300
| caption = Quelques villes des États-Unis
| relief = 1
| places =
  {{Location map~ |États-Unis
    | label = [[New York]]
    | position =
    | background = white
    | mark = Cyan pog.svg
    | alt = Ville de New York (texte alternatif)
    | link = New York City
    | lat_deg = 40 | lat_min = 43 | lat_dir = N
    | lon_deg = 74 | lon_min = 0  | lon_dir = W
  }}
  {{Location map~|États-Unis
    | label = [[San Francisco]]
    | position =
    | background = white
    | mark = Purple pog.svg
    | alt = Ville de San Francisco (texte alternatif)
    | link = San Francisco
    | lat_deg = 37  | lat_min = 46 | lat_dir = N
    | lon_deg = 122 | lon_min = 25 | lon_dir = W
  }}
}}
<pre style="width:35em;">
{{Location map+ |États-Unis
| width = 300
| caption = Quelques villes des États-Unis
| relief = 1
| places =
  {{Location map~ |États-Unis
    | label = [[New York]]
    | position =
    | background = white
    | mark = Cyan pog.svg
    | alt = Ville de New York (texte alternatif)
    | link = New York
    | lat_deg = 40 | lat_min = 43 | lat_dir = N
    | lon_deg = 74 | lon_min = 0  | lon_dir = W
  }}
  {{Location map~|États-Unis
    | label = [[San Francisco]]
    | position =
    | background = white
    | mark = Purple pog.svg
    | alt = Ville de San Francisco (texte alternatif)
    | link = San Francisco
    | lat_deg = 37  | lat_min = 46 | lat_dir = N
    | lon_deg = 122 | lon_min = 25 | lon_dir = W
  }}
}}
</pre>
<includeonly>
[[Catégorie:Modèle géographie]]
</includeonly>