GRASS logo

NAME - Imports US-NGA GEOnet Names Server (GNS) country files into a GRASS vector points map.


vector, import, gazetteer

SYNOPSIS --help input=name [output=name] [--overwrite] [--help] [--verbose] [--quiet] [--ui]


Allow output files to overwrite existing files
Print usage summary
Verbose module output
Quiet module output
Force launching GUI dialog


input=name [required]
Name of input uncompressed GNS file from NGA (with .txt extension)
Name for output vector map

Table of contents

DESCRIPTION imports US-NGA GEOnet Names Server (GNS) country files (Gazetteer data) into a GRASS vector points map. The country files can be downloaded from the NGA GNS Web Server (see below). The script generates a vector point map. Only original files can be processed (unzip compressed file first). These GNS files are encoded in UTF-8 which is maintained in the GRASS database.


The current DB connection is used to write the database table.

Generally, column names longer that 10 characters are shortened to 10 characters to meet the DBF column name restrictions. If this is a problem consider choosing another database driver with db.connect.

To filter outliers (points outside of a country), the module can be used to perform point-in-polygon tests. saves only the GNS points falling into a country polygon into the new points map.




GEOnet Names Server files for countries and territories
Column names explanations


Markus Neteler, MPBA Group, ITC-irst, Trento, Italy


Available at: source code (history)

Latest change: Monday Jan 30 19:52:26 2023 in commit: cac8d9d848299297977d1315b7e90cc3f7698730

Main index | Vector index | Topics index | Keywords index | Graphical index | Full index

© 2003-2024 GRASS Development Team, GRASS GIS 8.3.3dev Reference Manual