Template:Coord/man

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.

Caratteristiche

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.

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

Uso

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.

Parametri

Coordinate

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.

Parametri coordinate

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:

type:

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:

type:	Descrizione	Scala
adm1st	unità amministrativa di primo livello	1:1 000 000
adm2nd	unità amministrativa di secondo livello	1:300 000
adm3rd	unità amministrativa di terzo livello	1:100 000
airport	aeroporti	1:30 000
city(pop)	città, paesi, frazioni, quartieri, villaggi, centri abitati e tutti i luoghi abitati. Se si conosce il numero di abitanti del luogo indicarlo tra parentesi al posto di pop, senza spazi e senza separatori (attualmente, dicembre 2013, NON funzionante)	1:30 000 ... 1:300 000
city	città, paesi, frazioni, quartieri, villaggi, centri abitati e tutti i luoghi abitati dei i quali non si conosce il numero di abitanti	1:100 000
country	stati	1:10 000 000
edu	scuole e università	1:10 000
event	eventi regolari o occasionali e incidenti che avvengono in un luogo specifico, incluse battaglie, terremoti, fiere e naufragi	1:50 000
forest	boschi e foreste	1:50 000
glacier	ghiacciai	1:50 000
isle	isole	1:100 000
landmark	edifici (inclusi: chiese, fabbriche, musei, teatri e centrali elettriche, ma escluse scuole, aeroporti e stazioni di treni), cave, cimiteri, faglie geologiche, luoghi turistici, promontori, miniere, incroci stradali, strade, strutture architettoniche (inclusi: antenne, ponti, castelli, dighe, fari, monumenti e stadi), valli e altri punti di interesse	1:10 000
mountain	montagne, picchi, catene montuose, colline, scogliere sommerse e monti sottomarini	1:100 000
pass	passi di montagna	1:10 000
railwaystation	stazioni, fermate e aree di manutenzioni di treni e ferrovie, inclusi binari, metropolitane, funicolari, ferrovie sopraelevate, ecc.	1:10 000
river	fiumi, canali, ruscelli, torrenti	1:100 000
satellite	satelliti geostazionari	1:10 000 000
waterbody	laghi, baie, estuari, cascate... ogni tipo di massa d'acqua interna	1:100 000
camera	luogo dove è stata scattata una foto	1:10 000
	Scala di default: utilizzata quando il parametro type: non è stato compilato oppure è stato compilato con un valore non riconosciuto dall'estensione GeoHack. La scala di default varia a seconda se sono stati indicati solo i gradi, gradi e primi, o gradi primi e secondi.	gms 1:10 000 gm 1:100 000 g 1:300 000

dim:

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.

scale:

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

region:

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.

globe:

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:

• mercury → Mercurio
• venus → Venere
• moon → Luna
• mars → Marte
• phobos → Fobos
• deimos → Deimos
• ceres → Cerere
• vesta → 4 Vesta
• ganymede → Ganimede
• callisto → Callisto
• io → Io
• europa → Europa
• mimas → Mimas
• enceladus → Encelado
• tethys → Teti
• dione → Dione
• rhea → Rea
• titan → Titano
• hyperion → Iperione
• iapetus → Giapeto
• pheobe → Febe
• miranda → Miranda
• ariel → Ariel
• umbriel → Umbriel
• titania → Titania
• oberon → Oberon
• triton → Tritone
• pluto → Plutone

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.

Parametri template

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).

Wikidata

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 Rome (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.

Template basati su Coord

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.

Categorie

• 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.

Esempi d'uso

{{coord|43.651234|-79.383333}}	43.651234°N 79.383333°W43°39′04.44″N, 79°23′00″W	Coordinate inserite in formato decimale.
{{coord|43.651234|N|79.383333|W}}	43°39′04.44″N 79°23′00″W43°39′04.44″N, 79°23′00″W	Coordinate inserite in formato decimale, indicando il quadrante a cui si riferiscono.
{{coord|43|29|4|N|79|23|0|W}}	43°29′04″N 79°23′00″W43°29′04″N, 79°23′00″W	Coordinate inserite in formato sessagesimale con precisione al secondo.
{{coord|43|29|N|79|23|W}}	43°29′N 79°23′W43°29′N, 79°23′W	Coordinate inserite in formato sessagesimale con precisione al minuto.
{{coord|43|N|79|W}}	43°N 79°W43°N, 79°W	Coordinate inserite in formato sessagesimale con precisione al grado.
{{coord|55.752222|N|37.615556|E|format=dms}}	55°45′08″N 37°36′56″E55°45′08″N, 37°36′56″E	Coordinate inserite in formato decimale e mostrate in formato sessagesimale.
{{coord|33|55|S|18|25|E|format=dec}}	33.916667°S 18.416667°E33°55′S, 18°25′E	Coordinate inserite in formato sessagesimale e mostrate in formato decimale.
{{coord|22|54|30|S|43|14|37|W|type:city_region:BR}}	22°54′30″S 43°14′37″W22°54′30″S, 43°14′37″W	Coordinate inserite indicando il tipo di oggetto (città → city) e la regione in cui si trova (Brasile → BR).
{{coord|22|54|30|S|43|14|37|W|type:city_region:BR|name=Rio de Janeiro}}	22°54′30″S 43°14′37″W22°54′30″S, 43°14′37″W (Rio de Janeiro)	Coordinate inserite indicando il tipo di oggetto (città → city), la regione in cui si trova (Brasile → BR) e il nome dell'oggetto a cui le coordinate si riferiscono (Rio de Janeiro).
{{coord|52|28|59|N|1|53|37|W|region:GB_type:city|display=inline,title}}	52°28′59″N 1°53′37″W52°28′59″N, 1°53′37″W	Coordinate mostrate sia dove è stato inserito il template sia accanto al titolo (notare le coordinate che si trovano in cima a questa voce)
{{coord|52|28|59|N|1|53|37|W|region:GB_type:city|display=inline|notes=(nota)}}	52°28′59″N 1°53′37″W52°28′59″N, 1°53′37″W(nota)	Coordinate con una nota

Nomi delle classi

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

Errori del template

Gli eventuali errori di compilazione del template vengono mostrati in Categoria:Errori di compilazione del template Coord e accedendo a questo strumento .

Pagine correlate

• 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

Collegamenti esterni

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