A utility to build custom gazetteer packages for Recogito from GeoNames data.
Edit the config.py file according to your needs. Use the countries property to configure which countries
to include in your gazetteer file.
countries = [ 'AT' ] You can also use one of the pre-configured lists as a shortcut.
countries = PRESETS['SOUTH_AMERICA']An empty list will create a gazetteer dumpfile with all of GeoNames (see note below).
In most cases, it will be useful to include only 'notable' places. When setting the
require_concordance property to True, the package will only include GeoNames features
that have a corresponding entry on Wikipedia or Wikidata. (This will reduce the full GeoNames
dataset to approx. 1.6 million records.)
# If set to True, the export will only include GeoNames features
# that have a Wikipedia or Wikidata link
require_concordance = TrueRun python download.py to download the country data files from GeoNames.
Run python convert.py to build the gazetteer package. The result file will be in the output
folder, in two versions:
- A JSONL file, compatible with the Linked Places specification
- A compressed copy in .gz format
Attention: requires admin privileges on your Recogito instance!
On your Recogito server, go to /admin/authorities. Click Add Authority File.
Fill the gazetteer properties. You are free to select an identifier, short name, full name, short code and colour of your choice. For the URL pattern, use the following (Recogito uses this to truncate the gazetteer URIs in the UI for display purposes):
http://sws.geonames.org/
In the upload file field, pick your dump file (gzipped version) and click Save.
Note that importing large gazetteer data files to Recogito is currently a slow process. Avoid the use of a full GeoNames dataset, if possible. Ideally, large gazetteers (>150.000 places) should be imported first, into a new & empty Recogito instance.
- Add continents and non-country features
- Include natural earth polygon shapes
- Use world continent borders from the UCLA Geoportal