View source for Template:GEOnet2/doc

{{Documentation subpage}}
<!-- Categories go at the bottom of this page and interwikis go in Wikidata. -->
{{TOC right}}
{{Tl|GEOnet2}} generates an external link to a specific geographic feature name from the [[GEOnet Names Server]] (GNS), published by the [[National Geospatial-Intelligence Agency]] (NGA). The template uses the GEOnet Name_GUID search index or key (a.k.a. G_NAME in the URL).

== Usage ==
<code>{{Tlx|GEOnet2|''Name_GUID''|''Name''}}</code>

== TemplateData ==
{{TemplateDataHeader}}
<templatedata>{
"description": "This template generates an external link to a specific geographic feature name from the GEOnet Names Server (GNS), published by the National Geospatial-Intelligence Agency (NGA).",
"params": {
  "1": {
    "label": "Name_GUID",
    "description": "GEOnet Name_GUID database search key, which is the value assigned to G_NAME in the http://geonames.nga.mil/namesgaz/detaillinksearch.asp URL.",
    "type": "string",
    "default": "",
    "required": true
  },
  "2": {
    "label": "Name",
    "description": "Name or other descriptive text. If not given it defaults to the Wikipedia article name",
    "type": "string",
    "default": "{{PAGENAME}}",
    "required": false
  }
}}</templatedata>

== Examples ==
{| class="wikitable"
|+ {{Tl|GEOnet2}} examples</caption>
! Code
! Produces
|-
| <code>{{Tlx|GEOnet2|32FA88151D7D3774E0440003BA962ED3}}</code>
| {{GEOnet2|32FA88151D7D3774E0440003BA962ED3}}
|-
| <code>{{Tlx|GEOnet2|32FA88151D7D3774E0440003BA962ED3|Baku, Azerbaijan}}</code>
| {{GEOnet2|32FA88151D7D3774E0440003BA962ED3|Baku, Azerbaijan}}
|}

The examples shown above generate a link to:
* http://geonames.nga.mil/namesgaz/detaillinksearch.asp?G_NAME='32FA88151D7D3774E0440003BA962ED3'&Diacritics=DC

== Instructions ==
A search engine can be found [http://geonames.nga.mil/namesgaz/ here]. Select a country name to reduce the number of matches. Finding the required <tt>id</tt> is browser specific.<ref>These instructions were valid, using the latest browser version, at the time this documentation was written. Tests were only done using the Windows versions. If you have a problem leave a note on the [[Template talk:Cite gns/doc|discussion page]] or try the [[Wikipedia:Help desk|Help desk]].</ref>
* [[Google Chrome|Chrome]] – Left click on the name then right click anywhere on pop-up. Select "Open frame in new tap". A [[URL]] without a protocol will be displayed in the Omnibox at the top of the screen.
* [[Firefox]] – While pressing the [[control key]], left click on the name. A new tab will be created with a [[JavaScript]] function in the URL box.
* [[Internet Explorer]] – Right click on the name and select "Properties". A Javascript function, identified as the URL, will be displayed in the pop-up.
* [[Opera (web browser)|Opera]] – Right click on the name and select "Open in New Tab". A new tab will be created with A Javascript function in the URL box.
* [[Safari (web browser)|Safari]] – Right click on the name and select "Copy Link". Paste location into a text box (right click and select Paste).

The Javascript or URL for [[Mount Logan]] contain the string "('32FA8842BEDB3774E0440003BA962ED3', 'DC')" the <tt>id</tt> is the [[alphanumeric]] value between the single quotes. For example, the <tt>id</tt> for Mount Logan is 32FA8842BEDB3774E0440003BA962ED3.

=== Note ===
{{reflist}}

== See also ==
{{Special:PrefixIndex/Template:GEOnet}}

Similar templates:
* {{tl|Cite GNS}} – for same link in different format
* {{tl|GNIS}} and {{tl|Cite GNIS}} – for links to U.S. geographic feature names from [[Geographic Names Information System]] (GNIS)

List of pages linking to [[Special:Linksearch/geonames.nga.mil|geonames.nga.mil]]:
* [[Special:Linksearch/geonames.nga.mil/namesgaz/detaillinksearch.asp]] (current format)
* [[Special:Linksearch/geonames.nga.mil/ggmagaz/detaillinksearch.asp]] (old format)

== External links ==
* [http://earth-info.nga.mil/gns/html/index.html NGA GEOnet Names Server (GNS)]
** [http://geonames.nga.mil/namesgaz/ GNS Search - Text Based Page]
** [http://geonames.nga.mil/namesviewer GNS Search - Open Geospatial Consortium (OGC) Viewer Page]

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
<!-- Categories go here, and interwikis go in Wikidata -->
[[Category:United States government attribution templates]]
[[Category:United States military templates|Navy, USGovernment]]
}}</includeonly>