View source for Template:Location/doc

{{Documentation subpage}}
{{TOCright}}
The family of templates used to geo-code Commons images. '''See [[Commons:Geocoding]] for info on how to find coordinated for your images.'''
*{{Tl|Location}}            – used to provide camera location using degrees/minutes/seconds (DMS) notation
*{{Tl|Location dec}}        – used to provide camera location using decimal notation
*{{Tl|Object location}}     – used to provide object location using DMS notation
*{{Tl|Object location dec}} – used to provide object location using decimal notation
*{{Tl|Globe location}}      - used to provide object location on other globes, like moon, mars, etc. Uses both decimal and DMS notations.
In most of the cases camera location is preferred and most of the images should use the first two templates. However in some cases object location, indicating position of the main subject of the photograph, makes more sense, for example when providing location of a painting or sheet music. It can also be used to point to a nearby feature when giving the location of a plant or animal where an exact location is not appropriate (eg where you do not want to reveal the exact location of a rare plant).

Those four templates output a [[:en:Geo_(microformat)|Geo_(microformat)]] and add images to either [[:Category:Media with locations]] or [[:Category:Media with erroneous locations]].

== Syntax ==
<code>
{{Tlx|Location|Degree|Minute|Second|Latitude|Degree|Minute<nowiki>|Second|Longitude|Information attributes</nowiki>}}<br>
{{Tlx|Location dec|Degree Latitude|Degree Longitude|Information attributes}}<br>
{{Tlx|Object location|Degree|Minute|Second|Latitude|Degree|Minute<nowiki>|Second|Longitude|Information attributes</nowiki>}}<br>
{{Tlx|Object location dec|Degree Latitude|Degree Longitude|Information attributes}}<br>
{{Tlx|Globe location|Degree Latitude|Degree Longitude|Globe|Information attributes}}<br>
{{Tlx|Globe location|Degree|Minute|Second|Latitude|Degree|Minute<nowiki>|Second|Longitude|Globe|Information attributes</nowiki>}}<br>
</code>

== Examples ==
<table class="wikitable" style="width:100%;">
 <caption>{{Tl|Location}} example</caption>
  <th>Code</th>
  <td><code>{{Tlx|Location|34|1|27.37|N|116|9<nowiki>|29.88|W|region:DE-NI_type:landmark_scale:10000_heading:SE</nowiki>}}</td>
 </tr><tr>
  <th>Produces</th>
  <td>{{Location|34|1|27.375|N|116|9|29.88|W|region:DE-NI_type:landmark_scale:10000_heading:SE}}</td>
 </tr>
</table>

<table class="wikitable" style="width:100%;">
 <caption>{{Tl|Location dec}} example</caption>
  <th>Code</th>
  <td><code>{{Tlx|Location dec|34.02427|-116.15830|region:DE-NI_type:landmark_scale:10000_heading:SW}}</td>
 </tr><tr>
  <th>Produces</th>
  <td>{{Location dec|34.02427|-116.15830|region:DE-NI_type:landmark_scale:10000_heading:SW}}</td>
 </tr>
</table>

<table class="wikitable" style="width:100%;">
 <caption>{{Tl|Object location dec}} example</caption>
  <th>Code</th>
  <td><code>{{Tlx|Object location dec|34.02427|-116.15830|region:DE-NI_type:landmark_scale:10000}}</td>
 </tr><tr>
  <th>Produces</th>
  <td>{{Object location dec|34.02427|-116.15830|region:DE-NI_type:landmark_scale:10000}}</td>
 </tr>
</table>

<table class="wikitable" style="width:100%;">
 <caption>{{Tl|Globe Location}} example</caption>
  <th>Code</th>
  <td><code>{{Tlx|Globe Location|34.02427|-116.15830|moon}}</td>
 </tr><tr>
  <th>Produces</th>
  <td>{{Globe Location|34.02427|-116.15830|moon}}</td>
 </tr>
  <th>Code</th>
  <td><code>{{Tlx|Globe location|34|1|27.37|N|116|9<nowiki>|29.88|W|mars</nowiki>}}</td>
 </tr><tr>
  <th>Produces</th>
  <td>{{Globe location|34|1|27.375|N|116|9|29.88|W|mars}}</td>
 </tr>
</table>

Note, that with above two templates, you should indicate camera position and not object position. To make clear what what was photographed add the <code>heading:xyz</code> parameter using degrees or direction acronyms as shown on the compass. See [[Commons:Geocoding#Parameters]] for more information.

Also note that the output of those two templates is identical despite of different inputs.

The syntax and output of {{tl|Object location}} and {{tl|Object location dec}} templates is the same, except for the word "Object" in the template name resulting in use of ''Object Location'' phrase instead of ''Camera Location'' in the output.

== Parameters ==
<table class="wikitable">
 <caption>{{Tl|Location}} and {{Tl|Object location}} parameters</caption>
 <th>Parameter</th>
 <th>Mandatory or Optional</th>
 <th>Default</th>
 <th>Description</th>
 <tr>
  <th>{1}</th>
  <td>Mandatory</td>
  <td>Undefined</td>
  <td>Degrees of Latitude</td>
 </tr>
 <tr>
  <th>{2}</th>
  <td>Mandatory</td>
  <td>Undefined</td>
  <td>Minutes of Latitude</td>
 </tr>
 <tr>
  <th>{3}</th>
  <td>Mandatory</td>
  <td>Undefined</td>
  <td>Seconds of Latitude</td>
 </tr>
 <tr>
  <th>{4}</th>
  <td>Mandatory</td>
  <td>Undefined</td>
  <td>Latitude Direction (N or S)</td>
 </tr>
 <tr>
  <th>{5}</th>
  <td>Mandatory</td>
  <td>Undefined</td>
  <td>Degrees of Longitude</td>
 </tr>
 <tr>
  <th>{6}</th>
  <td>Mandatory</td>
  <td>Undefined</td>
  <td>Minutes of Longitude</td>
 </tr>
 <tr>
  <th>{7}</th>
  <td>Mandatory</td>
  <td>Undefined</td>
  <td>Seconds of Longitude</td>
 </tr>
 <tr>
  <th>{8}</th>
  <td>Mandatory</td>
  <td>Undefined</td>
  <td>Longitude Direction (W or E)</td>
 </tr>
 <tr>
  <th>{9}</th>
  <td>Optional</td>
  <td>type:landmark</td>
  <td>region:XX-YYY_scale:_heading:</td>
 </tr>
</table>

<table class="wikitable">
 <caption>{{Tl|Location dec}} and {{Tl|Object location dec}} parameters</caption>
 <th>Parameter</th>
 <th>Mandatory or Optional</th>
 <th>Default</th>
 <th>Description</th>
 <tr>
  <th>{1}</th>
  <td>Mandatory</td>
  <td>Undefined</td>
  <td>Degrees of Latitude</td>
 </tr>
 <tr>
  <th>{2}</th>
  <td>Mandatory</td>
  <td>Undefined</td>
  <td>Degrees of Longitude</td>
 </tr>
 <tr>
  <th>{3}</th>
  <td>Optional</td>
  <td>type:landmark</td>
  <td>region:XX-YYY_scale:_heading:</td>
 </tr>
</table>

<table class="wikitable">
 <caption>{{Tl|Globe Location}} parameters</caption>
 <th>Parameter</th>
 <th>Mandatory or Optional</th>
 <th>Default</th>
 <th>Description</th>
 <tr>
  <th>{1}</th>
  <td>Mandatory</td>
  <td>Undefined</td>
  <td>Degrees of Latitude</td>
 </tr>
 <tr>
  <th>{2}</th>
  <td>Mandatory</td>
  <td>Undefined</td>
  <td>Degrees of Longitude</td>
 </tr>
 <tr>
  <th>{3}</th>
  <td>Mandatory</td>
  <td>Earth</td>
  <td>Globe - Supported types: Mars, Moon, Venus, Mercury, Titan, Ganymede</td>
 </tr>
 <tr>
  <th>{4}</th>
  <td>Optional</td>
  <td>type:landmark</td>
  <td>region:XX-YYY_scale:_heading:</td>
 </tr>
</table>
[[Image:Compass Card.png|thumb|right|Compass rose]]
Where:
*<code>'''region:'''XX-YYY</code>
:*<code>XX</code> is an [[:en:ISO 3166-1|ISO 3166-1]] alpha 2 country code abbreviation, and
:*<code>YYY</code> is a 2- or 3- characters [[:en:ISO 3166-2|ISO 3166-2]] province/region/state code abbreviation (typically the same as a local postal code abbreviation).

*<code>'''type:'''</code> is a class descriptor about the object. It is defined by geohack.php and mapsources.php on ToolServer.Org and corresponding documentation can be found on [[:en:WP:GEO]]. NOTE:  <code>type:landmark</code> is hard-coded default value
*<code>'''scale:'''</code> is an information about which range the image covers, given in meters (1000 is 1 kilometer)
*<code>'''heading:'''</code> is either a compass rose point (up to four letters) or degree heading (zeropoint North, clockwise).

== Translation ==
To create a new language version of all four templates, create a new subpage of [[:Template:Location]], cut and paste code below and translate terms in bold letters. For some languages it might also make sence to translate optional labels written in italics.
<code>
 <nowiki>{{Location/layout</nowiki> <br>
 | lat             = {{{lat}}} <br>
 | lon             = {{{lon}}} <br>
 | attributes      = {{{attributes}}} <br>
 | NoError         = {{{NoError}}} <br>
 | mode            = {{{mode}}} <br>
 | globe           = {{{globe|Earth}}} <br>
 | lang            = <nowiki>{{subst:SUBPAGENAME}}</nowiki> <br>
 | Location-label3 = '''Location on''' <nowiki>{{#switch: {{{globe|Earth}}}</nowiki> 
   | Mars = '''Mars''' | Moon = '''Moon''' | Venus = '''Venus''' | Mercury = '''Mercury'''  <br>
   | Titan = '''Titan''' | Ganymede = '''Ganymede''' | Earth = '''Earth'''}} <br>
 | Location-label1 = '''Camera Location''' <br>
 | Location-label2 = '''Object Location''' <br>
 | Link-label      = '''This and other images at their location on:''' <br>
 | GoogleMaps      = ''Google Maps''   <!-- Optional: use if different from English name --> <br>
 | GoogleEarth     = ''Google Earth''  <!-- Optional: use if different from English name --> <br>
 | OpenStreetMap   = ''OpenStreetMap'' <!-- Optional: use if different from English name --> <br>
 | Proximityrama   = ''Proximityrama'' <!-- Optional: use if different from English name --> <br>
 | Info-label      = ''Info''          <!-- Optional: use if different from English name --> <br>
 | N               = ''N''             <!-- Optional Abbriviation for ''North'' to be used --> <br>
 | S               = ''S''             <!-- Optional Abbriviation for ''South'' to be used --> <br>
 | W               = ''W''             <!-- Optional Abbriviation for ''West'' to be used --> <br>
 | E               = ''E''             <!-- Optional Abbriviation for ''East'' to be used --> <br>
 }}<nowiki><noinclude>{{translated tag|infobox}}</noinclude></nowiki>
</code>


== See also ==
*{{tl|Location-Panorama}}
*{{tl|Location map notice}}
*{{tl|Location possible}}, mark pictures without defined location
*{{tl|LocationRequired}}

<includeonly>
[[af:Sjabloon:Coord]]
[[ar:قالب:كوورد]]
[[be-x-old:Шаблён:Каардынаты]]
[[bg:Шаблон:Coord]]
[[bs:Template:coord]]
[[ca:Template:Coord]]
[[cs:Šablona:Geo dms]]
[[en:Template:Coord]]
[[es:Plantilla:Coord]]
[[eo:Ŝablono:Koord]]
[[fr:Modèle:Coord]]
[[fur:Model:Coord]]
[[hsb:Předłoha:Koord]]
[[ia:Patrono:Coord]]
[[it:Template:Coord]]
[[ja:Template:Coord]]
[[no:Mal:Koordinater]]
[[pl:Szablon:Koordynaty]]
[[pt:Predefinição:Coord]]
[[ro:Format:Coord]]
[[ru:Template:Coord]]
[[simple:Template:Coord]]
[[sl:Predloga:Koord]]
[[sv:Mall:Coord]]
[[uk:Шаблон:Координати]]
[[vo:Samafomot:Coord]]
[[zh:Template:Coord]]
</includeonly>