Template:Location/doc

Syntax #1: decimal degrees

This subpage contains documentation, categories, or other content that is not part of the template.
To view the template page itself, see Template:Location.

---

Template used for geocoding Commons images, providing camera location using decimal or degrees/minutes/seconds (DMS) syntax. See Commons:Geocoding for more information.

{{Location}} is the main template of the {{Location}}, {{Object location}} and {{Globe location}} family and is supposed to be used to define the coordinates and heading of the location of the camera.

The template automatically sets the following categories: Depending on namespace:

• Category:Media with locations (for files)
• Category:Galleries with coordinates (for galleries)
• Category:Categories with coordinates (for categories)

In case of errors:

• Category:Media with default location (set by the template in case of lat=0 and lon=0 coordinates)
• Category:Media with erroneous locations (set by the template for other issues)
• Category:Pages with malformed coordinate tags (set by {{#coordinates:}})

Usage

{{Location |1= |2= |3= }}

Should be placed directly above or below {{Information}}, {{Artwork}} or other similar template.
Note: some users prefer to include location template(s) into the "Description" field of {{Information}} template in order to group all location information together – objections are in point of graphic design not ideal adjusted for such use. See this and this discussion.

Template parameters

Parameter	Description		Default	Status
1	Latitude	Degrees of Latitude. The sign indicates hemisphere: + (North) and - (South).	empty	required
2	Longitude	Degrees of Longitude. The sign indicates hemisphere: + (East) and - (West).	empty	required
3	attributes	Information attributes - used to pass to GeoHack server metadata about the coordinates. Apart from heading, this information is not used by {{Location/doc}} template. Attributes have to be in the format field1:value1_field2:value2_field3:value3, etc. The following fields are supported: region:XX-YYY specifies the political region, used to select appropriate map resources. See here for more info. XX is an ISO 3166-1 alpha 2 country code abbreviation, and YYY is a 1-, 2- or 3- characters ISO 3166-2 (see w:ISO 3166-2#Format for details) province/region/state code abbreviation (typically the same as a local postal code abbreviation). heading: indicates the direction in which the camera was pointing. It is given as degree values 0–360 (clockwise with north as 0) or a compass point abbreviation (up to four letters) as defined in Points of the compass. (Example: heading:NW). It should be very similar for both {{Location}} and {{Object location}} templates when used in the same image. For example "heading:N" means that the camera was pointing North when the photograph was taken. In case of {{Object location}} template that might mean that we are looking at a South wall/side of the structure/object. scale:N specifies the desired map scale as 1:N. Since most images are at the lowest scale, the parameter should be given only if values different from the default are desired. See here for more info. dim:<width><units> specifies the width of the object in meters or kilometers (example: dim:120m or dim:10km). Since most images are at the lowest scale, the parameter should be given only if values different from the default are desired. See here for more info. source: where the data come from class:object is a hard-coded value which will be added automatically to all images to tag this location as the "object" location. class:object is hard-coded value which will be added automatically to all images to tag this location as the ""object location	empty	optional
bare	"bare=1" will show only field value without field's name ("Object location")		empty	optional
secondary	secondary=1 will tag this set of coordinates as secondary. This template calls {{#coordinates:}} parser function, one of the parameters of which is primary vs. secondary label. Primary coordinates define file's camera location and are the default, but each file can only have single primary location tag.		empty	optional

Additional information

The template is intended to be used in the following namespaces: the File namespace

The template is intended to be used by the following user groups: all users

Syntax #2: Degrees/Minutes/Seconds (DMS)

This subpage contains documentation, categories, or other content that is not part of the template.
To view the template page itself, see Template:Location.

---

Alternative DMS syntax.

Usage

{{Location |1= |2= |3= |4= |5= |6= |7= |8= |9= }}

Template parameters

Parameter	Description		Default	Status
1	Degrees of Latitude		empty	required
2	Minutes of Latitude		empty	required
3	Seconds of Latitude		empty	required
4	Latitude Direction (N or S)		empty	required
5	Degrees of Longitude		empty	required
6	Minutes of Longitude		empty	required
7	Seconds of Longitude		empty	required
8	Longitude Direction (W or E)		empty	required
9	See parameter #3 in the decimal degrees syntax		empty	optional
bare	"bare=1" will show only field value without field's name ("Camera location")		empty	optional

Additional information

The template is intended to be used in the following namespaces: all content namespaces

The template is intended to be used by the following user groups: all users

Relies on:
Module:Coordinates

See also

• Other templates from the family:

• {{Location}} – used to provide camera location using
• {{Object location}} – used to provide object location using
• {{Globe location}} – used to provide object location on other globes, like Moon, Mars, etc.

• Related templates

• {{Location-Panorama}}
• {{Location map notice}}
• {{Location possible}}, mark pictures without defined location
• {{Location required}}

• old documentation

== Localization ==

All translations at Module:I18n/coordinates

Examples

Syntax #1

Code	{{Location|34.02427|-116.15830|region:DE-NI_scale:10000}}
Produces	34.0243° N 116.1583° W

Syntax #2

Code	{{Location|34|1|27.37|N|116|9|29.88|W|...}}
Produces	34.0243° N 116.1583° W

Main syntax

Code	{{Location|34|1|27.37|N|116|9|29.88|W|...}}
Produces	34.0243° N 116.1583° W