Template:Mappa OSM/man
Questo template serve a inserire una mappa all'interno di singole voci con l'indicazione di coordinate geografiche. La mappa può essere allineata a destra, a sinistra oppure al centro.

La funzionalità si basa sul tag mapframe fornito dall'[[mw:Help:Extension:Kartographer|estensione Kartographer]].

== Parametri ==
{{TabellaTemplate
|nome = Mappa OSM
|parametri = 
{{Parametro|cornice|F}}
{{Parametro|sinottico|F}}
{{Parametro|allinea|F}}
{{Parametro|didascalia|F}}
{{Parametro|elenco|F}}
{{Parametro|larghezza|F}}
{{Parametro|altezza|F}}
{{Parametro|gruppo|F}}
{{Parametro|centro_lat|F}}
{{Parametro|centro_lon|F}}
{{Parametro|zoom|F}}
{{Parametro|autozoom|F}}
{{Parametro|colore|F}}
{{Parametro|simbolo|F}}
----
{{Parametro|latN|F}}
{{Parametro|lonN|F}}
{{Parametro|coloreN|F}}
{{Parametro|nomeN|O}}
{{Parametro|descN|O}}
{{Parametro|simboloN|F}}
{{Parametro|dim_simboloN|F}}
----
{{Parametro|dati|F}}
|istruzioni = 
* '''cornice''' = se uguale a '''1''' viene creata la cornice esterna; se uguale a 0 non è creata la cornice esterna e viene ignorato il parametro ''didascalia''. Valore predefinito: '''1'''.
* '''sinottico''' = se uguale a '''1''' viene tolta la cornice esterna e vengono impostate dimensioni ottimali per l'inserimento in un template sinottico.
* '''allinea''' = permette di allineare la mappa. Valori: ''right'' per allineamento a destra; ''left'' per allineamento a sinistra; ''center'' per allineamento al centro (in questo caso il testo non fluisce attorno alla mappa). Valore predefinito '''right'''.
* '''didascalia''' = didascalia opzionale della mappa (il parametro è ignorato se ''cornice'' = 0 o se ''sinottico'' = 1).
* '''elenco''' = visualizza una legenda con l'elenco dei punti con relativi nomi. Se uguale a 1 mostra l'elenco su una sola colonna; se uguale a 2 mostra l'elenco su due colonne.
* '''larghezza''' = larghezza della mappa in px. Valore predefinito: '''350''' (''260'' se ''sinottico'' = 1).
* '''altezza''' = altezza della mappa in px. Valore predefinito: '''300''' (''260'' se ''sinottico'' = 1).
* '''gruppo''' = nome (non numerico) per identificare la mappa. Permette di avere una numerazione che riparte dal numero 1 nel caso di più mappe nella stessa pagina.
* '''centro_lat''' e '''centro_lon''' = coordinate del centro della mappa. Se non vengono inserite, viene calcolato automaticamente il centro delle coordinate dei punti inseriti.
* '''zoom''' = ingrandimento della mappa di OpenStreetMap, con un valore tra 0 (mondo) e 18 (massimo dettaglio). Per un singolo punto è previsto un valore predefinito ''10'' (''13'' se ''sinottico'' = 1).
* '''autozoom''' = se è uguale a '''s''', viene calcolata automaticamente la scala adeguata per mostrare tutti i punti; se è uguale a '''n''' viene utilizzato zoom automatico da mapframe. Se è indicato un solo punto viene utilizzato il valore predefinito 10. Valore predefinito: '''s'''.
* '''colore''' = colore predefinito per i punti da indicare sulla mappa. Valore predefinito: '''#B80000'''.
* '''simbolo''' = simbolo predefinito per i punti da indicare sulla mappa. Vedere la [[Template:Mappa OSM/Simboli|pagina con tutti i simboli utilizzabili]]. Utilizzare ''-number'' per una sequenza numerica o ''-letter'' per una sequenza alfabetica. Valore predefinito: '''-number'''.

;Inserimento di punti (N numero intero positivo)
* '''latN''' = latitudine del punto N
* '''lonN''' = longitudine del punto N
* '''coloreN''' = colore del punto N
* '''nomeN''' = nome del punto N (può contenere collegamenti a voci)
* '''descN''' = descrizione del punto N mostrata premendo sul punto nella mappa a tutto schermo (può contenere collegamenti e immagini).
* '''simboloN''' = simbolo da utilizzare per il punto N. Vedere la [[Template:Mappa OSM/Simboli|pagina con tutti i simboli utilizzabili]]. Utilizzare ''-number'' per una sequenza numerica o ''-letter'' per una sequenza alfabetica. Valore predefinito: '''-number'''.
* '''dim_simboloN''' = dimensione del simbolo. Valori permessi: ''small'' (piccolo), ''medium'' (medio), ''large'' (grande). Valore predefinito: ''medium''.

;Inserimento di riferimento a template con dati
* '''dati''' = informazioni da visualizzare sulla mappa in formato [[GeoJSON]], preferibilmente restituito da un template, esempio <code><nowiki>|dati = {{Mappa Rolli di Genova}}</nowiki></code>. Se utilizzato, vengono ignorati eventuali punti inseriti tramite i parametri latN/lonN/nomeN/...
}}
{{-}}

