View source for Module:Coordinates/doc

{{High-risk|1,000,000+}}
{{Uses Wikidata|P625}}
{{Tracks Wikidata|P625}}
{{Module rating|protected}}

'''Note:''' The code which this module's main function (<code>coord</code>) outputs is directly parsed and/or manipulated by [[Module:Location map]] and other functions of this module itself (<code>coord2text</code> and <code>coordinsert</code>). If the structure of the output changes (for example, to use [[:mw:Help:Extension:Kartographer|the <code><nowiki><mapframe></nowiki></code> and <code><nowiki><maplink></nowiki></code> tags]]), please update the aforementioned scripts as well.

==Using the module with coordinsert==
When using the {{tl|Coord}} template inside another template, like an infobox, there may be parameters (like <code><var>type</var>:<var>airport</var></code>) which should be added automatically. To do so, do something like this:
 <code>&#123;&#123;#if:&#123;&#123;&#123;coordinates&#124;&#125;&#125;&#125;&#124;&#123;&#123;#invoke:Coordinates&#124;coordinsert&#124;&#123;&#123;&#123;coordinates&#124;&#125;&#125;&#125;&#124;<var>parameter1:value1&#124;parameter2:value2&#124;parameter3:value3…</var>&#125;&#125;&#124;</code> 

Do not add more vertical bars <code>&#124;</code> than necessary. 

==Using the module with coord2text to extract latitude or longitude== 
Developers maintaining legacy code may need to extract latitude or longitude to use a parameters in other code, or a mathematical expression. 
The module's "coord2text" function can be used to extract data from the {{tl|Coord}} template. To extract the latitude from a Coord template, use:

<code><nowiki>{{#invoke:coordinates|coord2text|{{Coord|57|18|22|N|4|27|32|E}}|lat}}</nowiki></code> &rarr; {{#invoke:coordinates|coord2text|{{Coord|57|18|22|N|4|27|32|E}}|lat}} 

To extract the longitude, use: 

<code><nowiki>{{#invoke:coordinates|coord2text|{{Coord|57|18|22|N|4|27|32|E}}|long}}</nowiki></code> &rarr; {{#invoke:coordinates|coord2text|{{Coord|57|18|22|N|4|27|32|E}}|long}}

== Modules using this module directly ==
* [[Module:HS listed building]]

== Tracking categories ==
* {{clc|Pages with malformed coordinate tags}}
* {{clc|Coordinates not on Wikidata‎}}
* {{clc|Coordinates on Wikidata‎}}
* {{clc|Coordinates on Wikidata set to no value‎}}
* {{clc|Coordinates on Wikidata set to unknown value‎}}

<includeonly>{{#switch:{{SUBPAGENAME}}|sandbox2|sandbox=|
[[Category:Modules that add a tracking category]]
}}</includeonly>