Template:Coord/doc: Difference between revisions

{{shortcut|WP:COORD}}  

== Quick guide ==

{{coord how-to}}  

__TOC__  

== Purpose ==

{{Tld|Coord}} provides a standard notation for encoding locations by their [[Latitude]] and [[Longitude]] coordinates. It is primarily for specifying the [[World Geodetic System|WGS84]] geographic coordinates of locations on [[Earth]]. However, it can also encode locations on natural satellites, dwarf planets, and planets other than Earth.  

*To specify celestial coordinates, use {{tl|sky}} instead.

*If the subject's location is truly unknown or disputed, note this with {{tl|coord unknown}}.

See also [[wikipedia:WikiProject Geographical coordinates|RTENOTITLE]].  

Latitude and longitude may be specified (with appropriate precision) either in decimal notation or as degrees/minutes/seconds. By default, coordinates appear in the format used to specify them. However, the <code>format=</code> parameter can be used to force display in a particular format.  

The template displays the formatted coordinates with a [[Hyperlink]] to [[Tswiki:GeoHack|GeoHack]]. GeoHack displays information customized to the location, including links to external mapping services.  

For [[Terrestrial]] locations, a blue globe ([[Image:Erioll world.svg|18px]]) appears to the left of the hyperlink. Clicking on the globe activates the [[:meta:WikiMiniAtlas|WikiMiniAtlas]] (requires [[JavaScript]]).  

By default, coordinates appear "in line" with the adjacent text. However, the <code>display=</code> parameter can be used to move the coordinates up near the page title—or display them in both places at once.  

The template outputs coordinates in three formats:

*Degree/minutes/seconds ("DMS", precision is degrees, or degrees/minutes, or degrees/minutes/seconds, based on input precision).  

*Decimal degrees (varying the number of decimal places based on input precision)

*[[Geo (microformat)|Geo microformat]].

== Caveats ==

The template '''must not''' be modified without prior discussion.  

