Template:Coord

Questo template ha un codice sorgente piuttosto complesso.

---

La sua modifica può richiedere buona conoscenza delle funzioni parser. Per favore tenta di modificarlo solo se sei certo di capirne la funzione e sei preparato a riparare ogni conseguente danno collaterale nel caso in cui i risultati fossero diversi da quanto avevi in mente. Tutti gli esperimenti devono essere prima condotti in una pagina di prova.

Istruzioni per l'uso
Le istruzioni che seguono sono contenute nella sottopagina Template:Coord/man (modifica · cronologia)
Sandbox: Template:Coord/Sandbox (modifica · cronologia) · TemplateStyles: Template:Coord/styles.css (modifica · cronologia) · Tutte le sottopagine: lista

Coord è un template usato per inserire in modo standardizzato delle coordinate all'interno di una voce, inoltre produce un collegamento a una lista di servizi che forniscono mappe geografiche relative alle coordinate specificate, ad esempio OpenStreetMap o Google Maps.

Il template inserisce un link nel punto in cui è stato inserito e/o in alto a destra nella voce, come visibile in questa pagina.

Per le coordinate terrestri, cliccando il link si apre una mappa OpenStreetMap interattiva, da cui è possibile accedere ad altri servizi cartografici. Questa funzione richiede un browser con Javascript abilitato; in caso contrario, si aprirà una mappa statica nella pagina Speciale:Map. La mappa interattiva (ma non la pagina speciale, vedi phab:T154922) ha una sezione laterale comprimibile con link ad ulteriori servizi cartografici come OpenStreetMap e Google Maps, nonché un link a GeoHack.

Per le coordinate non terrestri il link porta invece al servizio (EN) GeoHack, il cui aspetto è determinato dai GeoTemplate.

Il template usa le coordinate standard geodetiche WGS84 (latitudine; longitudine) sulla Terra, che possono essere inserite in notazione decimale o sessagesimale, con la precisione desiderata.

Le mappe vengono generate mediante l'estensione di MediaWiki Kartographer.

Il template può essere usato da strumenti che analizzano i dump del database di Wikipedia attraverso i microformat come ad esempio Google Earth. Affinché le coordinate vengano lette da questi servizi è necessario che sia inserita l'opzione display=title (vedi Come posso visualizzare una voce di Wikipedia nel livello Geographic Web di Google Earth?).^{[È sempre così? Non sembra esistere documentazione recente sul microformat Geo, e il link al supporto Google non funziona più]}

Richiama inoltre automaticamente la funzione #coordinates dell'estensione GeoData.

Il template va utilizzato all'interno delle voci di Wikipedia per indicare le coordinate geografiche dell'oggetto di cui parla la voce, oppure per indicare le coordinate geografiche di un oggetto citato all'interno della voce.

Si può inserire il template nella voce indicando le coordinate in gradi decimali oppure in gradi sessagesimali: gradi, minuti e secondi.

Questo tool permette di generare correttamente il codice del template indicando il luogo dell'oggetto sulla mappa di google oppure sulla mappa di OpenStreetMap.

Il template può essere compilato in diversi modi, di seguito vengono elencate le strutture del template per l'utilizzo con le coordinate in gradi decimali e in gradi sessagesimali.

Gradi decimali

Per compilare il template utilizzando i gradi decimali possono essere utilizzate due strutture:

{{coord|latitudine|longitudine|parametri coordinate|parametri template}}

in questo caso il campo latitudine dovrà essere compilato con un numero decimale compreso tra -90 e 90 e il campo longitudine dovrà essere compilato con un numero decimale compreso tra -180 e 180, la parte intera dei numeri dovrà essere separata dalla parte decimale con un punto. Una longitudine negativa si riferisce alla parte sud del globo, una latitudine negativa si riferisce alla parte ovest del globo.

{{coord|latitudine|N/S|longitudine|E/W|parametri coordinate|parametri template}}

in questo caso il campo latitudine dovrà essere compilato con un numero decimale compreso tra 0 e 90 e il campo longitudine dovrà essere compilato con un numero decimale compreso tra 0 e 180, la parte intera dei numeri dovrà essere separata dalla parte decimale con un punto. Il campo N/S dovrà essere compilato con N o S se le coordinate si riferiscono rispettivamente al quadrante Nord o Sud del globo; il campo E/W dovrà essere compilato con E o W se le coordinate si riferiscono rispettivamente al quadrante Est o Ovest (in inglese West) del globo.

Gradi sessagesimali

Per compilare il template utilizzando i gradi sessagesimali, si può usare la seguente struttura

{{coord|lat gradi|lat minuti|lat secondi|N/S|long gradi|long minuti|long secondi|E/W|parametri coordinate|parametri template}}

i campi lat gradi, lat minuti e lat secondi vanno compilati rispettivamente con i gradi, i minuti e i secondi della longitudine. Il parametro lat gradi dovrà essere compilato con un numero intero compreso tra 0 e 90, il parametro lat minuti con un numero intero compreso tra 0 e 60 e il parametro lat secondi con un numero decimale compreso tra 0 e 60 e una precisione decimale del centesimo.

I campi long gradi, long minuti e long secondi vanno compilati rispettivamente con i gradi, i minuti e i secondi della latitudine. I gradi e i minuti dovranno essere numeri interi, i secondi potranno essere numeri interi o numeri decimali con una precisione al centesimo. Il parametro long gradi dovrà essere compilato con un numero intero compreso tra 0 e 180, il parametro long minuti con un numero intero compreso tra 0 e 60 e il parametro long secondi con un numero decimale compreso tra 0 e 60 e una precisione decimale del centesimo.

Il campo N/S dovrà essere compilato con N o S se le coordinate si riferiscono rispettivamente al quadrante Nord o Sud del globo; il campo E/W dovrà essere compilato con E o W se le coordinate si riferiscono rispettivamente al quadrante Eord o Ovest (in inglese West) del globo.

Sì può anche scegliere di inserire le coordinate con una precisione inferiore ai secondi usando una delle due strutture:

{{coord|lat gradi|lat minuti|N/E|long gradi|long minuti|E/W|parametri coordinate|parametri template}}

{{coord|lat gradi|N/E|long gradi|E/W|parametri coordinate|parametri template}}

è importante però che latitudine e longitudine siano indicate con la stessa precisione.

Il campo parametri coordinate presente in tutte le strutture del template coord deve contenere quei parametri opzionali che danno informazioni sulla tipologia di coordinate inserite.

I parametri vanno compilati inserendo il nome del parametro, i due punti e il valore con cui compilarlo, se si vogliono inserire più parametri questi devono essere divisi da un trattino basso, per esempio

parametro1:valore1_parametro2:valore2_parametro3_valore3

I parametri sono i seguenti:

Il parametro type: indica il tipo di oggetto a cui puntano le coordinate. Questo parametro viene utilizzato anche per definire la scala della mappa in cui verranno presentate le coordinate, quando non viene impostata esplicitamente con dim: oppure scale:.

Il parametro può essere compilato con uno dei seguenti valori:

Il parametro dim: indica la dimensione dell'oggetto espressa in metri o in chilometri. Nel caso fosse compilato il parametro dim:, la scala della mappa in cui verranno presentate le coordinate sarà decisa utilizzando questo parametro e non più il parametro type:.

La sintassi del parametro dim: è la seguente

dim:<dimensione><unità>

dove

• <dimensione> è un numero intero che rappresenta la dimensione espressa in metri o in chilometri;
• <unità> è l'unità di misura, usare m per i metri e km per i chilometri. Il default è metri.

La scala che viene impostata è pari a 10 volte la dimensione in metri.

Il parametro scale: indica la scala da utilizzare per mostrare le coordinate nella mappa. Nella decisione della scala da utilizzare questo parametro prevale su tutti gli altri.

