View source for Template:Cite GNIS/doc

{{Documentation subpage}}
<!-- Categories go at the bottom of this page and interwikis go in Wikidata. -->
{{high-use}}
{{CS1 wrapper |type=source |base=Cite encyclopedia}}
{{Wikidata property|P590|P804}}
{{Hatnote|If you encounter a formerly-working GNIS link that now returns an error, see {{slink|Template:GNIS/doc|Retired data}} and use {{para|type|retired}} here.}}

This [[Wikipedia:Citation templates|citation template]] is used to cite a Feature Detail Report from the [[Geographic Names Information System]] (GNIS) published by the [[United States Geological Survey]] (USGS).

== Usage ==

A search engine can be found [https://edits.nationalmap.gov/apps/gaz-domestic/public/search/names here].

{| class="wikitable"
|- width="50%" style="vertical-align:top;"
! Parameter !! Value !! Notes
|- width="50%" style="vertical-align:top;"
| style="vertical-align:top;padding:1ex;" |<pre style="margin:0; padding:0; border-color:transparent">
{{cite gnis
| type =
| id =
| name =
| access-date =
}}</pre>
| style="vertical-align:top;padding:1ex;" |<pre style="margin:0; padding:0; border-color:transparent">
&nbsp;
antarid or retired
feature ID (number)
feature name (text)
database access date
&nbsp;</pre>
| style="vertical-align:top;padding:1ex;" |<pre style="margin:0; padding:0; border-color:transparent">
&nbsp;
for Antarctic or retired features
required (1)
required (2)
recommended
&nbsp;</pre>
|}

* For Antarctic locations, specify {{para|type|antarid}}.
* For [[Template:GNIS/doc#Retired data|features types retired in 2021]], specify {{para|type|retired}}.
* To disable links to the publisher, when the template is used multiple times in an article, use {{para|links|off}}
* Template accepts all parameters accepted by {{tl|cite encyclopedia}}, e.g., {{para|access-date}} or {{para|date}}
* Positional (unnamed) parameters are interpreted as <code><nowiki>{{cite gnis|id|name|access-date|date}}</nowiki></code>
* Some of the parameters are aliases for {{tl|cite encyclopedia}}, either form can be used:
** {{para|name}} → {{para|entry}}
** {{para|date}} → {{para|access-date}}

<!-- Since the GNIS site is very stable, the {{para|access-date}} is optional. -->
Note that latitude, longitude and elevation may be somewhat inaccurate. It is best to confirm this data by viewing the location on a map. If necessary use more reliable sources.

== Examples ==
{{markup2 |t=With named parameters and entry date
|m=<nowiki>{{cite gnis |id=269051 |name=Mount Whitney |date=January 19, 1981 |access-date=March 10, 2022}}</nowiki>
|r={{cite gnis |id=269051 |name=Mount Whitney |date=January 19, 1981 |access-date=March 10, 2022}}
}}

{{markup2 |t=With unnamed parameters and entry date
|m=<nowiki>{{cite gnis |269051 |Mount Whitney | |January 19, 1981}}</nowiki>
|r={{cite gnis |269051 |Mount Whitney | |January 19, 1981}}
}}

{{markup2 |t=With unnamed parameters, access date and entry date
|m=<nowiki>{{cite gnis |269051 |Mount Whitney |December 20, 2020 |January 19,1981}}</nowiki>
|r={{cite gnis |269051 |Mount Whitney |December 20, 2020 |January 19, 1981}}
}}

{{markup2 |t=With named parameters and publisher links off
|m=<nowiki>{{cite gnis |id=269051 |name=Mount Whitney |access-date=December 20, 2020 |entry-date=19 January 1981 |links=off}}</nowiki>
|r={{cite gnis |id=269051 |name=Mount Whitney |access-date=December 20, 2020 |entry-date=19 January 1981 |links=off}}
}}

{{markup2 |t=Antarctic locations
|m=<nowiki>{{cite gnis |type=antarid |id=15152 |name=Mount Terror |date=January 1, 1947 |access-date=March 10, 2022}}</nowiki>
|r={{cite gnis |type=antarid |id=15152 |name=Mount Terror |date=January 1, 1947 |access-date=March 10, 2022}}
}}

{{markup2 |t=Retired locations
|m=<nowiki>{{cite gnis |type=retired |id=235365 |name=Stanford University |date=January 19, 1981 |access-date=February 12, 2023}}</nowiki>
|r={{cite gnis |type=retired |id=235365 |name=Stanford University |date=January 19, 1981 |access-date=February 12, 2023}}
}}

{{markup2 |t=With all named parameters, Antarctic locations
|m=<nowiki>{{cite gnis |type=antarid |id=19152 |name=Raney Peak |entry-date=21 January 2008 |access-date=December 20, 2020 |links=off |ref=test}}</nowiki>
|r={{cite gnis |type=antarid |id=19152 |name=Raney Peak |entry-date=21 January 2008 |access-date=December 20, 2020 |links=off |ref=test}}
}}

== See also ==
* {{tl|cite gnis2}} – For a CS2 format citation than includes a {{tl|harvid}} identifier
* {{tl|GNIS}}, {{tl|GNIS 2}}, {{tl|GNIS URL}}, {{tl|GNIS 4}} – for same external link in other formats
* {{tl|GEOnet2}} and {{tl|Cite gns}} – for links to non-U.S. geographic feature names from [[GEOnet Names Server]]
* {{tl|Cite ngs}} – for links to [[U.S. National Geodetic Survey]]
* {{tl|Cite gvp}} – for links to [[Global Volcanism Program]]
* {{tl|Cite encyclopedia}}

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