NAME

       v.in.geonames  - Imports geonames.org country files into a GRASS vector points map.

KEYWORDS

       vector, import, gazetteer

SYNOPSIS

       v.in.geonames
       v.in.geonames help
       v.in.geonames input=name output=name  [--overwrite]  [--verbose]  [--quiet]

   Flags:
       --overwrite
           Allow output files to overwrite existing files

       --verbose
           Verbose module output

       --quiet
           Quiet module output

   Parameters:
       input=name
           Uncompressed geonames file from (with .txt extension)

       output=name
           Name for output vector map

DESCRIPTION

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

NOTES

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

       If importing into a DBF database, the original 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.  The main 'geoname' table has the following fields
       geonameid         : integer id of record in geonames database
       name              : name of geographical point (utf8) varchar(200)
       asciiname         : name of geographical point in plain ascii characters, varchar(200)
       alternatenames    : alternatenames, comma separated varchar(4000)
       latitude          : latitude in decimal degrees (wgs84)
       longitude         : longitude in decimal degrees (wgs84)
       feature class     : see http://www.geonames.org/export/codes.html, char(1)
       feature code      : see http://www.geonames.org/export/codes.html, varchar(10)
       country code      : ISO-3166 2-letter country code, 2 characters
       cc2               : alternate  country  codes,  comma  separated,  ISO-3166  2-letter  country  code,  60
       characters
       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)
       admin2 code       : code  for  the  second  administrative  division,  a  county  in  the  US,  see  file
       admin2Codes.txt; varchar(80)
       admin3 code       : code for third level administrative division, varchar(20)
       admin4 code       : code for fourth level administrative division, varchar(20)
       population        : integer
       elevation         : in meters, integer
       gtopo30           : average elevation of 30'x30' (ca 900mx900m) area in meters, integer
       timezone          : the timezone id (see file http://download.geonames.org/export/dump/timeZones.txt)
       modification date : date of last modification in yyyy-MM-dd format

SEE ALSO

        db.connect, v.select

REFERENCES

       GeoNames Web site
       GeoNames Data Dump Server

AUTHOR

       Markus Neteler

       Last changed: $Date: 2011-11-08 01:42:51 -0800 (Tue, 08 Nov 2011) $

       Full index

       © 2003-2013 GRASS Development Team

GRASS 6.4.3                                                                                v.in.geonames(1grass)