1v.in.geonames(1)            GRASS GIS User's Manual           v.in.geonames(1)
2
3
4

NAME

6       v.in.geonames   -  Imports  geonames.org  country  files  into a vector
7       points map.
8

KEYWORDS

10       vector, import, gazetteer
11

SYNOPSIS

13       v.in.geonames
14       v.in.geonames --help
15       v.in.geonames input=name output=name  [--overwrite]  [--help]   [--ver‐
16       bose]  [--quiet]  [--ui]
17
18   Flags:
19       --overwrite
20           Allow output files to overwrite existing files
21
22       --help
23           Print usage summary
24
25       --verbose
26           Verbose module output
27
28       --quiet
29           Quiet module output
30
31       --ui
32           Force launching GUI dialog
33
34   Parameters:
35       input=name [required]
36           Name of uncompressed geonames file (with .txt extension)
37
38       output=name [required]
39           Name for output vector map
40

DESCRIPTION

42       v.in.geonames  imports Geonames.org country files (Gazetteer data) into
43       a GRASS vector points map. The country files can be downloaded from the
44       GeoNames  Data Dump Server. Only original files can be processed (unzip
45       compressed file first). These Geonames files are encoded in UTF-8 which
46       is maintained in the GRASS database.
47

NOTES

49       v.in.geonames calls v.in.ascii to import data into GRASS.
50
51       The  current  DB  connection  is  used to write the database table (see
52       db.connect). If importing into a  DBF  database,  the  original  column
53       names  longer that 10 characters are shortened to 10 characters to meet
54       the DBF column name restrictions. If this is a problem consider  choos‐
55       ing another database driver with db.connect (eg. to SQLite driver).
56
57       The main ’geoname’ table has the following fields
58       geonameid         : integer id of record in geonames database
59       name              : name of geographical point (utf8) varchar(200)
60       asciiname         : name of geographical point in plain ascii characters, varchar(200)
61       alternatenames    : alternatenames, comma separated varchar(4000)
62       latitude          : latitude in decimal degrees (wgs84)
63       longitude         : longitude in decimal degrees (wgs84)
64       feature class     : see http://www.geonames.org/export/codes.html, char(1)
65       feature code      : see http://www.geonames.org/export/codes.html, varchar(10)
66       country code      : ISO-3166 2-letter country code, 2 characters
67       cc2               : alternate country codes, comma separated, ISO-3166 2-letter country code, 60 characters
68       admin1 code       : fipscode (subject to change to iso code), isocode for the us and ch, see file admin1Codes.txt for display names of this code; varchar(20)
69       admin2 code       : code for the second administrative division, a county in the US, see file admin2Codes.txt; varchar(80)
70       admin3 code       : code for third level administrative division, varchar(20)
71       admin4 code       : code for fourth level administrative division, varchar(20)
72       population        : integer
73       elevation         : in meters, integer
74       gtopo30           : average elevation of 30’x30’ (ca 900mx900m) area in meters, integer
75       timezone          : the timezone id (see file http://download.geonames.org/export/dump/timeZones.txt)
76       modification date : date of last modification in yyyy-MM-dd format
77

EXAMPLE

79       Download and import geonames for Czech Republic.
80       wget http://download.geonames.org/export/dump/CZ.zip
81       unzip CZ.zip
82       v.in.geonames input=CZ.txt output=geonames_cz
83

REFERENCES

85           •   GeoNames Web site
86
87           •   GeoNames Data Dump Server
88

SEE ALSO

90        db.connect, v.in.ascii, v.select
91

AUTHOR

93       Markus Neteler
94

SOURCE CODE

96       Available at: v.in.geonames source code (history)
97
98       Accessed: Saturday Jan 21 20:41:03 2023
99
100       Main  index  | Vector index | Topics index | Keywords index | Graphical
101       index | Full index
102
103       © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
104
105
106
107GRASS 8.2.1                                                   v.in.geonames(1)