Il parametro dovrà essere compilato con un numero intero, per esempio scale:50000 farà sì che la mappa verrà mostrata con una scala 1:50 000.

Esempi dello stesso punto mostrato a diverse scale su Google Maps: 1:1 000, 1:3 000, 1:5 000, 1:10 000, 1:30 000, 1:50 000, 1:100 000, 1:300 000, 1:500 000, 1:1 000 000, 1:3 000 000, 1:5 000 000, 1:10 000 000, 1:30 000 000, 1:50 000 000, 1:100 000 000

Il campo region: è utilizzato per indicare la regione geografica in cui si trova il punto indicato dalle coordinate. In base alla regione GeoHack può spesso fornire una diversa selezione di servizi di cartografia locali.

Il campo va compilato inserendo il codice del Paese (ISO 3166-1 alpha-2) oppure della regione (ISO 3166-2) in cui si trova il punto indicato dalle coordinate. Se il campo non viene valorizzato con alcun parametro GeoHack è spesso in grado di determinare il codice da solo in base alle coordinate.

Il parametro globe: indica il nome del pianeta o del satellite naturale in cui si trova il punto indicato dalle coordinate. Il valore di default è earth per Terra, gli altri valori disponibili sono:

L'aspetto delle pagine di GeoHack relative a questi corpi celesti è definito dai rispettivi GeoTemplate. Se un GeoTemplate non è ancora definito su it.wiki, viene utilizzato quello in inglese.

Gli eventuali parametri del template sono i seguenti:

• display = viene utilizzato per scegliere dove il template dovrà mostrare le coordinate. Se il parametro non viene compilato, di default il template mostra le coordinate nel punto in cui viene inserito, altrimenti il parametro può essere compilato in uno dei seguenti modi:
  • display = inline - in questo caso le coordinate verranno mostrate nel punto in cui viene inserito il template, come di default.
  • display = title - in questo caso le coordinate verranno mostrate solo in cima alla pagina, accanto al titolo.
  • display = inline,title - in questo caso le coordinate verranno mostrate sia nel punto in cui viene inserito il template, sia in cima alla pagina, accanto al titolo.

Importante: le coordinate devono essere mostrate accanto al titolo solo se si riferiscono all'oggetto di cui parla la voce e non ad uno dei luoghi menzionati al suo interno, dunque in una voce è permesso l'inserimento di un solo template {{coord}} che mostra le coordinate accanto al titolo.

• name = il parametro deve essere compilato con il nome dell'oggetto a cui le coordinate si riferiscono, se questo parametro non viene compilato, il template utilizza di default il nome della voce in cui viene inserito.
• format = viene utilizzato per indicare al template di mostrare le coordinate in formato decimale o sessagesimale. Se il parametro non viene compilato il template mostra le coordinate nello stesso formato utilizzato per compilarlo, altrimenti è possibile compilare il parametro format = in uno dei seguenti modi:
  • format = dec - in questo caso le coordinate verranno mostrate utilizzando i gradi decimali.
  • format = dms - in questo caso le coordinate verranno mostrate utilizzando i gradi sessagesimali (gradi, minuti, secondi).
• notes = questo parametro può essere compilato con il testo che verrà mostrato subito dopo le coordinate, può essere utilizzato per inserire delle note.
• prop = come comportamento predefinito il template legge le coordinate da Wikidata dalla proprietà coordinate geografiche (P625) dell'elemento collegato alla pagina in cui è utilizzato il template. Con il parametro "prop" è possibile specificare una proprietà della quale P625 sarà il qualificatore.
• latdec e longdec = per specificare la latitudine e longitudine decimale tramite parametri con nome invece che posizionali. Funzione utilizzata in particolare da quei template sinottici che usano sia le coordinate in formato sessagesimale che decimale, permettendo in questo modo di richiamare una sola volta il template coord con entrambi i formati (i parametri posizionali hanno la precedenza).

