တူၺ်းငဝ်ႈငႃႇ တွၼ်ႈတႃႇ ထႅမ်းပလဵတ်ႉ:GNIS/doc

{{Documentation subpage}}
{{high use}}
<!-- Categories go at the bottom of this page and interwikis go in Wikidata. -->
{{Wikidata property|P590|P804}}

[[Template:GNIS]] generates an external link to a Feature Detail Report from the [[Geographic Names Information System]] (GNIS), published by the [[United States Geological Survey]] (USGS). The link is displayed as "U.S. Geological Survey Geographic Names Information System: ''Name''", where ''Name'' is either the Wikipedia article name (<code><nowiki>{{</nowiki>PAGENAME}}</code>) or an optionally specified name.

== လွင်ႈၸႂ်ႉတိုဝ်း ==

The only required parameter is the GNIS Feature ID number (optionally, this parameter can be named <code>id</code>). The template then uses the Wikipedia article name as part of the [[anchor text]].

 <nowiki>{{</nowiki>GNIS|''ID''}}
 <nowiki>{{</nowiki>GNIS|id=''ID''}}

If desired, a feature name other than the article name can be specified in a second unnamed parameter (optionally, this can be named <code>name</code>). This can be used if the article name contains disambiguation or when the GNIS feature name is different than the article name.

 <nowiki>{{</nowiki>GNIS|''ID''|''Name''}}
 <nowiki>{{</nowiki>GNIS|id=''ID''|name=''Name''}}

For GNIS features in Antarctica, add <code>|type=antarid</code>.

 <nowiki>{{</nowiki>GNIS|''ID''|type=antarid}}
 <nowiki>{{</nowiki>GNIS|id=''ID''|type=antarid}}

 <nowiki>{{</nowiki>GNIS|''ID''|''Name''|type=antarid}}
 <nowiki>{{</nowiki>GNIS|id=''ID''|name=''Name''|type=antarid}}

== ၶေႃႈမုၼ်းထႅမ်းပလဵၵ်ႉ ==

{{TemplateData header}}
<templatedata>{
"description": "This template generates an external link to a Feature Detail Report from the Geographic Names Information System (GNIS), published by the United States Geological Survey (USGS). The link is displayed as 'U.S. Geological Survey Geographic Names Information System: Name', where Name is either the Wikipedia article name ({{PAGENAME}}) or an optionally specified name.",
"params": {
  "1": {
    "label": "ID",
    "aliases": ["id"],
    "description": "GNIS Feature ID, a number without leading zeros.",
    "type": "number",
    "default": "",
    "required": true
  },
  "2": {
    "label": "Name",
    "aliases": ["name"],
    "description": "GNIS Feature Name or other descriptive text. If not given it defaults to the Wikipedia article name",
    "type": "string",
    "default": "{{PAGENAME}}",
    "required": false
  },
  "type": {
    "label": "Type",
    "description": "Use the value 'antarid' (type=antarid) for features in Antarctica.",
    "type": "string",
    "default": "",
    "required": false
  }
}}</templatedata>

== လွင်ႈၸီႉသင်ႇ ==

# Go to the [https://geonames.usgs.gov/apex/f?p=gnispq GNIS Feature Search] page.
# Search for the name, location, and/or class of the feature desired, e.g., to find a mountain called 'Mt. Foo', type '<code>mount foo</code>' in the Feature Name box and select 'Summit' from the Feature Class list.
# Copy the 'ID' number for the desired feature and insert it into the <code><nowiki>{{</nowiki>GNIS|...}}</code> template.
# The latitude and longitude can also be copied and used in the {{tlx|coord}} template, inserting the '{{para}}' vertical bar between degrees, minutes, seconds, and direction, e.g.: 441613N&nbsp;&nbsp;0711812W → <code><nowiki>{{</nowiki>coord|44|16|13|N|071|18|12|W|region:US}}</code>

== တူဝ်ယၢင်ႇ ==

URL: {{GNIS URL|871352}}
* ''Usage:'' <code><nowiki>{{</nowiki>GNIS | 871352 | Mount Washington }}</code>
** ''Result:'' {{GNIS | 871352 | Mount Washington }}
* ''Usage:'' <code><nowiki>{{</nowiki>GNIS |id= 871352 |name= Mount Washington }}</code>
** ''Result:'' {{GNIS |id= 871352 |name= Mount Washington }}

URL: {{GNIS URL|2828|type=antarid}}
* ''Usage:'' <code><nowiki>{{</nowiki>GNIS | 2828 | Clarke Glacier |type= antarid }}</code>
** ''Result:'' {{GNIS | 2828 | Clarke Glacier |type= antarid }}
* ''Usage:'' <code><nowiki>{{</nowiki>GNIS |id= 2828 |name= Clarke Glacier |type= antarid }}</code>
** ''Result:'' {{GNIS |id= 2828 |name= Clarke Glacier |type= antarid }}

== See also ==

;Other GNIS templates:
* {{tl|GNIS 2}} – link with anchor text "[1]" or "''Name''"
* {{tl|GNIS 3}} – link as bare [[URL]] only, without anchor text
* {{tl|GNIS 4}} – link with GNIS Feature ID number as the anchor text
* {{tl|Cite gnis}} – link using the {{tl|Cite web}} template, for use as a reference
* {{tl|Cite gnis2}} – link using the {{tl|Citation}} template, for use as a reference with anchor text 

;List of pages linking to [[Special:Linksearch/geonames.usgs.gov|geonames.usgs.gov]]:
* [[Special:Linksearch/geonames.usgs.gov/apex/f?p=gnispq]] (current format)
* [[Special:Linksearch/geonames.usgs.gov/pls/gnispublic/f?p=gnispq]] (old format)

;Similar templates:
* {{tl|Mountain index row}} – includes an optional GNIS link
* Canadian features ([[Canadian Geographical Names Data Base]], [[BC Geographical Names]])
** {{tl|Cite cgndb}} – all of Canada
** {{tl|Cite bcgnis}} – British Columbia
* Non-U.S. geographic features ([[GEOnet Names Server]])
** {{tl|GEOnet2}}
** {{tl|Cite gns}}
* On Solar System features (Gazetteer of Planetary Nomenclature)
** {{tl|Gazetteer of Planetary Nomenclature}} – inline citations
** {{tl|WGPSN}} – external links

<includeonly>{{Sandbox other||
<!-- Categories go here, and interwikis go in Wikidata -->
[[Category:United States government external link templates]]
}}</includeonly>