Tools which read Wikipedia database dumps (such as [[Google Earth]]) often ignore inline coordinates. To ensure that coordinates are seen by these tools, one set should be displayed in the title. See [http://earth.google.com/userguide/v4/geoweb_faq.html How do I get my Wikipedia article to show up in the Google Earth Geographic Web layer?]. However, if multiple title coordinates appear on a single page, they will overlap, making them illegible.

== Superseded templates ==

This single template supersedes {{tl|coor d}}, (and others in that family which have since been redirected to it), plus the [{{fullurl:Special:PrefixIndex|from=Geolinks&amp;namespace=10}} Geolinks] and [{{fullurl:Special:PrefixIndex|from=Mapit&amp;namespace=10}} Mapit] templates. Most parameters can be used as before – see [[#Usage|Usage]].  

== Usage ==

'''{{coord|'''''latitude'''''|'''''longitude'''''|'''''[[#1|coordinate parameters]]'''''|'''''[[#2|template parameters]]'''''}}'''

There are two kinds of parameters, all optional:  

*<span id="1">'''Coordinate parameters'''</span> are parameters that {{tl|Coord}} passes to the map server. These have the format ''parameter:value'' and are separated from each other by the underscore character ( _ ). The supported coordinate parameters are ''dim:'', ''globe:'', ''region:'', ''scale:'', ''source:'', and ''type:''. See [[#Coordinate_parameters|coordinate parameters]] for details and examples.

*<span id="2">'''Template parameters'''</span> are parameters used by the {{tl|Coord}} template. These have format ''parameter=value'' and are separated from each other by the pipe character ( | ). The supported template parameters are ''display='', ''format='', ''name='', and ''notes=''.

 

:*'''display=''' can be one of the following:

::*<code>display=inline</code> – Display the coordinate inline (default)

::*<code>display=title</code> – Display the coordinate near the article title (replaces {{tl|coor title dms}} family)

::**shortcut: <code>display=t</code>

::*<code>display=inline,title</code> – Display the coordinate both inline and at title (replaces {{tl|coor at dms}} family)

::**shortcut: <code>display=it</code>

::*<code>display=title,inline</code> has the same effect as <code>display=inline,title</code>

::*<code>format=dms</code> reformats the coordinates to <span style="text-decoration: underline">degrees | minutes | seconds</span> format.

:*'''name=''' can be used to annotate inline coordinates for display in map services such as the [[:meta:WikiMiniAtlas|WikiMiniAtlas]]. If omitted, the article title (PAGENAME) is assumed.

::Note: a ''name='' parameter causes {{tl|Coord}} to emit an [[HCard]] [[Microformat]] using that name, ''even if used within an existing hCard''. Do not use when the name is that of a person (e.g for a gravesite), as the generated hCard would be invalid. Also, do not use square brackets in names.

 

 

{| class="wikitable FCK__ShowTableBorders"

| <code><nowiki>{{coord|43.65|-79.38}}</nowiki></code>  

| {{coord|43.65|-79.38}}  

| <code><nowiki>{{coord|43.6500|-79.3800}}</nowiki></code>  

| {{coord|43.6500|-79.3800}}  

| <code><nowiki>{{coord|43.651234|N|79.383333|W}}</nowiki></code>  

| {{coord|43.651234|N|79.383333|W}}  

| Toronto – decimal with Northing &amp; Westing

| <code><nowiki>{{coord|43|29|N|79|23|W}}</nowiki></code>  

| {{coord|43|29|N|79|23|W}}  

| Toronto – degrees &amp; minutes

| <code><nowiki>{{coord|43|29|4|N|79|23|0|W}}</nowiki></code>  

| {{coord|43|29|4|N|79|23|0|W}}  

| Toronto – degrees, minutes &amp; seconds

| <code><nowiki>{{coord|43|29|4.5|N|79|23|0.5|W}}</nowiki></code>  

| {{coord|43|29|4.5|N|79|23|0.5|W}}  

| Toronto – degrees, minutes, seconds &amp; fractions of seconds

| <code><nowiki>{{coord|55.752222|N|37.615556|E}}</nowiki></code>  

| {{coord|55.752222|N|37.615556|E}}  

| Moscow – N &amp; E

| <code><nowiki>{{coord|55.752222|N|37.615556|E|format=dms}}</nowiki></code>  

| {{coord|55.752222|N|37.615556|E|format=dms}}  

| <code><nowiki>{{coord|39.098095|-94.587307|format=dms}}</nowiki></code>  

| {{coord|39.098095|-94.587307|format=dms}}  

| <code><nowiki>{{coord|55.752222|N|37.615556|E|format=dec|name=Moscow}}</nowiki></code>  

| {{coord|55.752222|N|37.615556|E|format=dec|name=Moscow}}  

| <code><nowiki>{{coord|33|55|S|18|25|E}}</nowiki></code>  

| {{coord|33|55|S|18|25|E}}  

| Cape Town – S &amp; E

| <code><nowiki>{{coord|35|00|N|105|00|E}}</nowiki></code>  

| {{coord|35|00|N|105|00|E}}  

| <code><nowiki>{{coord|22|54|30|S|43|14|37|W}}</nowiki></code>  

| {{coord|22|54|30|S|43|14|37|W}}  

| Rio – S &amp; W

| <code><nowiki>{{coord|22|S|43|W}}</nowiki></code>  

| {{coord|22|S|43|W}}  

| <code><nowiki>{{coord|52|28|N|1|55|W|notes=<ref>{{cite web|url=http://www.fallingrain.com/world/UK/0/Birmingham.html|title=Birmingham}}</ref>|display=inline,title|region:GB_type:city}}</nowiki></code>  

| {{coord|52|28|N|1|55|W|notes=<REF>{{cite web|url=http://www.fallingrain.com/world/UK/0/Birmingham.html|title=Birmingham}}</REF>|display=inline,title|region:GB_type:city}}  

=== References ===

== Coordinate parameters  ==

The first unnamed parameter following the longitude is an optional string of coordinate parameters, separated by underscores. These parameters help [[Tswiki:GeoHack|GeoHack]] select suitable map resources, and they will become more important when [[Meta:Wikimaps|Wikimaps]] becomes fully functional.

===== type:''T'' =====

{{Wikipedia:WikiProject Geographical coordinates/type:}}  

===== scale:''N'' =====

{{Wikipedia:WikiProject Geographical coordinates/scale:}}  

===== dim:''D'' =====

{{Coord-doc-dim}}  

===== region:''R'' =====

{{Wikipedia:WikiProject Geographical coordinates/region:}}  

===== globe:''G'' =====

{{Wikipedia:WikiProject Geographical coordinates/globe:}}  

===== source:''S''  =====

{{Coord-doc-source}}  

== Per-user display customization ==

{{UF-coord-classes}}

The template has some input checks built in. Most errors display a <font color="#ff0000">'''bold, red'''</font> message inline and categorize the article in the [[wikipedia:Hidden category|hidden]] [[wikipedia:Categorization|maintenance category]] '''[[:Category:Coord template needing repair|Coord template needing repair]]'''. There is/are currently '''{{PAGESINCATEGORY:Coord_template_needing_repair}}''' page(s) in that category. See the category description for further instructions.  

A daily report of coordinates needing repair is at [[Tools:~dispenser/view/File viewer#log:coord-enwiki.log]].

 

 

 

 

 

=== Coordinates in PDF ===

 

For generating PDF, printed books, and Open Office export format, two templates are [[Help:Books/for experts#Improving_the_book_layout|substituted for the regular templates]]:  

 

*[[Template:Coord/display/title/Print]] for {{tl|Coord/display/title}}  

*[[Template:Coord/link/Print]] for {{tl|Coord/link}}  

Samples are available at:  

 

*[[Help:Books/Feedback/Tests/coord 1]]  

=== Class names ===

The class names '''geo''', '''latitude''' and '''longitude''' are used to generate the microformat and '''MUST NOT''' be changed. <includeonly>

 

[[Category:Coord_template]]