Patrom:GeoGroupTemplate/doc

This is a documentation subpage for Patrom:GeoGroupTemplate. It contains usage information, categories, interlanguage links and other content that is not part of the original patrom page.

(tl) generates an infobox type list of external links to services that present or display all coordinates listed on certain Wikipedia articles that have multiples of coordinates. The template is also capable of generating all the title coordinates from many articles listed in a single Wikipedia category. The template is intended to be inserted in the External links section of articles, or inside a section with a list or table of features, if appropriate (e.g. see Tame Valley Canal).

The linked services allow the following results:

• Coordinates from the Wikipedia page or category in a KML file suitable for use in Google Earth, NASA World Wind and similar applications.
• Microformatted coordinates from the Wikipedia page in a GeoRSS file.
• A link to Google Maps with the waypoints plotted onto the map. Note that Google caches data and may at times show a previous revision instead of the latest one. In this case wait a moment before refreshing.
• A link to Bing map with the waypoints plotted onto the map. Note that if the page or category has more than 200 coordinates, Bing would present a maximum of just the first 200 points.

Inline coordinates can be associated with a name using (tl) with the |name= parameter, such as:

{{coord|1|2|type:landmark|name=Interesting uncharted point in the sea}}

However, do not use the |name= parameter when the coordinates are within a parent template or table which emits a microformat, such as an infobox.

This template is not intended for articles with single sets of coordinates; such coordinates already link indirectly to (tl).

To use this template, add (tl) to the External links section of an article, or, for list articles with no title coordinate, at the top of the article.

Usage

There are three optional parameters that are useful mainly in articles—not categories:

{{GeoGroup|article=article name}}

article= The name of article or category, from which coordinates will be displayed. (Can be a category, as shown in List of stations in London fare zone 2#List of stations)

{{GeoGroup|article=article name|articlee=article_name}}

articlee= Encoded name of the article. The encoding process here involves changing spaces to underscores ( _ ), everything else is taken care of by the urlencode magic word.

{{GeoGroup|section=section name}}

section= The section parameter arranges most of the links to use only coordinates in the named section of the article. This is useful to limit the number seen at one time in articles with many coordinates. For examples, see List of rapids of the Columbia River.

There is one optional parameters for use with categories:

{{GeoGroup|level=0,1,2,3,...}}

level= Category recursion level, where 0 means unlimited

A section-specific GeoGroup makes most sense placed within the section it refers to.

Linking

Links may be made directly to a page's instance of the template, with the ID GeoGroup, by using [[#GeoGroup|Example Link Text]], which produces: Example Link Text.

Expansion

Other KML aware services may be added, as they become available; as might services converting the coordinates to GPX or other formats.

Examples

Point	Coordinates (links to map & photo sources)
Dudley Port Junction	52.52204, -2.04331 (Dudley Port Junction)
Groveland Bridge (Titpon Road, A457)	52.51758, -2.04760 (Groveland Bridge (Titpon Road, A457))
Tividale Aqueduct (Old BCN Main Line)	52.51640, -2.04843 (Tividale Aqueduct (Old BCN Main Line))
Northern tunnel portal	52.51534, -2.04948 (Northern tunnel portal)
Aston Road air vent	52.50850, -2.05518 (Aston Road air vent)
Regent Road air vent	52.50697, -2.05708 (Regent Road air vent)
Approx. tunnel mid-point	52.50435, -2.05932 (Approx. tunnel mid-point)
Southern tunnel portal	52.49335, -2.06916 (Southern tunnel portal)
Windmill End Junction	52.49157, -2.07019 (Windmill End Junction)

Bookmarklet

To added the template to categories, you may want to use the bookmarklet below. Sample edit: [1]

javascript:with(document.forms[0]){void(wpSummary.value+='+{{[[Template:GeoGroup|GeoGroup]]}}%20(see%20also%20[[Wikipedia:WikiProject_Geographical_coordinates|WP:GEO]]');void(wpTextbox1.value='{{GeoGroup}}'+wpTextbox1.value);void(wpSave.click())}