geo.what3words

Turns WGS84 coordinates into three words or OneWords and vice-versa using what3words.com HTTP API

JS.Geo.What3Words

A node.js wrapper for the What3Words API.

Turns WGS84 coordinates into three words or OneWords and vice-versa using what3words.com HTTP API

Further information on the What3Words API and its features is available at http://what3words.com/api/reference.

Installing using npm (node package manager):

npm install what3words

If you don't have npm installed or don't want to use it:

cd ~/.node_libraries
git clone git://github.com/lokku/js-geo-what3words.git what3words

Please note that parts of this library depend on unirest by Mashape. This library needs to be installed for the API to work.

var What3Words = require('./lib/geo.what3words.js'),
    w3w = new What3Words('YOUR_API_KEY');

The constructor function also takes an optional configuration object:

var What3Words = require('./lib/geo.what3words.js'),
    w3w = new What3Words('YOUR_API_KEY', {
        language: ''ru',
        userAgent: ''Your custom UA'
    });
w3w.wordsToPosition({
  words: 'prom.cape.pump'
}).then(function(response) {
  console.log(response); // 51.484463,-0.195405 
}).catch(function(err) {
  console.log(err);
});

Optional parameters:

  • full returns the full response of the api
  • lang sets a different language for the response
w3w.positionToWords({
  position: '51.484463,-0.195405'
}).then(function(response) {
 
  console.log(response); //prom.cape.pump 
});

Optional parameters:

  • full returns the full response of the api
  • lang sets a different language for the response
w3w.oneWordAvailable({
  word: 'nestoria'
}).then(function(response) {
 
  console.log(response); // 1 
});

Optional parameters:

  • full returns the full response of the api
  • lang sets a different language for the response
w3w.getLanguages({}).then(function(response) {
  console.log(response); // [ 'de', 'en', 'es', 'fr', 'pt', 'ru', 'sv', 'tr' ] 
});

Optional parameters:

  • full returns the full response of the api
  • lang sets a different language for the response

All the methods return a Bluebird promise.

JS.Geo.What3Words is licensed under the MIT License. (See LICENSE)