Pelias Point-in-Polygon Service
This service provides Who's on First-based point-in-polygon lookup functionality.
Node.js is required.
See Pelias software requirements for required and recommended versions.
$ git clone firstname.lastname@example.org:pelias/pip-service.git$ cd pip-service$ npm install
pelias-pip-service npm module can be found here:
To start the PiP service, use the start script
./bin/start, or use
It will look for Who's on First data in the place configured in
Requests are made to the endpoint in the format:
Because pelias/whosonfirst is a dependency of this package, its downloader can be used:
npm run download
This will download Who's on First data using the same configuration options from
pelias.json as the whosonfirst downloader.
That means it will automatically put the data in the place the service will expect to load it from.
The service supports the DNT header by looking for one of the following headers:
When any of these headers are supplied in the request (with any value), the request log will output
/[removed]/[removed] instead of the longitude/latitude values.
Configuration via Environment Variables
The service supports additional environment variables that affect its operation:
||The network address that the PiP service will bind to. Defaults to whatever the current Node.js default is, which is currently to listen on
||The TCP port that the PiP service will use for incoming network connections|