nodejs-nominatim

This NodeJS application is use to proxy the reverse geocoding request for the Piwigo integration.

This is mainly to hide my API key and to avoid the limit requests set by the pickpoint.io API, eg: 2500 per day free.

It allow to cache the result. No IP are log.

The webservice proxy API is running on OpenShift

The application run on NodeJS.

The data are store in MongoDB.

See https://nominatim-xbgmsharp.rhcloud.com

From http://wiki.openstreetmap.org/wiki/Nominatim

• MapQuest Free 15,000 transactions/month
• Pick Point Free 2,500 API calls/day
• OpenCage Geocoder Free 2,500 requests per day

Installing

• Clone the repository

git clone https://github.com/xbgmsharp/nodejs-nominatim
cd nodejs-nominatim

• Install dependencies

$ npm install

• Start the application

$ npm start

Or manually, you can define an IP and the PORT by using environment variables.

$ HOST=127.0.0.1 PORT=8080 DEBUG=nodejs-nominatim node bin/www

• Point your browser to: http://localhost:8080/
• Enjoy!

Usage

Query format:

/api/:lat/:lon/:lang?

If not specify the lang parameter fallback to en.

First query:

$ curl -sv "http://localhost:8080/api/48.858366667/2.2942166667" | jq .
...
< Cache-Control: public, max-age=2592000000
< X-Cache: MISS

Second query:

$ curl -sv "http://localhost:8080/api/:lat/:lon" | jq .
...
< Cache-Control: public, max-age=2592000000
< X-Cache: HIT

Licence

nodejs-nominatim is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

See http://www.gnu.org/licenses/gpl.html.