== Simboli ==
Vedi la [[Template:Mappa OSM/Simboli|pagina con tutti i simboli utilizzabili]].

== Esempi di utilizzo ==

=== Singolo punto ===
{{Mappa OSM
|didascalia = Carta della foce del [[Tevere]] e dintorni
|lat1 = 41.740548
|lon1 = 12.233389
|nome1 = Foce del [[Tevere]]
|gruppo = a
}}
Indicando un solo punto viene mostrata la semplice mappa del luogo.

Se non viene impostato il parametro ''zoom'', l'ingrandimento predefinito è 10.

<pre>
{{Mappa OSM
|didascalia = Carta della foce del [[Tevere]] e dintorni
|lat1 = 41.740548
|lon1 = 12.233389
|nome1 = Foce del [[Tevere]]
}}
</pre>
{{clear}}

=== Più punti ===
==== Esempio 1 ====
{{Mappa OSM
|lat1 = 43.786922
|lon1 = 12.077667
|nome1 = Sorgente del [[Tevere]]
|simbolo1 = museum
|lat2 = 41.740548
|lon2 = 12.233389
|nome2 = Foce del [[Tevere]] a [[Roma]]
|colore2 = #008000
|simbolo2 = restaurant
|lat3 = 48.856667
|lon3 = 2.351944
|nome3 = [[Parigi]]
|colore3 = #0000b8
|simbolo3 = library
|gruppo = b
}}
Esempio di centratura e ingrandimento calcolati automaticamente.
<pre>
{{Mappa OSM
|lat1 = 43.786922
|lon1 = 12.077667
|nome1 = Sorgente del [[Tevere]]
|simbolo1 = museum
|lat2 = 41.740548
|lon2 = 12.233389
|nome2 = Foce del [[Tevere]] a [[Roma]]
|colore2 = #008000
|simbolo2 = restaurant
|lat3 = 48.856667
|lon3 = 2.351944
|nome3 = [[Parigi]]
|colore3 = #0000b8
|simbolo3 = library
}}
</pre>
{{clear}}

