Home

Awesome

Greenkeeper badge

query-overpass NPM version Build Status

Make queries to OpenStreetMap's overpass API and output as GeoJSON.

cli

install:

$ npm install -g query-overpass

use (Bash):

$ echo 'node(57.7,11.9,57.8,12.0)[amenity=bar];out;' | query-overpass

use (Windows cmd):

$ echo node(57.7,11.9,57.8,12.0)[amenity=bar];out; | query-overpass

Optionally, a file containing the query can be passed as the first argument:

$ query-overpass query.ql

Goes well together with other command line tools, like for example geojsonio-cli:

$ npm install -g geojsonio-cli
$ echo 'node(57.7,11.9,57.8,12.0)[amenity=bar];out;' | query-overpass | geojsonio

You can also provide the URL where the Overpass API is located:

$ query-overpass --overpass-url http://my.overpass-provider.org/

The default is to use https://overpass-api.de/api/interpreter.

You can also flatten each GeoJSON feature, making it more easily processable by other software and tools

$ query-overpass --flat-properties

The default behaviour, without adding --flat-properties is to use false to be consistent with previous version.

usage

Installation is easy with npm:

$ npm install query-overpass

api

query-overpass exports a single function:

query_overpass(query, callback, options)

Performs the provided query and calls the callback when done. The callback is of the form

callback(error, data)

Where error is an object containing message and statusCode if an error occured, or undefined if no error occured. data will be the query response as an GeoJSON object.

The options supported at the moment are