Difference between revisions of "Template:Inline coordinates/doc"
(deprecated) |
m (1 revision) |
(No difference)
|
Latest revision as of 19:04, 1 July 2010
Contents
Purpose
{{Inline coordinates}} provides a standard notation for encoding locations by their latitude and longitude coordinates. It is primarily for specifying the WGS84 geographic coordinates of locations on Earth. However, it can also encode locations on natural satellites, dwarf planets, and planets other than Earth.
Features
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 format=
parameter can be used to force display in a particular format.
The template displays the formatted coordinates with a hyperlink to GeoHack. GeoHack displays information customized to the location, including links to external mapping services.
For terrestrial locations, a blue globe (18px) appears to the left of the hyperlink. Clicking on the globe activates the WikiMiniAtlas (requires JavaScript).
By default, coordinates appear "in line" with the adjacent text. Use {{location}} for other work.
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.
Usage
{{inline coordinates|latitude|longitude|coordinate parameters|template parameters}} {{inline coordinates|dd|N/S|dd|E/W|coordinate parameters|template parameters}} {{inline coordinates|dd|mm|N/S|dd|mm|E/W|coordinate parameters|template parameters}} {{inline coordinates|dd|mm|ss|N/S|dd|mm|ss|E/W|coordinate parameters|template parameters}}
There are two kinds of parameters, all optional:
- Coordinate parameters are parameters that {{Inline coordinates}} 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 for details and examples.
- Template parameters are parameters used by the {{Inline coordinates}} template. These have format parameter=value and are separated from each other by the pipe character ( | ). The supported template parameters are format=, name=, and notes=.
- format= can be used to force dec or dms coordinate display.
-
format=dec
reformats the coordinates to decimal degrees format. -
format=dms
reformats the coordinates to degrees | minutes | seconds format.
-
- name= can be used to annotate inline coordinates for display in map services such as the WikiMiniAtlas. If omitted, the article title (PAGENAME) is assumed.
- Note: a name= parameter causes {{Inline coordinates}} 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.
- notes= specifies text to be displayed immediately following the coordinates. This is primarily intended for adding footnotes to title coordinates.
Examples
{{Inline coordinates|43.651234|-79.383333}}
|
43°39′04″N 79°23′00″W / 43.651234°N 79.383333°W | Toronto – Fully decimal – N & W |
{{Inline coordinates|43.65|-79.38}}
|
43°39′N 79°23′W / 43.65°N 79.38°W | Toronto – less precise |
{{Inline coordinates|43.6500|-79.3800}}
|
43°39′00″N 79°22′48″W / 43.6500°N 79.3800°W | Toronto – medium precision with trailing zeroes |
{{Inline coordinates|43.651234|N|79.383333|W}}
|
43°39′04″N 79°23′00″W / 43.651234°N 79.383333°W | Toronto – decimal with Northing & Westing |
{{Inline coordinates|43|29|N|79|23|W}}
|
43°29′N 79°23′W / 43.483°N 79.383°W | Toronto – degrees & minutes |
{{Inline coordinates|43|29|4|N|79|23|0|W}}
|
43°29′4″N 79°23′0″W / 43.48444°N 79.383333°W | Toronto – degrees, minutes & seconds |
{{Inline coordinates|43|29|4.5|N|79|23|0.5|W}}
|
43°29′4.5″N 79°23′0.5″W / 43.484583°N 79.383472°W | Toronto – degrees, minutes, seconds & fractions of seconds |
{{Inline coordinates|55.752222|N|37.615556|E}}
|
55°45′08″N 37°36′56″E / 55.752222°N 37.615556°E | Moscow – N & E |
{{Inline coordinates|55.752222|N|37.615556|E|format=dms}}
|
55°45′08″N 37°36′56″E / 55.752222°N 37.615556°E | Convert to dms format |
{{Inline coordinates|39.098095|-94.587307|format=dms}}
|
39°05′53″N 94°35′14″W / 39.098095°N 94.587307°W | Decimal conversion without N/S/E/W |
{{Inline coordinates|55.752222|N|37.615556|E|format=dec|name=Moscow}}
|
55°45′08″N 37°36′56″E / 55.752222°N 37.615556°E | Convert to decimal and label on some maps |
{{Inline coordinates|33|55|S|18|25|E}}
|
33°55′S 18°25′E / 33.917°S 18.417°E | Cape Town – S & E |
{{Inline coordinates|35|00|N|105|00|E}}
|
35°00′N 105°00′E / 35°N 105°E | People's Republic of China |
{{Inline coordinates|22|54|30|S|43|14|37|W}}
|
22°54′30″S 43°14′37″W / 22.90833°S 43.24361°W | Rio – S & W |
{{Inline coordinates|22|S|43|W}}
|
22°S 43°W / 22°S 43°W | A degree confluence. |
References
Cite error: Invalid <references>
tag;
parameter "group" is allowed only.
<references />
, or <references group="..." />
Coordinate parameters
The first unnamed parameter following the longitude is an optional string of coordinate parameters, separated by underscores. These parameters help GeoHack select suitable map resources, and they will become more important when Wikimaps becomes fully functional.
type:T
EWikipedia:WikiProject Geographical coordinates/type:
scale:N
{{Wikipedia:WikiProject Geographical coordinates/scale:}}
dim:D
The dim:
parameter defines the diameter of a viewing circle centered on the coordinate. While the default unit of measurement is metres, the km
suffix may be appended to indicate kilometres.
GeoHack uses dim:
to select a map scale such that the viewing circle appears roughly 10 centimetres (4 in) in diameter on a 72 dpi computer monitor. If no dim:
, type:
, or scale:
parameters are provided, GeoHack uses its default viewing circle of 30 kilometres (19 mi).
Subject | View diameter | Markup | Result |
---|---|---|---|
Western Hemisphere | 10,000 kilometres (6,200 mi) | {{Inline coordinates|0|N|90|W|dim:10000km}} | 0°N 90°W / 0°N 90°W |
Ohio | 400 kilometres (250 mi) | {{Inline coordinates|40.5|-82.5|dim:400km}} | 40°30′N 82°30′W / 40.5°N 82.5°W |
Dresden | 20,000 metres (12 mi) | {{Inline coordinates|51.033|13.73|dim:20000}} | 51°01′59″N 13°43′48″E / 51.033°N 13.73°E |
Statue of Liberty | 100 metres (330 ft) | {{Inline coordinates|40.6892|-74.0445|dim:100}} | 40°41′21″N 74°02′40″W / 40.6892°N 74.0445°W |
region:R
{{Wikipedia:WikiProject Geographical coordinates/region:}}
globe:G
{{Wikipedia:WikiProject Geographical coordinates/globe:}}
source:S
Per-user display customization
Incorrect uses and maintenance category
The template has some input checks built in. Most errors display a bold, red message inline and categorize the article in the hidden maintenance category Coord template needing repair. There is/are currently 0 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.
See also: WT:GEO#To do
Internals
See Template:Coord/doc/internals and Category:Coord template.
Class names
The class names geo, latitude and longitude are used to generate the microformat and MUST NOT be changed.