Il template permette di non inserire latitudine e longitudine e di ottenerne il valore da Wikidata.

La lettura da Wikidata è effettuata:

• quando il parametro display è valorizzato a "display=title" o "display=inline,title"

esempio: inserendo {{coord|format=dms|display=title}} in una voce, se le coordinate sono presenti su Wikidata, verranno visualizzate in formato dms in cima alla pagina accanto al titolo.

• con il parametro "from" (solo con display=inline)

esempio: {{coord|format=dms|from=Q220}} → 41°53′35″N 12°28′58″E41°53′35″N, 12°28′58″E, utilizzando Roma (Q220)

• con il parametro "prop"

esempio: {{coord|format=dms|prop=P159|from=Q67}} → 43°36′44″N 1°21′47″E43°36′44″N, 1°21′47″E, utilizzando sede legale (P159) e Airbus (Q67).

Il template inoltra ignora i primi parametri se lasciati vuoti, esempio: {{coord|||format=dms|display=title}}, per permettere ad altri template di usare in modo trasparente questa funzionalità. Per esempio un generico template infobox potrebbe contenere:

{{coord|{{{latitudine|}}}|{{{longitudine|}}}|format=dms|display=title}}

Se l'utente che compila l'infobox non valorizza latitudine e longitudine, si creeranno dei parametri vuoti, che il template coord ignorerà effettuando così la lettura da Wikidata.

Il template Coord è utilizzato come sottotemplate in numerosi template sinottici. Quando si utilizza in una voce uno di questi template sinottici, e il template è configurato opportunamente, esso legge automaticamente le coordinate dall'elemento Wikidata collegato, dalla proprietà coordinate geografiche (P625), senza quindi bisogno né di inserire il template Coord né di utilizzare i parametri di latitudine e longitudine del sinottico (questi ultimi possono servire solo nei rari casi in cui si vogliono specificare coordinate diverse da quelle di Wikidata).

Nel caso su Wikidata la proprietà P625 non fosse presente, è sufficiente crearla cliccando sul link "Aggiungi" al fondo dell'elenco delle proprietà, quindi specificando P625 e le coordinate nelle caselle di testo che compariranno. Rispetto all'inserimento su Wikipedia, si ha inoltre così il vantaggio che le coordinate possono essere inserite in qualunque formato e sono controllate prima del salvataggio, in quanto il form non permette di salvarle se inserite erroneamente.

Tutti i template sinottici basati su {{Coord}} e abilitati al contempo a leggere le coordinate da Wikidata sono categorizzati in Categoria:Template sinottici che leggono le coordinate da Wikidata.

• Categoria:P625 letta da Wikidata: vengono categorizzate in questa categoria le voci per cui non si sono inserite le coordinate e il valore è ottenuto da Wikidata
• Categoria:P625 uguale su Wikidata: anche quando le coordinate sono inserite, il template ne controlla l'esistenza su Wikidata. Vengono categorizzate in questa categoria le voci per cui sono state inserite le coordinate sia su Wikipedia che su Wikidata e su entrambi i progetti queste sono uguali.
• Categoria:P625 assente su Wikidata: se le coordinate non sono presenti su Wikidata la voce è categorizzata in questa categoria.

Le classi nel css globale geo, latitude e longitude sono usate per generare i microformat e non devono essere cambiate.

Gli eventuali errori di compilazione del template vengono mostrati in Categoria:Errori di compilazione del template Coord e accedendo a questo strumento^{[collegamento interrotto]}.

• Wisbot, il bot che si occupava di aggiornare i vecchi template e di importare le coordinate dalla Wikipedia inglese.
• Template:GeoTemplate
• Modulo:Coord, Modulo Lua che implementa le funzionalità del template Coord

• (EN) Google Earth Geographic Web Layer FAQ – Informazioni su come Google usa le informazioni sulle coordinate da Wikipedia.

Progetto Geografia

Progetto Template