Vire surgente 'e Modello:Coord/man

'''Coord''' è un [[Aiuto:Template|template]] che produce un collegamento a una lista di servizi che forniscono mappe geografiche relative alle coordinate specificate, ad esempio [[Google Maps]]. Inoltre fornisce una standardizzazione della notazione delle coordinate. Il link appare nel punto in cui è inserito il template e/o in alto a destra, come visibile in questa stessa pagina. 

Il globo azzurro a sinistra del link attiva il [[:meta:WikiMiniAtlas/it|WikiMiniAtlas]]; il link "(Mappa)" a destra delle coordinate attiva una mappa [[OpenStreetMap]]. Queste due funzioni richiedono un browser con Javascript abilitato.

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

La pagina che genera la lista di servizi di mappe è {{Coor URL}}43;13_type:country. Il sistema che genera questa pagina è {{en}}[https://wiki.toolserver.org/view/GeoHack Geohack], secondo il formato stabilito da [[Template:GeoTemplate]].

Il template può fornire le coordinate in formato:
* Gradi/minuti/secondi ("DMS", con precisione al grado, al minuto o al secondo, a seconda dell'input)
* Decimale (con precisione data dal numero di decimali inseriti)
* In microformato [[Geo (microformat)|Geo]].

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 [http://earth.google.com/userguide/v4/geoweb_faq.html Come posso visualizzare una voce di Wikipedia nel livello Geographic Web di Google Earth?]).

== Uso ==
 &#123;{coord|''latitudine''|''longitudine''|''parametri coordinate''|''parametri template''}&#125;

 &#123;{coord|''dd''|''N/S''|''dd''|''E/W''|''parametri coordinate''|''parametri template''}&#125;
 &#123;{coord|''dd''|''mm''|''N/S''|''dd''|''mm''|''E/W''|''parametri coordinate''|''parametri template''}&#125;
 &#123;{coord|''dd''|''mm''|''ss''|''N/S''|''dd''|''mm''|''ss''|''E/W''|''parametri coordinate''|''parametri template''}&#125;

;''latitudine'' e ''longitudine''
:Si possono inserire come gradi decimali (primo esempio) oppure come sessagesimali: gradi, minuti e secondi (esempi successivi). 
:Se inserite come sessagesinali, i minuti e i secondi sono opzionali, ma è necessario indicare le iniziali degli emisferi, utilizzando W per l'ovest.
:Se inserite come valori decimali è necessario utilizzare il punto come separatore decimale. Per convertire un valore in gradi, minuti e secondi in uno in gradi decimali usare la seguente formula: 
:<math>\text{gradi decimali} = \text{gradi} + \frac{\text{minuti}}{60} + \frac{\text{secondi}}{3600}</math>
:Si usano valori positivi per latitudine nord e longitudine est, negativi per latitudine sud e longitudine ovest.

;''parametri coordinate'' 
:Sono parametri (tutti opzionali) riconosciuti dal server delle mappe, per esempio <code>type:city</code> e <code>type:landmark</code>.<br />Quelli riconosciuti dal server sono dim:, globe:, region:, scale:, source:, e type:. Vanno inseriti nella forma ''parametro:valore'' (non quindi utilizzando il segno di uguale =).<br />Se si inserisce più di un parametro di questo tipo, i paramentri devono essere riuniti tra loro, senza che ci sia una barra verticale tra loro, ma devono essere invece separati da un [[Trattino basso|carattere di trattino basso ("_")]] come ad esempio <code>|type:city_region:IT|</code>.<br /> Usando il parametro ''scale'' il valore 1000 corrisponde al massimo ingrandimento disponibile su [[Google Maps]], ma questo spesso non è disponibile per le immagini relative all'Italia che normalmente sono disponibili in scala 1:2000. Per informazioni sui questi parametri vedi {{en}}[https://wiki.toolserver.org/view/GeoHack#params la pagina di GeoHack] e la sezione specifica della {{en}}[[:en:Template:Coord/doc#Coordinate_parameters|documentazione in inglese]] di questo template.

;''parametri template''
:Sono parametri (tutti opzionali) che seguono la normale sintassi ''parametro=valore'' e la separazione tramite barra verticale ( | ). 

:* '''''display''''' può essere uno dei seguenti:
:** <code>inline</code> (default): mostra le coordinate in linea, laddove viene inserito il template;
:** <code>title</code>: mostra le coordinate nel titolo della voce, in alto a destra;
:** <code>inline,title</code>: mostra le coordinate sia in linea sia nel titolo.
:Nota: usando l'attributo <code>title</code> si indica che le coordinate si riferiscono all'intera voce e non solo ai luoghi (più di uno) citati nella voce; quindi è meglio non usarlo nell'ultimo caso. Questo parametro è usato da servizi come Google Earth.
:* '''''format''''' stabilisce se le coordinate vanno mostrate in formato decimale o sessagesimale, se non specificato vengono mostrare così come sono state inserite:
:** <code>dms</code>: visualizzazione sessagesimale
:** <code>dec</code>: visualizzazione decimale
:* '''''name''''' stabilisce l'etichetta che viene mostrata sulle mappe, ad es. sul WikiMiniAtlas, in corrispondenza del punto; se non specificato viene usato il titolo della pagina.

==Personalizzare la visualizzazione==

Per default le coordinate sono specificate nel formato in cui sono specificate in input. Gli utenti registrati possono personalizzare questo comportamento se desiderano che siano sempre visualizzate in un certo modo.

Per visualizzare le coordinate sempre nel formato DMS, aggiungere al proprio [[Speciale:Mypage/monobook.css|monobook.css]]:
:<code>.geo-default { display: inline } .geo-nondefault { display: inline } <br />.geo-dec { display: none }   .geo-dms { display: inline }</code>

Per visualizzare sempre le coordinate come valori decimali, aggiungere al proprio [[Speciale:Mypage/monobook.css|monobook.css]]:
:<code>.geo-default { display: inline } .geo-nondefault { display: inline }<br />.geo-dec { display: inline } .geo-dms { display: none }</code>

Per visualizzare le coordinate nei due formati, aggiungere al proprio [[Speciale:Mypage/monobook.css|monobook.css]]:
:<code>.geo-default { display: inline } .geo-nondefault { display: inline }<br />.geo-dec { display: inline }   .geo-dms { display: inline }<br />.geo-multi-punct { display: inline }</code>

== Esempi ==
(Ci sono dei geo-microformat e potrebbero essere trovati in questa pagina da un analizzatore)
{| {{prettytable}}
|-
|<tt><nowiki>{{coord|43.651234|-79.383333}}</nowiki></tt>||{{coord|43.651234|-79.383333}}||Toronto - Tutti i decimali - N & W 
|-
|<tt><nowiki>{{coord|43.65|-79.38}}</nowiki></tt>||{{coord|43.65|-79.38}}||Toronto - meno preciso
|-
|<tt><nowiki>{{coord|43.6500|-79.3800}}</nowiki></tt>||{{coord|43.6500|-79.3800}}||Toronto - media precisione con gli zeri
|-
|<tt><nowiki>{{coord|43.651234|N|79.383333|W}}</nowiki></tt>||{{coord|43.651234|N|79.383333|W}}||Toronto - decimale con Nord e Ovest
|-
|<tt><nowiki>{{coord|43|29|N|79|23|W}}</nowiki></tt>||{{coord|43|29|N|79|23|W}}||Toronto - gradi e minuti
|-
|<tt><nowiki>{{coord|43|29|4|N|79|23|0|W}}</nowiki></tt>||{{coord|43|29|4|N|79|23|0|W}}||Toronto - gradi, minuti e secondi
|-
|<tt><nowiki>{{coord|55.752222|N|37.615556|E}}</nowiki></tt>||{{coord|55.752222|N|37.615556|E}}||Mosca - N & E
|-
|<tt><nowiki>{{coord|55.752222|N|37.615556|E|format=dms}}</nowiki></tt>||{{coord|55.752222|N|37.615556|E|format=dms}}||
|-
|<tt><nowiki>{{coord|55.752222|N|37.615556|E|format=dec}}</nowiki></tt>||{{coord|55.752222|N|37.615556|E|format=dec}}||
|-
|<tt><nowiki>{{coord|33|55|S|18|25|E}}</nowiki></tt>||{{coord|33|55|S|18|25|E}}||Capetown - S & E
|-
|<tt><nowiki>{{coord|22|54|30|S|43|14|37|W}}</nowiki></tt>||{{coord|22|54|30|S|43|14|37|W}}||Rio - S & W
|-
|<tt><nowiki>{{coord|22|S|43|W}}</nowiki></tt>||{{coord|22|S|43|W}}||Un [[Degree Confluence Project|degree confluence]]
|-
|<tt><nowiki>{{coord|52|28|59|N|1|53|37|W|display=inline,title|region:GB_type:city}}</nowiki></tt>
|{{coord|52|28|59|N|1|53|37|W|display=inline,title|region:GB_type:city}}||Birmingham - con i parametri display, notare il [[Birmingham|titolo di questa pagina]] in alto a destra.
|}

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

==Sottotemplate==
I seguenti template:
:{{tl|Coord/input/dec}}
:{{tl|Coord/input/d}}
:{{tl|Coord/input/dm}}
:{{tl|Coord/input/dms}}
:{{tl|Coord/input/ERROR}}

:{{tl|Coord/display/inline}}
:{{tl|Coord/display/title}}
:{{tl|Coord/display/inline,title}}

sono "subroutine" di {{tl|Coord}}. La loro separazione consente al template &#123;{Coord}&#125; di includere solo quelli necessari, riducendo drasticamente la dimensione pre-espansione. Non dovrebbero essere usati direttamente.

== Pagine correlate ==
* [[Utente:Wisbot|Wisbot]], il [[Wikipedia:Bot|bot]] che si occupava di aggiornare i vecchi template e di importare le coordinate dalla wikipedia inglese.

== Collegamenti esterni ==
* {{en}} [http://earth.google.com/userguide/v4/geoweb_faq.html Google Earth Geographic Web Layer FAQ] – Informazioni su come Google usa le informazioni sulle coordinate da Wikipedia.

{{progetto|geografia|template}}

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