Visualizza wikitesto di Template:Mappa di localizzazione/man

Il template oggetto del presente manuale crea una mappa di localizzazione utilizzando un'[[m:Help:composite images|immagine composta]] da una mappa esistente in proiezione ortografica e un simbolo ed etichetta ad essa sovrapposti.

==Utilizzo==
{{TabellaTemplate
|nome=Mappa di localizzazione
|parametri=
'''{{!}}"CODICE MAPPA"'''<br>
{{parametro|label|F}}
{{parametro|label_size|F}}
{{parametro|position|F}}
{{parametro|background|F}}
{{parametro|latitudineGradi|F}}
{{parametro|latitudinePrimi|F}}
{{parametro|latitudineSecondi|F}}
{{parametro|latitudineNS|F}}
{{parametro|longitudineGradi|F}}
{{parametro|longitudinePrimi|F}}
{{parametro|longitudineSecondi|F}}
{{parametro|longitudineEW|F}}
{{parametro|lat|F}}
{{parametro|long|F}}
{{parametro|mark|F}}
{{parametro|marksize|F}}
{{parametro|link|F}}
{{parametro|border|F}}
{{parametro|caption|F}}
{{parametro|float|F}}
{{parametro|width|F}}
{{parametro|max_height|F}}
{{parametro|relief|F}}
{{parametro|AlternativeMap|F}}
{{parametro|noerr|F}}
{{parametro|cat_fuorimappa|F}}
{{parametro|sinottico|F}}
|istruzioni=
* '''CODICE MAPPA''': Nome descrittivo della mappa o codice [[ISO 3166-1 alpha-3|codice ISO 3166-1 alpha-3]] della nazione. Per conoscere le mappe che si possono usare vedere la sezione [[#Mappe_disponibili|Mappe disponibili]] di questa pagina.
* '''label''' = testo dell'etichetta
* '''label_size''' = dimensione percentuale dell'etichetta (default 90)
* '''position''' = posizione dell'etichetta rispetto al punto. Valori possibili: left, right, top, bottom, topleft, topright, bottomleft, bottomright; di default posiziona a destra, oppure a sinistra se troppo vicino al bordo destro
* '''background''' = colore di sfondo per l'etichetta, di default non c'è sfondo
* '''latitudineGradi''' = gradi di ''latitudine''
* '''latitudinePrimi''' = minuti primi di ''latitudine''
* '''latitudineSecondi''' = minuti secondi di ''latitudine''
* '''latitudineNS''' = latitudine: S=sud, N=nord (default)
* '''longitudineGradi''' = gradi di ''longitudine''
* '''longitudinePrimi''' = minuti primi di ''longitudine''
* '''longitudineSecondi''' = minuti secondi di ''longitudine''
* '''longitudineEW''' = longitudine: W=ovest, E=est (default)
* '''lat''' = ''latitudine'' (in formato decimale; per latitudini sud inserire valori negativi)
* '''long''' = ''longitudine'' (in formato decimale; per longitudini ovest inserire valori negativi)
* '''mark''' = ''nome file del simbolo'', il default è un punto rosso
* '''marksize''' = ''dimensioni del simbolo'', default=8
* '''link''' = titolo di una voce a cui mandare quando si clicca il punto rosso
* '''border''' = ''colore del bordo'' o ''none''
* '''caption''' = didascalia sotto la mappa; se non si vuole, inserire "caption="; se il parametro è omesso la didascalia sarà "Label (luogo)"
* '''float''' = allineamento della mappa: left, right, center o none
* '''width''' = larghezza della mappa in pixel, default 240
* '''max_height''' = altezza massima della mappa in pixel (funziona solo per le mappe per cui è definito il rapporto altezza:larghezza)
* '''relief''' = inserire un valore qualsiasi per utilizzare la carta fisica anziché politica (se disponibile). Si può utilizzare il sinonimo "fisica" per questo parametro.
* '''AlternativeMap''' = nome dell'eventuale immagine alternativa
* '''noerr''' = se inserito  un valore qualsiasi, esempio "noerr=sì", disabilita i messaggi di errore
* '''cat_fuorimappa''' = permette di ridefinire il nome della categoria "Pagine con coordinate al di fuori della mappa di localizzazione", si veda la sezione "[[#Segnalazione errori|Segnalazione errori]]".
* '''sinottico''' = se inserito  un valore qualsiasi, esempio "sinottico=sì", imposta alcuni parametri a valori prefissati o di default, in modo da renderli adatti all'utilizzo della mappa di localizzazione in un sinottico. I parametri interessati sono i seguenti cinque: "position" e "float" vengono impostati a 'center', "caption" a stringa vuota, width a un valore di default di 260 e max_height a un valore di default di 400.
}}
{{-}}

== Coordinate ==
Le coordinate vanno inserite in uno dei due seguenti formati:
* gradi decimali: attraverso i parametri "lat" e "long"
* gradi sessagesimali (gradi, minuti e secondi): attraverso i parametri latitudineGradi, latitudinePrimi, latitudineSecondi, latitudineNS, longitudineGradi, longitudinePrimi, longitudineSecondi e longitudineEW. Questo formato è anche detto DMS (dall'inglese degrees, minites, seconds).
Se si utilizzano lat e long non vanno utilizzati i parametri per i gradi sessagesimali, e viceversa.

Se le coordinate non sono inserite ma sono presenti sull'item [[Aiuto:Wikidata|Wikidata]] collegato, vengono lette da Wikidata. Se non presenti neanche su Wikidata viene visualizzato un messaggio di errore.

== Mappe disponibili ==
Sono disponibili mappe per tutti gli stati e dipendenze dotati di codice [[ISO 3166-1 alpha-3]] (il nome della mappa è uguale al codice). Ci sono anche alcune mappe per regioni nazionali e internazionali, stati storici e grandi città.

Per conoscere tutte le mappe attualmente disponibili vedi la [[:Categoria:Template mappa di localizzazione]] e per un elenco alfabetico [[Speciale:Prefissi/Template:Mappa_di_localizzazione/]] (quelli in corsivo sono redirect, da evitare in quanto utilizzano la codifica CIO anziché i codici ISO).

== Segnalazione errori ==
Il template effettua una serie di controlli sui parametri e in caso di errore visualizza un messaggio appropriato e categorizza la voce in [[:Categoria:Errori di compilazione del template Mappa di localizzazione]], o nelle più specifiche [[:Categoria:Pagine con mappa di localizzazione non esistente]] e [[:Categoria:Pagine con coordinate al di fuori della mappa di localizzazione]].

Elenco dei possibili messaggi di errore, con la loro spiegazione:
* "Mappa non specificata": non è stato specificato il primo parametro, senza nome, del template, che rappresenta il nome della mappa
* "Mappa non disponibile": non esiste la pagina "Template:Mappa di localizzazione/nome mappa"
* "Latitudine non specificata": non è stata inserita la latitudine in formato decimale o DMS, e non è presente su Wikidata
* "Longitudine non specificata": non è stata inserita la longitudine in formato decimale o DMS, e non è presente su Wikidata
* "I gradi/minuti/secondi di latitudine/longitudine non sono validi": i valori di latitudine/longitudine inseriti in formato decimale (o DMS) non sono validi
* "Coordinate al di fuori della mappa": le coordinate inserite, o in loro assenza lette da Wikidata, indicano una posizione al di fuori della mappa

* Errori specifici del formato DMS:
** "I gradi decimali e DMS non vanno utilizzati insieme per la latitudine/longitudine": sono stati valorizzati latitudineGradi/longitudineGradi, quando era già presente "lat"/"long" (decimale)
** "I minuti vanno utilizzati insieme ai gradi DMS per la latitudine/longitudine": sono stati valorizzati latitudinePrimi/longitudinePrimi, quando era già presente "lat"/"long" (decimale)
** "I secondi vanno utilizzati insieme ai gradi DMS per la latitudine/longitudine": sono stati valorizzati latitudineSecondi/longitudineSecondi, quando era già presente "lat"/"long" (decimale)
** "L'emisfero va utilizzato insieme ai gradi DMS per la latitudine/longitudine": sono stati valorizzati latitudineNS/longitudineEW, quando era già presente "lat"/"long" (decimale)
** "I minuti di latitudine/longitudine sono utilizzati senza i gradi": sono stati valorizzati latitudinePrimi/longitudinePrimi senza latitudineGradi/longitudineGradi
** "I secondi di latitudine/longitudine sono utilizzati senza i minuti": sono stati valorizzati latitudineSecondi/longitudineSecondi senza latitudinePrimi/longitudinePrimi
** "L'emisfero di latitudine/longitudine è utilizzato senza i gradi": sono stati valorizzati latitudineNS/longitudineEW senza latitudineGradi/longitudineGradi
** "L'emisfero di latitudine/longitudine non è valido": il valore inserito per latitudineNS/longitudineEW non è valido.

== Esempi ==

=== Mappa con didascalia default (in gradi) ===

{| width=100%
| width=60% valign=top | '''Pago (Croazia)'''
<pre>{{Mappa di localizzazione
|HRV
|label = Pago
|latitudineGradi = 44
|latitudinePrimi = 26
|longitudineGradi = 15
|longitudinePrimi = 3
|position = right
|width = 200
|float = right
}}</pre>
| align="center" |
{{Mappa di localizzazione|HRV|label=Pago||latitudineGradi=44|latitudinePrimi=26|longitudineGradi=15|longitudinePrimi=3|position=right|width=200|float=right}}
|}

=== Mappa con didascalia default (decimale) ===

{| width=100%
| width=60% valign=top | '''Pago (Croazia)'''
<pre>{{Mappa di localizzazione
|HRV
|label = Pago
|lat = 44.44
|long = 15.05
|position = right
|width = 200
|float = right
}}</pre>
| width="200" align="center" | {{Mappa di localizzazione|HRV|label=Pago|lat=44.44|long=15.05|position=right|width=200|float=right}}
|}

=== Mappa con didascalia e sfondo personalizzati ===

{| width=100%
| width=60% valign=top | '''Imotski'''
<pre>{{Mappa di localizzazione
|HRV
|label = Imotski
|lat = 43.44
|long = 17.21
|position = right
|width = 200
|float = right
|background = #FFFFDD
|caption = Posizione di Imotski in Croazia 
}}</pre>
| width="200" align="center" | {{Mappa di localizzazione|HRV|label=Imotsky|lat=43.44|long=17.21|position=right|width=200|float=right|background=#FFFFDD|caption=Posizione di Imotski in Croazia}}
|}

=== Mappa con etichetta e simbolo più grandi del valore default ===

{| width=100%
| width=60% valign=top | '''Pago (Croazia)'''
<pre>{{Mappa di localizzazione
|HRV
|label = Pago
|label_size = 200
|lat = 44.44
|long = 15.05
|marksize = 14
|position = right
|width = 200
|float = right
|background = #FFFFDD
|caption = L'isola di Pago in Croazia
}}</pre>
| width="300" align="center" | {{Mappa di localizzazione|HRV|label=Pago|label_size=200|lat=44.44|long=15.05|marksize=14|position=right|width=200|float=right|background=#FFFFDD|caption=L'isola di Pago in Croazia}}
|}

=== Mappa senza didascalia ===

{| width=100%
| width=60% valign=top | '''Brčko (Bosnia Erzegovina)'''
<pre>{{Mappa di localizzazione
|BIH
|label = Brčko
|position = left
|width = 150
|lat = 44.87
|long = 18.81
|float = right
|caption =
}}</pre>
| width="200" | {{Mappa di localizzazione|BIH|label=Brčko|position=left|width=150|lat=44.87|long=18.81|float=right|caption=}}
|}

=== Emisfero occidentale (in gradi) ===

{| width=100%
| width=60% valign=top | '''Lockerbie (Scozia)'''
<pre>{{Mappa di localizzazione
|SCO
|label = Lockerbie
|latitudineNS = N
|latitudineGradi = 55
|latitudinePrimi = 07
|latitudineSecondi = 15.93
|longitudineEW = W
|longitudineGradi = 03
|longitudinePrimi = 21
|longitudineSecondi = 19.05
|position = right
|width = 200
|float = right
|caption = Posizione di Lockerbie in Scozia
}}</pre>
| width="200" align="center" | {{Mappa di localizzazione|SCO|label=Lockerbie|latitudineNS=N|latitudineGradi=55|latitudinePrimi=07|latitudineSecondi=15.93|longitudineEW=W|longitudineGradi=03|longitudinePrimi=21|longitudineSecondi=19.05|position=right|width=200|float=right|caption=Posizione di Lockerbie in Scozia}}
|}

=== Emisfero occidentale (decimale) ===

{| width=100%
| width=60% valign=top | '''Lockerbie (Scozia)'''
<pre>{{Mappa di localizzazione
|SCO
|label = Lockerbie
|lat = 55.121091
|long = -3.355293
|position = right
|width = 200
|float = right
|caption = Posizione di Lockerbie in Scozia
}}</pre>
| width="200" align="center" | {{Mappa di localizzazione|SCO|label=Lockerbie|lat=55.121091|long=-3.355293|position=right|width=200|float=right|caption=Posizione di Lockerbie in Scozia}}
|}

=== Nazioni che attraversano il 180º meridiano ===

{| width=100%
| width=60% valign=top | '''Uelen (Russia)'''
<pre>{{Mappa di localizzazione
|RUS
|label = Uelen
|latitudineGradi = 66
|latitudinePrimi = 09
|latitudineSecondi = 34.00
|longitudineGradi = 169
|longitudinePrimi = 48
|longitudineSecondi = 33.00
|longitudineEW = E
|position = left
|width = 500
|float = right
|background = #FFFFDD
}}</pre>
| align="center" |
{{Mappa di localizzazione|RUS|label=Uelen|latitudineGradi=66|latitudinePrimi=09|latitudineSecondi=34.00|longitudineGradi=169|longitudinePrimi=48|longitudineSecondi=33.00|longitudineEW=W|position=left|width=500|float=right|background=#FFFFDD}}
|}

== Creare nuove mappe ==
#Trovate una mappa senza scritte e in proiezione ortografica
#Create la sottopagina del Template:Mappa di localizzazione utilizzando, se esiste, la codifica [[ISO 3166-1|ISO 3166-1 alpha-3]] altrimenti il nome del ''luogo'' (altri nomi si possono creare come redirect)
#Inserire nella pagina (completandolo) il seguente codice:
<pre>
<nowiki>{{#switch:{{{1}}}
|name   = 
|top    = 
|bottom = 
|left   = 
|right  = 
|image  = 
|image1 =
}}<noinclude>{{Mappa di localizzazione/info|cat=}}
</noinclude></nowiki></pre>

* ''name'' = nome italiano del luogo
* ''top'' = latitudine decimale della cima della mappa
* ''bottom'' = latitudine decimale del fondo della mappa
* ''left'' = longitudine decimale del lato sinistro della mappa
* ''right'' = longitudine decimale del lato destro della mappa
* ''image'' = nome del file della mappa
* ''image1'' = [opzionale] nome del file della mappa fisica (se la precedente è politica)

Altri elementi opzionali dello #switch, raramente utilizzati:
* ''ratio'' = rapporto altezza : larghezza dell'immagine, con il punto per i decimali, ad es. se l'immagine base è 250x400 indicare 0.625; abilita l'uso di ''max_height'', generalmente utile per le mappe molto estese in verticale
* ''crosses180'' = inserire valore non vuoto se la mappa attraversa il 180º meridiano
* ''mark'' = nome file per un segnalino ''di default'' diverso dal pallino rosso
* ''marksize'' = dimensione del segnalino di default diverso dal pallino rosso

Nei casi particolari di mappe non equirettangolari, si aggiungono i seguenti elementi allo #switch:
* ''x'' = espressione (per [[Aiuto:Funzioni_parser#expr|#expr]]) che calcola la posizione orizzontale in pixel in funzione di latitudine (variabile <nowiki>{{{2}}}</nowiki>) e longitudine (variabile <nowiki>{{{3}}}</nowiki>)
* ''y'' = espressione (per #expr) che calcola la posizione verticale in pixel in funzione di latitudine (variabile <nowiki>{{{2}}}</nowiki>) e longitudine (variabile <nowiki>{{{3}}}</nowiki>)

Parametri del [[Template:Mappa di localizzazione/info]]:
* ''cat'' = assegna un'eventuale [[:Categoria:Template mappa di localizzazione|sottocategoria]] alla sottopagina della mappa

'''N.B.''' Copiare una mappa da una Wikipedia straniera in genere è facile, basta tradurre il "name" e correggere la parte dopo "noinclude". Verifica però che non abbiamo già tale mappa sotto un altro nome (codice o nome italiano).

==Pagine correlate==
* [[Template:Mappa di localizzazione+]]
* [[Template:Mappa di localizzazione~]]
* [[Modulo:Mappa di localizzazione]]: modulo che implementa le funzionalità dei template delle mappe di localizzazione

{{progetto|geografia|template}}

<noinclude>[[Categoria:Manuali dei template|Mappa di localizzazione]]</noinclude>