dialectica_geography

Installation

  npm i dialectica_geography

Usage example

In Node

var mavenGeo = require('dialectica_geography');

In Html

mavenGeography.js is in dist folder minified version

 <script src="./your path/mavenGeography.js"></script>

In ES6

 import mavenGeo from "dialectica_geography";

List of Tools for countries and Continents

Find tools:

Get list of countries names (Afghanistan, Albania, etc...)

 mavenGeo.getListOfNamesCountries();

Get list of Continents (Europe, North, America, etc...)

 mavenGeo.getListOfContinents();

Get short Name of Country (AF, BH, etc..)

 mavenGeo.getNameShort("name of country");

Get Capital Name of Country

 mavenGeo.getCapital("name of country");

Get Continent of Country

 mavenGeo.getContinent("name of country");

Get Dial code of Country

 mavenGeo.getDial("name of country");

Get Currency code of Country

 mavenGeo.getCurrencyCode("name of country");

Get Currency name of Country

 mavenGeo.getCurrencyName("name of country");

Get Total area of Country

 mavenGeo.getTotalArea("name of country");

Get Geoname ID of Country

 mavenGeo.getGeonameID("name of country");

Get country name from Country short name

For example Greece is the country name for short name 'GR'.

 mavenGeo.getCountryFromShortName("short name of country");

Show country flag

Works only on browser environment not in node.js.

 mavenGeo.showCountryFlag('element to show', 'short name of country');

Example:

  //Suppose in html we have the element
  <img id='imgId'/>

  let element = document.getElementById('imgId');
  //or jquery
  let element = $('#imgId');
  //Country to show flag Greece. Short name of Greece is 'gr'
  mavenGeo.showCountryFlag(element, 'gr');

Get geolocation from ip

 mavenGeo.getGeolocationJsonFromIp("globalObject", ip);

globalObject values are: "window", "node", "local".

When testing from localHost and library is loaded as a script for example

 <script src="./dist/mavenGeography.js"></script>

or from browser address bar like this

file://path..../index.html => (script is inside index.html)

we choose globalObject local to avoid Cors errors => response header Origin: null

Above function returns a promise.

Example:

  let data = await mavenGeo.getGeolocationJsonFromIp("local", "10.0.0.0");
  //We can use also .then(function(res) {})
  //Then we use the function fetchGeolocationFromJson(data) to get location
  let test = mavenGeo.fetchGeolocationFromJson(data);
  console.log(test);
  //The result is for example "52.37559917665907 4.888916015625"

Example node:

  //First we require https node js library and then passing to function
  const https = require('https');
  let data = await mavenGeo.getGeolocationJsonFromIp("node", "10.0.0.0", https);
  //We can use also .then(function(res) {})
  //Then we use the function fetchGeolocationFromJson(data) to get location
  let test = mavenGeo.fetchGeolocationFromJson(data);
  console.log(test);
  //The result is for example "52.37559917665907 4.888916015625"

Get country short name from ip

 mavenGeo.getCountryJsonFromIp("globalObject", ip);

globalObject values are: "window", "node", "local".

When testing from localHost and library is loaded as a script for example

 <script src="./dist/mavenGeography.js"></script>

or from browser address bar like this

file://..../index.html => (script is inside index.html)

we choose globalObject local to avoid Cors errors => response header Origin: null

Above function returns a promise.

Example:

  let data = await mavenGeo.getCountryJsonFromIp("local", "10.0.0.0");
  //We can use also .then(function(res) {})
  //Then we use the function fetchCountryFromJson(data) to get location
  let test = mavenGeo.fetchCountryFromJson(data);
  console.log(test);
  //The result is for example "GR".

Example node:

  //First we require https node js library and then passing to function
  const https = require('https');
  let data = await mavenGeo.getCountryJsonFromIp("node", "10.0.0.0", https);
  //We can use also .then(function(res) {})
  //Then we use the function fetchCountryFromJson(data) to get location
  let test = mavenGeo.fetchCountryFromJson(data);
  console.log(test);
  ////The result is for example "GR".

Check tools:

Check if country belongs to Continent

 mavenGeo.isContinent("name of country", "continent name");

Check if country belongs to APAC

 mavenGeo.isApac("name of country");

Check if country belongs to Nordigs

 mavenGeo.isNordigs("name of country");

Check if country belongs to DACH

 mavenGeo.isDach("name of country");

Check if country belongs to Benelux

 mavenGeo.isBenelux("name of country");