Skip to content

Importer for Who's on First gazetteer

License

Notifications You must be signed in to change notification settings

pixeldublu/whosonfirst

 
 

Repository files navigation

This repository is part of the Pelias project. Pelias is an open-source, open-data geocoder originally sponsored by Mapzen. Our official user documentation is here.

Pelias Who's on First Data Importer

Greenkeeper badge

Overview

pelias-whosonfirst is a tool used for importing data from the Who's On First project from local files into a Pelias ElasticSearch store.

Requirements

Node.js is required.

See Pelias software requirements for required and recommended versions.

Quickstart Usage

To install the required Node.js module dependencies, download data for the entire planet (20GB+) and execute the importer, run:

npm install
npm run download
npm start

Configuration

This importer is configured using the pelias-config module. The following configuration options are supported by this importer.

imports.whosonfirst.datapath

  • Required: yes
  • Default: ``

Full path to where Who's on First data is located (note: the included downloader script will automatically place the WOF data here, and is the recommended way to obtain WOF data)

imports.whosonfirst.importPlace

  • Required: no
  • Default: ``

Set to a WOF ID or array of IDs to import data only for descendants of those records, rather than the entire planet.

You can use the Who's on First Spelunker or the source_id field from any WOF result of a Pelias query to determine these values.

Specifying a value for importPlace will download the full planet SQLite database (27GB). Support for individual country downloads may be added in the future

imports.whosonfirst.importVenues