Template:Mapshape/man

Documentazione

Questo modello sovrappone una maschera, una forma o una linea su una mappa dinamica. Le coordinate per la sovrapposizione provengono dal database di OpenStreetMap e richiede che i dati di OpenStreetMap siano connessi a quelli di Wikidata - in molti casi il campo "wikidata" dovrà essere aggiunto a OpenStreetMap prima che il template venga usato. Per esempio, la voce di Wikidata per l'Alaska è Q797 e il dato su OpenStreetMap per Alaska (http://www.openstreetmap.org/relation/1116270) ha un ID di Wikidata, in modo che l'ID di Wikidata possa essere usato con questo modello. Più di un ID può essere determinato da una virgola.

Per aggiungere un ID ai dati di OpenStreetMap che non ne contenga già uno, visitate https://www.openstreetmap.org/ e aggiungete un tag Wikidata con il valore Q. Dopo aver aggiornato OpenStreetMap ci vogliono 2-3 giorni (a volte molto più tempo) prima che i dati diventino disponibili per l'uso nelle mappe dinamiche.

Vedi mw:Help:Extension:Kartographer#External data per ulteriori dettagli, o #Wikidata tags su OSM.

Parametri

wikidata: (Opzionale) L'ID di Wikidata da usare per la maschera. Se non viene specificato alcun valore, viene utilizzato l'ID Wikidata predefinito per la pagina. È possibile utilizzare più ID se sono separati da virgole.
type: (Opzionale) Il tipo di sovrapposizione da aggiungere. Il valore predefinito è "geomask". I valori validi sono:
- "geomask" - ombreggiare tutto al di fuori di un confine
- "geoshape" - ombreggiare tutto all'interno di un confine
- "geoline" - applica una linea
- "page" - usa la mappa GeoJSON a cui fa riferimento il parametro "wikicommons". Ad esempio, vedi Madrid.
group: (Opzionale) Definisce un gruppo a cui aggiungere lla sovrapposizione. Questo parametro deve essere utilizzato solo quando si utilizzano più mappe dinamiche su una pagina; in questi casi, il parametro "show" del template {{mapframe}} deve corrispondere al parametro "group" per la sua forma corrispondente (vedi esempio sotto).
fill: (Opzionale) Un colore alternativo da utilizzare per la forma. Il colore deve essere un colore web valido, per esempio #ff0000 per il rosso.
opacity: (Opzionale) La quantità di opacità per l'area ombreggiata dalla maschera o dalla forma. Deve essere specificato come un numero compreso tra 0 e 1, dove 0 significa "completamente trasparente" e 1 significa "completamente opaco".
stroke: (Opzionale) Un colore alternativo per una linea o il contorno di una forma. Il colore deve essere valido per il web, per esempio #ff0000 per il rosso.
stroke-width: (Opzionale) La larghezza di una linea o il contorno di una forma. Deve essere specificato come numero. Il valore predefinito è 1.
stroke-opacity: (Opzionale) Il livello di opacità per una linea. Deve essere specificato come un numero compreso tra 0 e 1, dove 0 significa "completamente trasparente" e 1 significa "completamente opaco". Il valore predefinito è 1.
title: (Opzionale) Titolo da mostrare quando si fa clic sul mapshap (può contenere dei riferimenti, per esempio).

Esempio

La maschera della mappa utilizza sempre i valori estrapolati da wikidata:

{{Mapframe|52.16|-112.15|zoom=3}}
{{mapshape|wikidata=Q797}}

Forma della mappa:

{{Mapframe|52.16|-112.15|zoom=3}}
{{mapshape|type=geoshape|wikidata=Q797}}

Mappe multiple identificate utilizzando i parametri "group" e "show":

{{Mapframe|52.16|-112.15|zoom=3|show=map1}}
{{mapshape|wikidata=Q797|type=geoshape|group=map1}}

{{Mapframe|34.006|-118.401|zoom=13|show=map3}}
{{mapshape|wikidata=Q493378|group=map3}}

Dati del template

Questo modello sovrappone una maschera, una forma o una linea su una mappa dinamica.

Parametri template[Modifica dati del modello]
Parametro		Descrizione	Tipo	Stato
Wikidata link	`wikidata`	Wikidata QID che corrisponde al valore di OpenStreetMap da usare Esempio Q797	Numero	facoltativo
tipo di ombreggiatura	`type`	I valori validi sono 'geomask' (ombreggia tutto all'interno di un confine), 'geoshape' ('ombreggia tutto all'interno di un confine') e 'geoline' (visualizza una linea) Predefinito geomask Esempio geoshape	Stringa	facoltativo
Group	`group`	Definire un gruppo a cui aggiungere la sovrapposizione. Esempio map2	Stringa	facoltativo

Wikidata tags su OSM

Per visualizzare ad esempio il maphape di una linea metropolitana, come scritto sopra, la relazione OSM e l'articolo wikidata devono essere collegati. A volte la situazione è semplice, come ad esempio Q1292805 è collegata a OSM relation ID 7772996, e anche il contrario in OSM (guarda il tag wikidata).

Molte volte, wikidata può riferirsi solo al cosiddetto Super-Relation. Il template non può essere l'appiglio per questo, come (l'autore educatamente suppone) non c'è possibilità che una parte abbia una relazione diretta. Tuttavia si può essere aiutati. Per esempio, Q99691 si connette a OSM con (super-)relation 58767, che contiene già il link giusto a Wikidata. La relazione è costituita da relazioni con i membri 2669205 e 2669206 (entrambi i modi della linea della metropolitana). Aggiungendo il tag wikidata=Q99691 a queste relazioni, nessun danno viene fatto ai membri di OSM - e il modello di Mapshape inizierà il lavoro in seguito.

Manuale di Editing

Potreste essere fortunati e i dati OSM potrebbero essere già tutti inseriti. Utilizzare per es. overpass-turbo e zoomare sulla città che desideri. Quindi inserire il seguente dato (sostituisci il WIKIDATA_ID con uno dei precedenti):

[out:json][timeout:25];
// gather results
(
   relation["wikidata"="WIKIDATA_ID"]({{bbox}});
);
// print results
out body;
>;
out skel qt;

Se la singola linea è stata trovata (qui si fa l'esempio di una linea metropolitana ma può essere trovato anche il parametro di un'area allo stesso modo), prendete il numero della relazione su OSM (è un numero in alto tra parentesi nell'attuale versione OSM su browser), copiate il numero e inseritelo su wikidata ricercando il parametro identificativo relazione OpenStreetMap, lì andrà messo questo numero.
Altrimenti, dobbiamo andare più a fondo. Andate su openstreetmap.org, ingrandite la città e prova a cercare la linea di trasporto utilizzando il pulsante "funzioni di query" sulla destra ("una freccia con un punto interrogativo").
Di solito, i dati OSM sono strutturati in modo che ogni direzione della linea abbia una sua relazione (905096). Questi sono quindi raggruppati in "super-relation" (1676043), e quelli sono infine raggruppati in una relazione di tutte le linee di trasporto (376752). In questo modo, potete risparmiare un po' di tempo - e dopo aver trovato la prima riga, potete trovare facilmente il resto.
Dopo aver trovato tutte le relazioni di linea (e super-relations), aggiungeteli a wikidata.
Se mancano gli ID wikidata nelle relazioni OSM, è necessario modificare le rispettive relazioni e aggiungere il tag wikidata relativo all'elemento in modo da associare entrambi. Ai fini di questo modello (Mapshapes), aggiungete il tag wikidata alla relazione di linea. Per fare ciò dovrete avere un account OSM e usare l'editor online. Trovate la relazione, ingrandite sufficientemente la mappa per poter modificare, premete il pulsante di modifica e aggiungete/correggete il tag wikidata.

Attenzione, quando si inserisce il valore wikidata su OSM non è detto che poi l'area o la linea che volete visualizzare comparirà! Spesso accade che prima di poter visualizzare l'elemento sia necessario far passare alcuni giorni. Il problema è sicuramente legato agli aggiornamenti di software OSM o probabilmente all'approvazione di un amministratore. Infatti le relazioni che vengono mostrate subito sono quelle dove il parametro wikidata è già presente su OSM. Quando si aggiunge su wikidata invece l'aggiornamento è immediato. Tuttavia più relazioni vengono create e più possibilità avremo in futuro di visualizzare elementi utili nelle mappe.

Wikivoyage districtifier

Esiste uno strumento molto semplice e intuitivo per riprodurre il codice semplicemente cliccando sulla mappa della zona interessata tramite Wikivoyage districtifier, esiste anche un video su Youtube dell'autore che ne spiega il funzionamento. In questo modo si può anche creare la suddivisione in distretti sfruttando i collegamenti a wikidata e OSM se presenti automatizzando il processo. Il codice dei distretti ottenuto è simile a questo:

{{Mapframe|width=500|height=500|group=map1}}

{{Mapshape|type=geoshape|wikidata=Q158095|group=map1|fill={{StdColor|T1}}|title=a}}

{{Mapshape|type=geoshape|wikidata=Q158106|group=map1|fill={{StdColor|T2}}|title=b}}

{{Mapshape|type=geoshape|wikidata=Q4071168|group=map1|fill={{StdColor|T3}}|title=c}}

Tale codice se inserito direttamente in una voce non consente di ottenere i risultati sperati in quanto funziona in maniera completa solo per la versione inglese ma non per quella italiana. Per rendere funzionale il codice basterà cancellare la prima riga che dovrebbe mostrare la mappa dinamica e che pertanto va sostituita con una mappa dinamica con l'aggiunta della riga view=Kartographer. Poi dovremo rimuovere la stringa group=map1 e infine sostituire {{StdColor|T1}} con un codice esadecimale di colore che in genere comincia con # solo nel caso in cui i colori delle aree superano 11 suddivisioni. Pertanto il risultato finale (utilizzano il codice esadecimale) sarà come questo:

{{MappaDinamica
| Lat= 38.32
| Long= 22.81
| view=Kartographer
| w = 500 | h = 250 | z = 7
}}

38°19′12″N 22°48′36″E

Mapshape/man

{{Mapshape|type=geoshape|wikidata=Q19890323|fill=#a98838|title=Focide}}

{{Mapshape|stroke-opacity=0.1|type=geoshape|wikidata=Q202624|fill=#dbaa33|title=Etolia-Acarnania}}

{{Mapshape|type=geoshape|stroke=#0000FF|wikidata=Q207554|fill=#78accb|title=Ftiotide}}

{{Mapshape|type=geoshape|wikidata=Q11723827|fill=#e07676|title=Euritania}}

{{Mapshape|type=geoshape|wikidata=Q670126|fill=#899958|title=Eubea}}

{{Mapshape|type=geoshape|wikidata=Q8257871|fill=#9a84a4|title=Beozia}}

Se si aggiunge questo parametro: stroke-opacity=0.1 come visibile nella regione Etolia-Acarnania si elimina il bordo nero rendendo il confine esteticamente migliore. Il parametro stroke=#0000FF ci consente invece di cambiare il colore del bordo.

Creare una maschera

Lo stesso metodo utilizzato per la divisione in distretti consente di mostrare una porzione di territorio entro confini oscurati con una maschera proprio come avviene con il template:mapmask. In questo caso la compilazione è molto più semplice e prevede sempre l'utilizzo dell'elemento wikidata come nell'esempio:

{{Mapshape|wikidata=Q56526316}}

purtroppo nella nostra versione questo metodo ha un solo problema, delimita le aree ma non consente di mostrare i listing al suo interno, pertanto può essere usato solo per evidenziare dei confini laddove mapmask è meno efficace.

Aggiungere aree interne e linee

All'interno della maschera possiamo inserire degli elementi che mettono in risalto delle aree di interesse come i parchi o le riserve marine (come mostrato nella mappa a fianco). I parchi possono essere inseriti utilizzando questa stringa:

{{Mapshape|type=geoshape|wikidata=Q3936869|fill=#808000|title=Pantalica}}

L'aspetto importante è sempre quello che il valore wikidata sia agganciato a quello di Openstreetmaps come descritto in precedenza. Molte volte è necessario aggiungere il valore della mappa OSM su wikidata, viceversa o magari entrambi.

Allo stesso modo possono essere inserite strade, linee di metropolitana e ferrovie con la stringa:

{{Mapshape|type=geoline|wikidata=Q429308|stroke=#000000|stroke-width=1|title=Autostrada A18}}

Dove stroke modifica il colore della linea e stroke-width lo spessore della linea.

Vedi anche

Wikivoyage:Come utilizzare le mappe dinamiche
{{mapframe}} - Modello utilizzato per aggiungere una mappa dinamica a un articolo.
{{mapmask}} - Utilizzato per creare una maschera utilizzando le coppie di latitudine / longitudine delle cifre manualmente; utile per disegnare città o confini che non sono disponibili da OpenStreetMap.
{{Mapshapes}} - template per inserire le linee della metro o del tram.
{{StdColor}}
Mapshaper - pagina web adatta per creare e gestire file mapshape.