Template:GNIS

U.S. Geological Survey Geographic Names Information System: GNIS

Template documentation[view] [edit] [history] [purge]

If you encounter a formerly-working GNIS link that now returns an error, see § Retired data below.

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 ({{PAGENAME}}) or an optionally specified name.

Usage

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

{{GNIS|ID}}
{{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 name). This can be used if the article name contains disambiguation or when the GNIS feature name is different than the article name.

{{GNIS|ID|Name}}
{{GNIS|id=ID|name=Name}}

For GNIS features in Antarctica, add |type=antarid.

{{GNIS|ID|type=antarid}}
{{GNIS|id=ID|type=antarid}}

{{GNIS|ID|Name|type=antarid}}
{{GNIS|id=ID|name=Name|type=antarid}}

For GNIS types types of features retired in 2021, add |type=retired.

{{GNIS|ID|type=retired}}
{{GNIS|id=ID|type=retired}}

{{GNIS|ID|Name|type=retired}}
{{GNIS|id=ID|name=Name|type=retired}}

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:GNIS in articles based on its TemplateData.

TemplateData for GNIS

<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 (GNIS) 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": "GNIS",
   "required": false
 },
 "type": {
   "label": "Type",
   "description": "Use the value 'antarid' for features in Antarctica. Use the value 'retired' for feature types retired in 2021.",
   "type": "string",
   "default": "",
   "required": false
 }

}}</templatedata>

Instructions

1. Go to the GNIS Feature Search page.
2. Search for the name, location, and/or class of the feature desired, e.g., to find a mountain called 'Mt. Foo', type 'mount foo' in the Feature Name box and select 'Summit' from the Feature Class list.
3. Copy the id number for the desired feature (above its name) and insert it into the {{GNIS|...}} template.
4. The latitude and longitude can also be copied and used in the {{coord}} template, inserting the '|' vertical bar between degrees, minutes, seconds, and direction, e.g.: 441613N  0711812W → {{coord|44|16|13|N|071|18|12|W|region:US}}

Examples

URL: https://edits.nationalmap.gov/apps/gaz-domestic/public/summary/871352

• Usage: {{GNIS | 871352 | Mount Washington }}
  • Result: U.S. Geological Survey Geographic Names Information System: Mount Washington
• Usage: {{GNIS |id= 871352 |name= Mount Washington }}
  • Result: U.S. Geological Survey Geographic Names Information System: Mount Washington

URL: https://web.archive.org/web/2020/https://geonames.usgs.gov/apex/f?p=gnispq:5:::NO::P5_ANTAR_ID:2828

• Usage: {{GNIS | 2828 | Clarke Glacier |type= antarid }}
  • Result: U.S. Geological Survey Geographic Names Information System: Clarke Glacier
• Usage: {{GNIS |id= 2828 |name= Clarke Glacier |type= antarid }}
  • Result: U.S. Geological Survey Geographic Names Information System: Clarke Glacier

URL: https://web.archive.org/web/2020/https://geonames.usgs.gov/apex/f?p=gnispq:3:::NO::P3_FID:235365

• Usage: {{GNIS | 235365 | Stanford University |type= retired }}
  • Result: U.S. Geological Survey Geographic Names Information System: Stanford University
• Usage: {{GNIS |id= 235365 |name= Stanford University |type= retired }}
  • Result: U.S. Geological Survey Geographic Names Information System: Stanford University

Retired data

In October 2021, USGS announced that several classes of data had been removed from their searchable database:

The following feature classes will be archived: Airport, Bridge, Building, Cemetery, Church, Dam, Forest, Harbor, Hospital, Mine, Oilfield, Park, Post Office, Reserve, School, Tower, Trail, Tunnel, and Well.

If you encounter articles with GNIS links that return the error "The ID does not exist", they were probably for records in one of these classes. In this case, specify |type=retired, and a link will be generated to a 2020 snapshot of the GNIS feature.

The snapshot was taken by http://web.archive.org and it may not exist. If you find it doesn't exist, then the link is permanently broken and should be marked with {{dead link}}.

See also

Other GNIS templates

• {{GNIS 2}} – link with anchor text "[1]" or "Name"
• {{GNIS URL}} – link as bare URL only, without anchor text
• {{GNIS 4}} – link with GNIS Feature ID number as the anchor text
• {{Cite gnis}} – link using the {{Cite web}} template, for use as a reference

List of pages linking to 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

• Canadian features (Canadian Geographical Names Data Base, BC Geographical Names)
  • {{Cite cgndb}} – all of Canada
  • {{Cite bcgnis}} – British Columbia
• Non-U.S. geographic features (GEOnet Names Server)
  • {{GEOnet2}}
  • {{Cite gns}}

The above documentation is transcluded from Template:GNIS/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.