pelias-geonames comes with a command-line tool to make it easier to download/parse and import country data in to Pelias.
npm install$> ./bin/pelias-geonames
Usage: pelias-geonames [options]
Options:
-h, --help output usage information
-V, --version output the version number
-c, --countrycodes list all ISO country datasets available for download
-i, --import [ISO] import geoname data for [ISO country code] in to Pelias
-d, --download [ISO] locally cache data from geonames.org for [ISO country code]
-m, --meta download & update geonames metadata filesFor development it's fastest and easiest to just use the data from your local region.
Eg. To just load data specific to New Zealand you can run:
$> ./bin/pelias-geonames -i nz
streaming datafile from: http://download.geonames.org/export/dump/NZ.zipYou can download and use a cached copy of the geonames data for imports instead:
$> ./bin/pelias-geonames -d nz
downloading datafile from: http://download.geonames.org/export/dump/NZ.zip
data/NZ.zip [===================] 100% 0.0s
$> ./bin/pelias-geonames -i nz
reading datafile from disk at: data/NZ.zipFor a production database where you need the entire world, use:
$> ./bin/pelias-geonames -i all
streaming datafile from: http://download.geonames.org/export/dump/allCountries.zipTo get a list of all available ISO country codes:
$> ./bin/pelias-geonames -c
┌─────┬──────────────────────────────────────────────┬──────────────────────┬───────────┬───────────┐
│ ISO │ Country │ Capital │ Continent │ geonameid │
│ AD │ Andorra │ Andorra la Vella │ EU │ │
│ AE │ United Arab Emirates │ Abu Dhabi │ AS │ 290557 │
│ AF │ Afghanistan │ Kabul │ AS │ 1149361 │
│ AG │ Antigua and Barbuda │ St. John's │ NA │ 3576396 │The metadata shipped with the repo can get out-of-date, to pull the latest metadata:
$> ./bin/pelias-geonames -m
countryInfo.txt [===================] 100% 0.0s
admin1CodesASCII.txt [===================] 100% 0.0s
admin2Codes.txt [===================] 100% 0.0sThe importer can be configured from your local pelias-config in the imports.geonames object:
{
"imports": {
"geonames": {
"datapath": "/path/to/geonames/data",
"adminLookup": false
}
}
}The following are all optional:
datapath: the path to geonames data. Defaults to a directory inside the importer.adminLookup- set this to true to fill in the administrative hierarchy (ie, country, state, county, etc. names), at the cost of higher memory requirements and slower import times. See thepelias/wof-admin-lookupreadme for more information on how this works and setup documentation (note: this will require downloading the full Who's on First dataset)
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent