ip2location-nodejs

    9.0.0 • Public • Published

    npm npm

    IP2Location Node.js Module

    This Node.js module provides a fast lookup of country, region, city, latitude, longitude, ZIP code, time zone, ISP, domain name, connection type, IDD code, area code, weather station code, station name, mcc, mnc, mobile brand, elevation, usage type, address type and IAB category from IP address by using IP2Location database. This module uses a file based database available at IP2Location.com. This database simply contains IP blocks as keys, and other information such as country, region, city, latitude, longitude, ZIP code, time zone, ISP, domain name, connection type, IDD code, area code, weather station code, station name, mcc, mnc, mobile brand, elevation, usage type, address type and IAB category as values. It supports both IP address in IPv4 and IPv6.

    This module can be used in many types of projects such as:

    • select the geographically closest mirror
    • analyze your web server logs to determine the countries of your visitors
    • credit card fraud detection
    • software export controls
    • display native language and currency
    • prevent password sharing and abuse of service
    • geotargeting in advertisement

    The database will be updated on a monthly basis for greater accuracy.

    The complete database is available at https://www.ip2location.com under Premium subscription package. The free LITE database is available at https://lite.ip2location.com.

    As an alternative, this module can also call the IP2Location Web Service. This requires an API key. If you don't have an existing API key, you can subscribe for one at the below:

    https://www.ip2location.com/web-service/ip2location

    Installation

    To install this module type the following:

    npm install ip2location-nodejs
    

    QUERY USING THE BIN FILE

    Dependencies

    This library requires IP2Location BIN data file to function. You may download the BIN data file at

    IPv4 BIN vs IPv6 BIN

    Use the IPv4 BIN file if you just need to query IPv4 addresses. If you query an IPv6 address using the IPv4 BIN, you'll see the IPV6_NOT_SUPPORTED error.

    Use the IPv6 BIN file if you need to query BOTH IPv4 and IPv6 addresses.

    Methods

    Below are the methods supported in this module.

    Method Name Description
    open Opens the IP2Location BIN data for lookup.
    getAll Returns the geolocation information in an object.
    getCountryShort Returns the country code.
    getCountryLong Returns the country name.
    getRegion Returns the region name.
    getCity Returns the city name.
    getISP Returns the ISP name.
    getLatitude Returns the latitude.
    getLongitude Returns the longitude.
    getDomain Returns the domain name.
    getZIPCode Returns the ZIP code.
    getTimeZone Returns the time zone.
    getNetSpeed Returns the net speed.
    getIDDCode Returns the IDD code.
    getAreaCode Returns the area code.
    getWeatherStationCode Returns the weather station code.
    getWeatherStationName Returns the weather station name.
    getMCC Returns the mobile country code.
    getMNC Returns the mobile network code.
    getMobileBrand Returns the mobile brand.
    getElevation Returns the elevation in meters.
    getUsageType Returns the usage type.
    getAddressType Returns the address type.
    getCategory Returns the IAB category.
    close Closes BIN file and resets metadata.

    Usage

    const {IP2Location} = require("ip2location-nodejs");
    
    let ip2location = new IP2Location();
    
    ip2location.open("./DB25.BIN");
    
    testip = ['8.8.8.8', '2404:6800:4001:c01::67'];
    
    for (var x = 0; x < testip.length; x++) {
    	result = ip2location.getAll(testip[x]);
    	for (var key in result) {
    		console.log(key + ": " + result[key]);
    	}
    	console.log("--------------------------------------------------------------");
    }
    
    ip2location.close();

    QUERY USING THE IP2LOCATION WEB SERVICE

    Methods

    Below are the methods supported in this module.

    Method Name Description
    open 3 input parameters:
    1. IP2Location API Key.
    2. Package (WS1 - WS25)
    3. Use HTTPS or HTTP
    lookup Query IP address. This method returns an object containing the geolocation info.
    • country_code
    • country_name
    • region_name
    • city_name
    • latitude
    • longitude
    • zip_code
    • time_zone
    • isp
    • domain
    • net_speed
    • idd_code
    • area_code
    • weather_station_code
    • weather_station_name
    • mcc
    • mnc
    • mobile_brand
    • elevation
    • usage_type
    • address_type
    • category
    • continent
      • name
      • code
      • hemisphere
      • translations
    • country
      • name
      • alpha3_code
      • numeric_code
      • demonym
      • flag
      • capital
      • total_area
      • population
      • currency
        • code
        • name
        • symbol
      • language
        • code
        • name
      • idd_code
      • tld
      • translations
    • region
      • name
      • code
      • translations
    • city
      • name
      • translations
    • geotargeting
      • metro
    • country_groupings
    • time_zone_info
      • olson
      • current_time
      • gmt_offset
      • is_dst
      • sunrise
      • sunset
      getCredit() This method returns the web service credit balance in an object.

      Usage

      const {IP2LocationWebService} = require("ip2location-nodejs");
      
      let ws = new IP2LocationWebService();
      
      let ip = "8.8.8.8";
      let apiKey = "YOUR_API_KEY";
      let apiPackage = "WS25";
      let useSSL = true;
      
      // addon and lang to get more data and translation (leave both blank if you don't need them)
      let addon = "continent,country,region,city,geotargeting,country_groupings,time_zone_info";
      let lang = "fr";
      
      ws.open(apiKey, apiPackage, useSSL);
      
      ws.lookup(ip, addon, lang, (err, data) => {
      	if (!err) {
      		console.log(data);
      		
      		ws.getCredit((err, data) => {
      			if (!err) {
      				console.log(data);
      			}
      		});
      	}
      });

      Install

      npm i ip2location-nodejs

      DownloadsWeekly Downloads

      3,947

      Version

      9.0.0

      License

      MIT

      Unpacked Size

      44.8 kB

      Total Files

      5

      Last publish

      Collaborators

      • ip2location-nodejs