GEOnet Names Server (GNS) Services
GNS Provides the following services:
Web Map Services (WMS) - 1.3.0 and 1.1.0 compliant: Depending on client capabilities, try the full URLs listed below by each WMS service, or a shortened one such as "http://geonames.nga.mil/service_name/service.svc/get?" with or without the question mark, to display any of the WMS services (e.g. "http://geonames.nga.mil/names/service.svc/get?" for the Full WMS, or "http://geonames.nga.mil/populatedplaces_p/service.svc/get?" for the Scaled Populated Place WMS)
Full WMS: Provides the full content of GNS
- Service Capabilities: http://geonames.nga.mil/names/service.svc/get?request=GetCapabilities&service;=WMS&version;=1.3.0
Scaled WMS: Provides the full content of GNS, but introduces a scaling factor based on the DISPLAY values found at http://geonames.nga.mil/gns/html/gis_countryfiles.html
- Service Capabilities: http://geonames.nga.mil/namesscaled/service.svc/get?request=Getcapabilities&service;=WMS&version;=1.3.0
Scaled WMS by Feature Class: "Feature Class" definitions can be found at http://geonames.nga.mil/gns/html/gis_countryfiles.html
- Administrative Layer Service Capabilities: http://geonames.nga.mil/administrative_a/service.svc/get?request=GetCapabilities&service;=WMS&version;=1.3.0
- Hydrographic Layer Service Capabilities: http://geonames.nga.mil/hydrographic_h/service.svc/get?request=GetCapabilities&service;=WMS&version;=1.3.0
- Hypsographic Layer Service Capabilities: http://geonames.nga.mil/hypsographic_t/service.svc/get?request=GetCapabilities&service;=WMS&version;=1.3.0
- Localities Layer Service Capabilities: http://geonames.nga.mil/localities_l/service.svc/get?request=GetCapabilities&service;=WMS&version;=1.3.0
- Populated Place Layer Service Capabilities: http://geonames.nga.mil/populatedplaces_p/service.svc/get?request=GetCapabilities&service;=WMS&version;=1.3.0
- Spot Feature Layer Service Capabilities: http://geonames.nga.mil/spot_s/service.svc/get?request=GetCapabilities&service;=WMS&version;=1.3.0
- Transportation Layer Service Capabilities: http://geonames.nga.mil/transportation_r/service.svc/get?request=GetCapabilities&service;=WMS&version;=1.3.0
- Undersea Layer Service Capabilities: http://geonames.nga.mil/undersea_u/service.svc/get?request=GetCapabilities&service;=WMS&version;=1.3.0
- Vegetation Layer Service Capabilities: http://geonames.nga.mil/vegetation_v/service.svc/get?request=GetCapabilities&service;=WMS&version;=1.3.0
Web Feature Service (WFS) - 2.0.0 and 1.1.0 compliant: The maximum number of features returned is 8,500
- Service Capabilities: http://geonames.nga.mil/nameswfs/service.svc/get?REQUEST=GetCapabilities&SERVICE=wfs&VERSION=2.0.0
WFS Test Page: provides sample calls and resulting output - http://geonames.nga.mil/nameswfs/default.htm
Web Feature Service, Gazetteer Profile (WFS-G) - 1.1.0 compliant:
- Service Capabilities:
http://geonames.nga.mil/nameswfsg/request.aspx?service=WFS&request=GetCapabilities
WFS-G Test Page: provides sample calls and resulting output - http://geonames.nga.mil/nameswfsg/default.htm
REST/JSON Services: ArcGIS 10.3.1 server based services of GNS content - the maximum number of features returned is 8,500
- Provides the content of GNS in three formats:
- Scaled Visualization: Provides access to scaled GNS content by Feature Class
- Non-scaled Visualization:
- Provides access to unscaled GNS content by Feature Class
- Provides access to unscaled GNS content by Name Type
- Research: Provides access to all unscaled GNS content
To use any of these services, please access the Service Catalogue at http://geonames.nga.mil/arcgis/rest/
- Sample webpages that demonstrate REST/JSON capabilities and can be used as templates for developers:
- KitchenSink:
http://geonames.nga.mil/gns/html/rest/kitchensink.html
- NOTE: To use kitchensink, you must first download and extract the following file: http://geonames.nga.mil/gns/html/rest/kitchenSink.zip
- EasySearch: http://geonames.nga.mil/gns/html/rest/easySearch.html
- LookupTables: http://geonames.nga.mil/gns/html/rest/lookuptables.html
- MapViewer: http://geonames.nga.mil/gns/html/rest/mapviewer.html
- KitchenSink:
http://geonames.nga.mil/gns/html/rest/kitchensink.html
KML Streaming Service:
Open Geospatial Consortium (OGC) compliant Web Map Services (WMS) Viewer:
|
Besides providing a viewer for NGA's WMS data, it also supports mapping and displaying other available WMS services |
Text Based Query and Output Services:
Search the contents of GNS, and display the results onscreen, or choose to export the results in one of the following formats:
Widen or narrow the search and output criteria based on selectable parameters such as:
More selections produce narrower search results.
|
|
You can search for multiple names by choosing the Multiple Names Search option above the Name widget. You can input 500 lines of individual names for search type Starts With, Exact Match, and Ends With. For Contains Search, you are limited to 100 lines of individual names. |
Really Simple Syndication (RSS) Feed Service :
GNS offers subscription to GeoNames RSS feeds. The GeoNames RSS feeds can be accessed through the GNS Search - Text Based Page. The feeds, at this time, alert to the total number of changed rows of data based on subscribed country(ies), but do not identify those changed rows. Future implementations will introduce GeoRSS.
|
Pre-Positioned Downloadable Country files:
GNS database content, broken by country, is available for download as country files using HTTP or FTP connections. An extra file that contains the entire data set is also available for download. All feature names data is encoded as Unicode UTF-8. The following table describes the format of those files.Look-up Tables, or domain tables, can be queried and output using the GNS Text Based search page.
Once you arrive at the GNS Text Based search page, follow these simple steps to generate output of look-up tables values:
*** look-up table name stands for any of the following available look-up (domain) tables:
|
GeoNames Soft-Copy Keyboard:
The keyboard was created to provide easy access to Romanized Unicode special characters
and letter/diacritic combinations, and to maintain a uniform input of said characters
when adding or editing entries in the Geographic Names Database (GNDB). The GNDB
is the base for populating the GEOnet Names Server (GNS) dissemination database
instance, made available to consumers of geographic names data and services.
|
GNS Data and GIS Applications ***:
GNS data, whether generated through the text based search and output page, or downloaded as pre-positioned country files, can be brought into a variety of GIS applications. Below are links to Open Source GIS applications, and suggestions on how to bring GNS data into them.
ESRI's ArcGIS 9.x (http://www.esri.com/) can open shapefiles and can load pre-positioned country files (Unicode UTF-8, tab-delimited files) and personal geodatabases.
- To enable Unicode support in ArcGIS 9.x, see ESRI's article on how to Read and write shapefile and dBase file encoded in various code pages at: http://support.esri.com/technical-article/000013192
- Information about consuming GEOnet Names Server Data & OGC Services: DRAFT_-_Consuming_GEOnet_Names_Server_Data_&_Services_2016-08-04.docx
Most commercial and Open Source GIS applications can deal with shapefiles and the downloadable pre-positioned country files (Unicode UTF-8, tab-delimited files).
*** Information about grid reference systems is available
at the web site of NGA's Geodesy
and Geophysics.