==== Esempio 2 ====
{{Mappa OSM
|colore = #000080
|lat1 = 41.893625
|lon1 =  12.48226389
|nome1 = [[Cordonata (Roma)|Cordonata capitolina]]
|simbolo1 = -letter
|lat2 = 41.8941
|lon2 = 12.4823
|nome2 = [[Insula dell'Ara Coeli|Insula Romana]]
|simbolo2 = -letter
|lat3 = 41.89376944
|lon3 = 12.48290556
|nome3 = [[Cappella Bufalini]]
|simbolo3 = -number
|gruppo = c
}}
Esempio con punti particolarmente ravvicinati; viene automaticamente determinato l'ingrandimento massimo.
<pre>
{{Mappa OSM
|colore = #000080
|lat1 = 41.893625
|lon1 =  12.48226389
|nome1 = [[Cordonata (Roma)|Cordonata capitolina]]
|simbolo1 = -letter
|lat2 = 41.8941
|lon2 = 12.4823
|nome2 = [[Insula dell'Ara Coeli|Insula Romana]]
|simbolo2 = -letter
|lat3 = 41.89376944
|lon3 = 12.48290556
|nome3 = [[Cappella Bufalini]]
|simbolo3 = -number
}}
</pre>
{{clear}}

==== Esempio 3 ====
{{Mappa OSM
|didascalia = Le nove chiese del centro storico di Busto Arsizio
|elenco = 2
|lat1 = 45.61181
|lon1 = 8.85035
|nome1 = [[Santuario di Santa Maria di Piazza|Santa Maria di Piazza]]
|lat2 = 45.61204
|lon2 = 8.85254
|nome2 = [[Basilica di San Giovanni Battista (Busto Arsizio)|San Giovanni Battista]]
|lat3 = 45.61268
|lon3 = 8.84584
|nome3 = [[Chiesa di San Michele Arcangelo (Busto Arsizio)|San Michele Arcangelo]]
|lat4 = 45.61380
|lon4 = 8.84458
|nome4 = [[Chiesa di Madonna in Prato|Madonna in Prato]]
|lat5 = 45.61067
|lon5 = 8.84673
|nome5 = [[Chiesa di San Rocco (Busto Arsizio)|San Rocco]]
|lat6 = 45.61185
|lon6 = 8.85075
|nome6 = [[Chiesa di Sant'Antonio Abate (Busto Arsizio)|Sant'Antonio Abate]]
|lat7 = 45.61219
|lon7 = 8.85214
|nome7 = San Filippo Neri
|lat8 = 45.60990
|lon8 = 8.85368
|nome8 = [[Chiesa di San Gregorio Magno in Camposanto|San Gregorio Magno]]
|lat9 = 45.61447
|lon9 = 8.85439
|nome9 = [[Tempio civico della Beata Vergine delle Grazie|Tempio Civico]]
}}
Esempio di più punti con centratura e ingrandimento automatici.

<pre>
{{Mappa OSM
|didascalia = Le nove chiese del centro storico di Busto Arsizio
|elenco = 2
|lat1 = 45.61181
|lon1 = 8.85035
|nome1 = [[Santuario di Santa Maria di Piazza|Santa Maria di Piazza]]
|lat2 = 45.61204
|lon2 = 8.85254
|nome2 = [[Basilica di San Giovanni Battista (Busto Arsizio)|San Giovanni Battista]]
|lat3 = 45.61268
|lon3 = 8.84584
|nome3 = [[Chiesa di San Michele Arcangelo (Busto Arsizio)|San Michele Arcangelo]]
|lat4 = 45.61380
|lon4 = 8.84458
|nome4 = [[Chiesa di Madonna in Prato|Madonna in Prato]]
|lat5 = 45.61067
|lon5 = 8.84673
|nome5 = [[Chiesa di San Rocco (Busto Arsizio)|San Rocco]]
|lat6 = 45.61185
|lon6 = 8.85075
|nome6 = [[Chiesa di Sant'Antonio Abate (Busto Arsizio)|Sant'Antonio Abate]]
|lat7 = 45.61219
|lon7 = 8.85214
|nome7 = San Filippo Neri
|lat8 = 45.60990
|lon8 = 8.85368
|nome8 = [[Chiesa di San Gregorio Magno in Camposanto|San Gregorio Magno]]
|lat9 = 45.61447
|lon9 = 8.85439
|nome9 = [[Tempio civico della Beata Vergine delle Grazie|Tempio Civico]]
}}
</pre>
{{clear}}

====Esempio 4====
Esempio con legenda (parametro "elenco").
{{Mappa OSM
|elenco = 1
|gruppo = esempio-elenco
|lat1 = 43.786922
|lon1 = 12.077667
|nome1 = Sorgente del [[Tevere]]
|lat2 = 41.740548
|lon2 = 12.233389
|nome2 = Foce del [[Tevere]] a [[Roma]]
|lat3 = 48.856667
|lon3 = 2.351944
|nome3 = [[Parigi]]
}}
<pre>
{{Mappa OSM
|elenco = 1
|lat1 = 43.786922
|lon1 = 12.077667
|nome1 = Sorgente del [[Tevere]]
|lat2 = 41.740548
|lon2 = 12.233389
|nome2 = Foce del [[Tevere]] a [[Roma]]
|lat3 = 48.856667
|lon3 = 2.351944
|nome3 = [[Parigi]]
}}
</pre>
{{-}}

==== Esempio 5 ====
Esempio di punti particolarmente distanti con scelta manuale dell'ingrandimento. La cartina è centrata. È indicata la dimensione di ognuno dei simboli.
{{Mappa OSM
|allinea = center
|larghezza = 400
|altezza = 300
|zoom = 2
|lat1 = 39.905
|lon1 = 116.391389
|nome1 = [[Pechino]]
|dim_simbolo1 = large
|lat2 = 48.856667
|lon2 = 2.351944
|nome2 = [[Parigi]]
|colore2 = #008000
|dim_simbolo2 = small
|gruppo = e
}}
<pre>
{{Mappa OSM
|allinea = center
|larghezza = 400
|altezza = 300
|zoom = 2
|lat1 = 39.905
|lon1 = 116.391389
|nome1 = [[Pechino]]
|dim_simbolo1 = large
|lat2 = 48.856667
|lon2 = 2.351944
|nome2 = [[Parigi]]
|colore2 = #008000
|dim_simbolo2 = small
}}
</pre>
{{clear}}

== Esempi con dati ==
{{Mappa OSM
|didascalia = [[Palazzi dei Rolli]]
|centro_lat = 44.4118
|centro_lon = 8.9315
|zoom = 15
|dati = {{Mappa Rolli di Genova}}
}}
<pre>
{{Mappa OSM
|didascalia = [[Palazzi dei Rolli]]
|centro_lat = 44.4118
|centro_lon = 8.9315
|zoom = 15
|dati = {{Mappa Rolli di Genova}}
}}
</pre>
{{clear}}

{{Mappa OSM
|didascalia = [[Museo del Louvre]]
|centro_lat = 48.8610
|centro_lon = 2.3359
|zoom = 15
|dati = {
  "type": "ExternalData",
  "service": "geoshape",
  "ids": "Q19675"
}
}}
<pre>
{{Mappa OSM
|didascalia = [[Museo del Louvre]]
|centro_lat = 48.8610
|centro_lon = 2.3359
|zoom = 15
|dati = {
  "type": "ExternalData",
  "service": "geoshape",
  "ids": "Q19675"
}
}}
</pre>
{{clear}}

{{Mappa OSM
|didascalia = [[Autostrada A11 (Italia)|Autostrada A11]]
|larghezza = 400
|centro_lat = 43.8187
|centro_lon = 10.7682
|zoom = 9
|dati = {
  "type": "ExternalData",
  "service": "geoline",
  "ids": "Q781975",
  "properties": {
    "stroke": "#07852c",
    "stroke-width": 8
  }
}
}}
<pre>
{{Mappa OSM
|didascalia = [[Autostrada A11 (Italia)|]]
|larghezza = 400
|centro_lat = 43.8187
|centro_lon = 10.7682
|zoom = 9
|dati = {
  "type": "ExternalData",
  "service": "geoline",
  "ids": "Q781975",
  "properties": {
    "stroke": "#07852c",
    "stroke-width": 8
  }
}
}}
</pre>

==Problemi noti==
{{Mappa OSM
|didascalia = Punti vicini ma mostrati agli estremi opposti
|altezza = 150
|lat1 = 52.0589
|lon1 = -176.1047
|nome1 = Isola 1
|lat2 = 54.7304
|lon2 = 167.7585
|nome2 = Isola 2
|gruppo = f
}}
Per un limite della proiezione utilizzata, non è possibile mostrare punti con latitudine superiore a 85° (nord o sud).

Inoltre, come nell'esempio a lato, i punti tra loro vicini ma con coordinate opposte sono mostrati ai lati opposti della carta.
<pre>
{{Mappa OSM
|didascalia = Punti vicini ma mostrati agli estremi opposti
|altezza = 150
|lat1 = 52.0589
|lon1 = -176.1047
|nome1 = Isola 1
|lat2 = 54.7304
|lon2 = 167.7585
|nome2 = Isola 2
}}
</pre>

<noinclude>[[Categoria:Manuali dei template]]</noinclude>