Mostra la font per a Plantilla:Location map/ús

{{Subpàgina de plantilla}}
{{lua|Mòdul:Location map}}
Crea un mapa de localització a partir d'un mapa ja existent en (habitualment, però no sempre) una [[projecció equirectanglar]] amb un punt (marcador) i una etiqueta.

{{Advertència|Sovint (si no es tracta d'un mapa de relleu o històric) és preferible que utilitzeu {{tl|Map draw}} o {{tl|OSM Location map}} en lloc d'aquesta plantilla.}}

{{Location map/Categories de mapes/ref}}

==Ús==
No s'accedeix directament als fitxers d'imatge del mapa, sinó mitjançant una definició de mapa auxiliar. Per exemple, si el primer paràmetre sense nom proporcionat a aquesta plantilla és ''Japó'', aquesta plantilla utilitza l'entrada per al Japó al [[Mòdul:Location map/data/Japó]] si existeix, que conté les dades necessàries per generar la imatge composta.

Si us plau, tingueu en compte:
* L'assignació de qualsevol valor al paràmetre {{para|caption}} fa que el mapa es mostri com una imatge en miniatura. Si no es declara aquest paràmetre, la plantilla generarà un títol per defecte.
* No es comproven les coordenades. Si les coordenades especificades queden fora de l'àrea coberta per la imatge del mapa, la marca d'ubicació no es mostrarà dins de la imatge; no obstant això, pot ser que es mostri en un altre lloc de la pàgina.
* No utilitzeu {{kbd|px}} quan configureu la mida de la imatge del mapa. Si feu servir {{para|width|200px}}, normalment es mostrarà un mapa massa gran. Feu servir {{para|width|200}}.
* Per crear un mapa amb més d'una marca d'ubicació, feu servir {{tl|Location map+}} o {{tl|Location map many}}.

==Paràmetres==
{|class="wikitable" style="width:100%"
|+ style=background-color:lightblue| Paràmetres
|-
! scope="col" | Tipus de paràmetre
! scope="col" | Paràmetre
!
! scope="col" | Descripció
|-
| rowspan="11" | Visualització del mapa
|{{code|{{{1}}}}}
| colspan="2" |'''Obligatori''': utilitzeu el nom del mapa com a primer paràmetre sense nom; per exemple, especificant {{code|Anglaterra}} s'utilitzaran els valors d'Anglaterra a [[Mòdul:Location map/data/Anglaterra]] si existeix, o {{tld|Location map Anglaterra}} si no existeix. Vegeu els [[#Exemples|exemples]] a continuació. Es poden mostrar diversos mapes proporcionant una llista de noms de mapes separats per {{kbd|#}}. Per a diversos mapes, el primer es mostra per defecte. Un lector pot seleccionar els altres amb botons d'opció.
|-
|{{code|width}}
| colspan="2" |Determina l'amplada del mapa en [[píxels]]s, anul·lant qualsevol valor predeterminat; no incloure {{kbd|px}}. Per exemple, utilitzeu {{para|width|300}}, no {{para|width|300px}}.
|-
|{{code|default_width}}
| colspan="2" |Determina l'amplada predeterminada del mapa en píxels, destinada a ser utilitzada per plantilles, p. posar infotaules; el valor per defecte és 240. No inclogueu {{kbd|px}}. Aquest valor es multiplicarà pel paràmetre {{code|defaultscale}} especificat en plantilles de mapes individuals, si existeix, per tal d'aconseguir una mida adequada per als mapes verticals. Per exemple, si es dóna {{para|default_width|200}}, es mostrarà un mapa de Tailàndia amb una amplada de 200×0,57=114 píxels (tal com s'especifica a [[Mòdul:Location map/data/Tailàndia]]) .
|-
|{{code|max_width}}
| colspan="2" |La mida màxima del mapa en píxels. Destinat a ser utilitzat per plantilles, p. col·locar bústia d'informació. No inclogueu {{kbd|px}}.
|-
|{{code|float}}
| colspan="2" |Especifica la posició del mapa a la pàgina; els valors vàlids són {{code|left}}, {{code|right}}, {{code|center}} i {{code|none}}. El valor predeterminat és {{code|right}}.
|-
|{{code|border}}
| colspan="2" |Especifica el color de la vora del mapa d'1 px; el valor per defecte és {{code|lightgrey}} (vegeu [[colors web]]). Si s'estableix a {{code|none}}, no es generarà cap vora. Aquest paràmetre s'utilitza poques vegades.
|-
|{{code|caption}}
|colspan="2" |El text d'un peu de mapa; si s'especifica un peu de mapa farà que el mapa es mostri amb un marc. Si es defineix {{para|caption}} però no s'assigna cap valor, el mapa no s'emmarcarà i no es mostrarà cap peu de mapa. Si no es defineix {{para|caption}}, el mapa no s'emmarcarà i es generarà un peu de mapa predeterminat. El peu de mapa predeterminat es crea a partir del paràmetre {{para|label}} (o el nom de la pàgina actual si {{para|label}} no està definit) i el paràmetre {{para|name}} de la plantilla de definició del mapa. Es poden mostrar diversos peu de mapa quan estan separats per {{kbd|##}} (això són dos).
|-
|{{code|alt}}
| colspan="2" |Text alternatiu per al mapa; utilitzat pels [[lectors de pantalla]]s. Vegeu [[Viquipèdia:Text alternatiu|Text alternatiu]].
|-
|{{code|relief}}
| colspan="2" |Qualsevol valor no en blanc ({{code|1}}, {{code|sí}}, etc.) farà que la plantilla mostri el mapa especificat a la plantilla de definició de mapa com a {{code|imatge1}}, que sol ser un [[Representació cartogràfica en relleu|mapa en relleu]]; vegeu l'exemple a [[Plantilla:Location map+/relief|Location map+/relief]].
|-
|{{code|AlternativeMap}}
| colspan="2" |Permet l'ús d'un mapa alternatiu; la imatge ha de tenir les mateixes coordenades de vora que la plantilla del mapa d'ubicació. Vegeu l'exemple a [[Plantilla:Location map+/AlternativeMap|Location map+/AlternativeMap]].
|-
|{{code|overlay_image}}
| colspan="2" |Permet superposar una superposició al mapa; aquest paràmetre s'utilitza poques vegades. Vegeu l'exemple a [[Plantilla:Location map+/overlay|Location map+/overlay]].
|-
| rowspan="22" | Etiqueta i marca els paràmetres<ref group="nota">Si no s'especifiquen coordenades, la plantilla intentarà obtenir-les de l'element [[Wikidata]] de la pàgina.</ref>
|{{code|label}}
| colspan="2" |El text de l'etiqueta a mostrar al costat de la marca identificativa; es pot utilitzar un [[Ajuda:Enllaços#Enllaç wiki|enllaç]]. Podeu incloure l'etiqueta dins de {{tl|nowrap}} si voleu assegurar-vos que es mantingui en una sola línia. El valor per defecte (si no s'especifica) és cap etiqueta, només el marcador.
|-
|{{code|label_size}}
|colspan="2" |La mida de la lletra que s'ha d'utilitzar per a l'etiqueta, donada com a percentatge de la mida normal de la lletra (<100=més petita, >100=més gran); la mida predeterminada és 90. No inclogueu {{kbd|%}}. Per exemple, utilitzeu {{para|label_size|80}}, no {{para|label_size|80%}}. Si s'estableix en {{code|0}}, l'etiqueta només es mostra quan l'usuari passa el cursor per sobre de la marca.
|-
|{{code|label_width}}
| colspan="2" |L'amplada a utilitzar per a l'etiqueta, donada com a [[Em (tipografia)#CSS|mida em]]; l'amplada per defecte és 6. No inclogueu {{kbd|em}}. Per exemple, utilitzeu {{para|label_width|7}}, no {{para|label_width|7em}}.
|-
|{{code|position}}
|colspan="2" |La posició de l'etiqueta respecte a la marca identificativa; els valors vàlids són {{code|left}}, {{code|right}}, {{code|top}}, {{code|bottom}} i {{code|none}}. Per defecte, és {{code|left}} o {{code|right}}, depenent de les coordenades del marcador i de la seva posició relativa a la vora dreta de la imatge del mapa. Quan {{para|position|none}}, cap etiqueta definida no es mostrarà amb la marca, però s'utilitzarà per crear el peu de pàgina  predeterminat.
|-
|{{code|background}}
| colspan="2" |El color de fons que s'utilitzarà per a l'etiqueta; vegeu [[Colors web]]. El valor predeterminat no és cap color de fons, que mostra la imatge del mapa de darrere de l'etiqueta.
|-
|{{code|mark}}
| colspan="2" |El nom d'un fitxer d'imatge que es mostrarà com a marca identificativa; el valor predeterminat és [[:File:Red pog.svg|Red pog.svg]] ([[Fitxer:Red pog.svg|8px]]). Vegeu exemples a [[Commons:Location markers]] i [[Commons:Category:Map icons]].
|-
|{{code|marksize}}
|colspan="2" |La mida de la marca identificativa en píxels; el valor predeterminat és 8. No inclogueu {{kbd|px}}. Per exemple, utilitzeu {{para|marksize|10}}, no {{para|marksize|10px}}.
|-
| {{code|mark_bottom}}
| colspan="2" |Qualsevol valor que no estigui en blanc (1, sí, etc.) farà que les coordenades de la marca corresponguin al punt mig i inferior de la marca, en lloc del punt central. Un exemple de marca d'aquest tipus és [[Fitxer:Bigcity red.png|24px|Bigcity red.png]].
|-
|{{code|link}}
| colspan="2" |Especifica un [[Ajuda:Enllaços#Enllaç wiki|enllaç]] que es pot seguir si el lector fa clic a la marca identificativa; no incloure {{kbd|[[]]}} (parells de claudàtors). Per exemple, utilitzeu {{para|link|Parc nacional de Yellowstone}}, no {{para|link|[{{Zwsp}}[Parc nacional de Yellowstone]]}}.
|-
| colspan="3" |'''Coordenades''' (sempre els separadors de decimals cal que siguin punts)<ref group="nota">Per a obtenir les coordenades d'una ubicació podeu utilitzar
* '''Google maps''', senzillament cliqueu el botó dret del ratolí en el punt desitjat, apareixerà en primer lloc en el menú emergent.
* '''Google Earth''', apareix en la barra de baix. Per tal de que aparegui sols en graus, cal modificar la configuració: a Eines|Opcions i a la primera pestanya cliqueu "Graus decimals" en el grup "Mostra latitud/longitud".
</ref>
|-
|{{code|lat_deg}}
| rowspan="2" |Senzill
|Els graus de [[latitud]]. Aquest valor cal especificar-lo amb [[graus decimals]].
|-
|{{code|lon_deg}}
|Els graus de [[Longitud (geografia)|longitud]]. Aquest valor cal especificar-lo amb graus decimals.
|-
|{{code|lat_deg}}
| rowspan="8" |Detallat
|Els graus de [[latitud]]; aquest valor es pot especificar amb [[graus decimals]], i quan s'utilitza aquest format, no s'han d'especificar minuts i segons.
|-
|{{code|lat_min}}
|Els minuts de latitud.
|-
|{{code|lat_sec}}
|Els segons de latitud; normalment no és necessari.
|-
|{{code|lat_dir}}
|{{code|N}} per al nord (valor per defecte), o {{code|S}} per al sud de l'[[Línia equatorial|Equador]]; altres valors seran ignorats. No és necessari si s'utilitzen graus decimals amb signe, és a dir, nombres negatius per a la latitud sud.
|-
|{{code|lon_deg}}
|Els graus de [[longitud (geografia)|longitud]]; aquest valor es pot especificar amb [[graus decimals]], i quan s'utilitza aquest format, no s'han d'especificar minuts i segons.
|-
|{{code|lon_min}}
|Els minuts de longitud.
|-
|{{code|lon_sec}}
|Els segons de longitud; normalment no és necessari.
|-
|{{code|lon_dir}}
|{{code|E}} per a l'est (valor per defecte), o {{code|W}} per a l'oest del [[Meridià internacional de referència de l'IERS|primer meridià]]; altres valors seran ignorats. No és necessari si s'utilitzen graus decimals amb signe, és a dir, nombres negatius per a la longitud occidental.
|-
|{{code|wd_coord}}
|Wikidata
|Llegeix els valors desats a [[Wikidata]]. per això cal introduir l'identificador a Wikidata del lloc a posicionar en el mapa. L'identificador el podeu trobar clicant ''Element a Wikidata'' de la barra lateral esquerra de l'article o sota el títol de l'article, per exemple per a [[Calella]], el codi és {{code|Q12540}}.
|-
|{{code|coordinates}}
|Alternatiu
|<nowiki>Amb la plantilla {{</nowiki>[[Plantilla:Coord|coord]]<nowiki>}}, per exemple </nowiki><code><nowiki>{{coord|-33.86|151.21}}</nowiki></code>
|}

<references group="nota"/>

==Plantilles en blanc==
===Inici===
{| class="wikitable"
|-
|style="vertical-align:top;"|
<pre>
{{Location map|{{{0}}}
|width       = 
|float       = 
|border      = 
|caption     = 
|alt         = 
|relief      = 
|AlternativeMap= 
|overlay_image = 
|label       = 
|label_size  =
|label_width =
|position    = 
|background  = 
|mark        = 
|marksize    = 
|mark_bottom = 
|link        = 
</pre>
|}
===Final===
{| class="wikitable"
|-
! Graus decimals
! Graus, minuts, segons
! Amb {{tl|coord}}<small><br>(normalment per a infotaules)</small>
! colspan="2" | [[Wikidata]]
El punt a marcar:
|-
| rowspan="2" style="vertical-align:top;" |<pre>
|lat_deg = 
|lon_deg = 
}}
</pre>
| rowspan="2" style="vertical-align:top;" |<pre>
|lat_deg = 
|lat_min = 
|lat_sec = 
|lat_dir = 
|lon_deg = 
|lon_min = 
|lon_sec = 
|lon_dir = 
}}
</pre>
| rowspan="2" style="vertical-align:top;" |<pre>
|coordinates = {{coord| | }}
}}
</pre>
|Coincideix  amb l'article
|No coincideix amb l'article
|-
| style="vertical-align:top;" |<pre>
}}
</pre>
|style="vertical-align:top;" |<pre>
|wd_coord =
}}
</pre>
|}

== Exemples ==
===Valors per defecte d'amplada i de flotar, sense etiqueta, peu de mapa per defecte===
Nota: quan no s'especifica cap etiqueta, el peu de mapa per defecte és "Nom de la pàgina (nom del mapa)", de manera que si aquest exemple es visualitzés en una pàgina anomenada <u>Pag</u>, el peu de mapa per defecte seria "Pag (Croàcia).". De la mateixa manera, en una pàgina anomenada <u>Pag (ciutat)</u>, el peu de mapa per defecte seria "Pag (ciutat) (Croàcia)".
{{Location map|Croàcia
|alt     = Pag és en una illa.
<!-- els separadors dels decimals han de ser un punts: -->
|lat_deg = 44.44 
|lon_deg = 15.05
}}
<pre style=width:40em>
{{Location map|Croàcia
|alt     = Pag és en una illa.
<!-- els separadors dels decimals han de ser un punts: -->
|lat_deg = 44.44 
|lon_deg = 15.05
}}
</pre>
{{clear}}

===Mapa amb el valor predeterminat del peu de mapa===
Nota: quan s'especifica un <code>label</code> (etiqueta), el peu de mapa predeterminat és "Text de l'etiqueta (nom del mapa)", vist com "Pag (Croàcia)" en aquest exemple.
{{Location map|Croàcia
|width = 200
|float = right
|alt = Pag és en una illa.
|label = Pag
|position = right
|mark = Green pog.svg <!--punt verd-->
|lat_deg = 44 |lat_min = 26 <!-- per defecte: lat_dir = N -->
|lon_deg = 15 |lon_min = 3  <!-- per defecte: lon_dir = E -->
}}
<pre style=width:40em>
{{Location map|Croàcia
|width = 200
|float = right
|alt = Pag és en una illa.
|label = Pag
|position = right
|mark = Green pog.svg <!--punt verd-->
|lat_deg = 44 |lat_min = 26 <!-- per defecte: lat_dir = N -->
|lon_deg = 15 |lon_min = 3  <!-- per defecte: lon_dir = E -->
}}
</pre>
{{clear}}

Quan {{para|position|none}}, el text de l'etiqueta no es mostra al costat de la marca, però encara s'utilitza el peu de mapa predeterminat i al text alternatiu predeterminat.
{{Location map|Croàcia
|width = 200
|float = right
|label = Pag
|position = none
|mark = Green pog.svg <!--punt verd-->
|lat_deg = 44 |lat_min = 26 <!-- per defecte: lat_dir = N -->
|lon_deg = 15 |lon_min = 3  <!-- per defecte: lon_dir = E -->
}}
<syntaxhighlight style=width:40em lang="text" highlight="5">
{{Location map|Croàcia
|width = 200
|float = right
|label = Pag
|position = none
|mark = Green pog.svg <!--punt verd-->
|lat_deg = 44 |lat_min = 26 <!-- per defecte: lat_dir = N -->
|lon_deg = 15 |lon_min = 3  <!-- per defecte: lon_dir = E -->
}}
</syntaxhighlight>
{{clear}}

===Marca fora de la vora del mapa, sense peu de mapa===
Si {{para|outside|algun valor}} no s'anotarà la pàgina en la categoria de manteniment d'avis ([[:Categoria:Mapes amb marques fora del mapa i paràmetres exteriors no establerts]]).
{{Location map|Croàcia
|width    = 200
|float    = right
|caption  =
|alt = Rimini a Itàlia (fora del mapa)
|lat_deg  = 44.05
|lon_deg  = 12.57 <!--fora de la vora esquerra del mapa de longitud 13.1-->
|outside  = 1 <!--sabem que el punt està fora del mapa, així no s'anotarà en la categoria d'avís-->
|label    = Rimini
|position = right
}}
<syntaxhighlight style=width:40em lang="text" highlight="7-8">
{{Location map|Croàcia
|width    = 200
|float    = right
|caption  =
|alt = Rimini a Itàlia (fora del mapa)
|lat_deg  = 44.05
|lon_deg  = 12.57 <!--fora de la vora esquerra del mapa de longitud 13.1-->
|outside  = 1 <!--sabem que el punt està fora del mapa, així no s'anotarà en la categoria d'avís-->
|label    = Rimini
|position = right
}}
</syntaxhighlight>
{{clear}}

===Caption, label_size, background, mark, marksize===
{{Location map|Itàlia
|width      = 200
|float      = right
|caption = Ubicació de Rimini a Itàlia
|alt = Mapa d'Itàlia amb una marca que mostra la ubicació de Rimini
|label      = Rimini
|label_size = 150 <!--150% de la mida normal-->
|position   = bottom
|background = orange
|mark       = Orange_pog.svg
|marksize   = 12 <!--mida en píxels-->
|lat_deg    = 44.05
|lon_deg    = 12.578
}}
<syntaxhighlight style=width:40em lang="text" highlight="7,10-11">
{{Location map|Itàlia
|width      = 200
|float      = right
|caption = Ubicació de Rimini a Itàlia
|alt = Mapa d'Itàlia amb una marca que mostra la ubicació de Rimini
|label      = Rimini
|label_size = 150 <!--150% de la mida normal-->
|position   = bottom
|background = orange
|mark       = Orange_pog.svg
|marksize   = 12 <!--mida en píxels-->
|lat_deg    = 44.05
|lon_deg    = 12.57
}}
</syntaxhighlight>
{{clear}}

{{anchor|Alternative style of map}}<!--former section name for links from other pages-->
=== Paràmetre ''AlternativeMap'' (mapa alternatiu), enllaç en l'etiqueta i ubicació des de Wikidata ===
{{Location map|Itàlia
|AlternativeMap = Italy location map.svg
|width   = 200
|float   = right
|caption = Ubicació de Roma a Itàlia
|alt = Mapa d'Itàlia amb una marca que mostra la ubicació de Roma
|label   = [[Roma]]
|wd_coord = Q220
}}
<syntaxhighlight style=width:40em lang="text" highlight="2">
{{Location map|Itàlia
|AlternativeMap = Italy location map.svg
|width   = 200
|float   = right
|caption = Ubicació de Roma a Itàlia
|alt = Mapa d'Itàlia amb una marca que mostra la ubicació de Roma
|label   = [[Roma]]
|wd_coord = Q220
}}
</syntaxhighlight>
{{clear}}

{{anchor|Relief}}<!--former section name for links from other pages-->
=== Paràmetre ''relief'' (relleu) ===
Per a utilitzar el mapa de relleu (el segon o image1) en la llista d'imatges de la definició del mapa.

{{Location map|Nepal
|relief = yes
|caption = Ubicació de l'aeroport de Biratnagar al Nepal
|alt = L'aeroport de Biratnagar es troba al sud-est del Nepal.
|label = Biratnagar
|mark = Airplane silhouette.svg
|marksize = 10
|lat_deg = 26 |lat_min = 28 |lat_sec = 53 |lat_dir = N
|lon_deg = 87 |lon_min = 15 |lon_sec = 50 |lon_dir = E
}}
<syntaxhighlight style=width:40em lang="text" highlight="2">
{{Location map|Nepal
|relief = yes
|caption = Ubicació de l'aeroport de Biratnagar al Nepal
|alt = L'aeroport de Biratnagar es troba al sud-est del Nepal.
|label = Biratnagar
|mark = Airplane silhouette.svg
|marksize = 10
|lat_deg = 26 |lat_min = 28 |lat_sec = 53 |lat_dir = N
|lon_deg = 87 |lon_min = 15 |lon_sec = 50 |lon_dir = E
}}
</syntaxhighlight>
{{clear}}

{{Location map|Nepal
|relief = 
|caption = Ubicació de l'aeroport de Biratnagar al Nepal
|alt = L'aeroport de Biratnagar es troba al sud-est del Nepal.
|label = Biratnagar
|mark = Airplane silhouette.svg
|marksize = 10
|lat_deg = 26 |lat_min = 28 |lat_sec = 53 |lat_dir = N
|lon_deg = 87 |lon_min = 15 |lon_sec = 50 |lon_dir = E
}}
<syntaxhighlight style=width:40em lang="text" highlight="2">
{{Location map|Nepal
|relief = 
|caption = Ubicació de l'aeroport de Biratnagar al Nepal
|alt = L'aeroport de Biratnagar es troba al sud-est del Nepal.
|label = Biratnagar
|mark = Airplane silhouette.svg
|marksize = 10
|lat_deg = 26 |lat_min = 28 |lat_sec = 53 |lat_dir = N
|lon_deg = 87 |lon_min = 15 |lon_sec = 50 |lon_dir = E
}}
</syntaxhighlight>
{{clear}}

{{Location map/Categories de mapes}}

{{Location map marques}}
== Vegeu també ==
* Plantilles per col·locar marques en un mapa:
{{Plantilles per a creació d'indicacions en mapes}}
* Per a proves podeu utilitzar {{tl|Location map/prova}}
<includeonly>
[[Categoria:Plantilles per a mapes]]
</includeonly>