owapis-js

This is the official ES2015 JS SDK for the Otherwise SAS Apis (owsas.com)

Installation

$> npm i --save owapis-js

Usage

const OwApis = require('owapis-js');
 
// initialize first (obligatory)
OwApis.initialize('<YOUR-API-KEY>');

API docs

/**
* Reverse geocodes any given lat lng using Google
* @param {number} lat 
* @param {number} lang 
* @return {Promise<any[]>}
*/
static reverseGeocode(lat, lng);
 
/**
* Geocodes any given string using Google
* @param {string} string  The string to geocode
* @return {Promise<any[]>}
*/
static geocode(string);
 
/**
* Gets own ip information using GeoLite2-City
* @return {Promsie<any>} 
*/
static getOwnIPInfo();
 
/**
* Gets ip information using GeoLite2-City
* @param {string} ipAddr The ip address
* @return {Promsie<any>} 
*/
static getIPInfo(ipAddr);
 
/**
* Gets information about a country with given countryCode
* @param {string} countryCode 
* @return {Promsie<any[]>}
*/
static getCountryInfo(countryCode);
 
/**
* Gets information about a country with given countryCode
* @param {string} countryCode 
* @return {Promsie<any[]>}
*/
static getCountryInfoByCCA3(countryCode);
 
/**
* Gets information about a country with given countryCode
* @param {string} countryCode 
* @return {Promsie<any[]>}
*/
static getCountryInfoByCCA2(countryCode);
 
/**
* Gets information about a country with given code
* @param {string} code 
* @return {Promsie<any>} 
*/
static getCountriesByCallingCode(code);
 
/**
* Gets information about a country with given code
* @param {string} code 
* @return {Promsie<any[]>}
*/
static getCountriesByCurrencyCode(code);
 
/**
* Gets all the world languages
* @return {Promsie<any[]>}
*/
static getWorldLanguages();
 
/**
* Gets information about a language with given langCode
* @param {string} langCode 
* @return {Promsie<any[]>}
*/
static getLanguageInfo(langCode);
 
/**
* Makes a request to the OWSAS Api. Feel free to use it if you 
* know the urls of the API
* @param {string} method 
* @param {string} url 
* @param {{query:any, body:any}} options 
* @return {Promise<any>|Promise<any[]>}
*/
static _request(method, url, options = {});

Credits

Juan Camilo Guarín Peñaranda
Otherwise SAS, http://owsas.com
Hecho con <3 en Colombia

License

MIT