IP2Location

This Haskell package 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, weather station name, mcc, mnc, mobile brand, elevation, usage type, address type and IAB category from IP address by using IP2Location database. This package 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, weather station name, mcc, mnc, mobile brand, elevation, usage type, address type and IAB category as values. It supports both IP addresses in IPv4 and IPv6.

IP2Location LITE BIN databases are available for free at http://lite.ip2location.com/

Documentation

data Meta

Contains the BIN database file metadata.

Instances

Show Meta

Defined in IP2Location

Methods

showsPrec :: Int -> Meta -> ShowS

show :: Meta -> String

showList :: [Meta] -> ShowS

data IP2LocationRecord

Contains geolocation results.

Constructors

IP2LocationRecord

Fields

• country_short :: String

  Country code

• country_long :: String

  Country name

• region :: String

  Region name

• city :: String

  City name

• isp :: String

  ISP name

• latitude :: Float

  Latitude

• longitude :: Float

  Longitude

• domain :: String

  Domain name

• zipcode :: String

  ZIP/Postal code

• timezone :: String

  Timezone

• netspeed :: String

  Network speed

• iddcode :: String

  IDD code

• areacode :: String

  Area code

• weatherstationcode :: String

  Weather station code

• weatherstationname :: String

  Weather station name

• mcc :: String

  Mobile country code

• mnc :: String

  Mobile network code

• mobilebrand :: String

  Carrier brand

• elevation :: Float

  Elevation in meters

• usagetype :: String

  Usage type

• addresstype :: String

  Address type

• category :: String

  Category

Instances

Show IP2LocationRecord

Defined in IP2Location

Methods

showsPrec :: Int -> IP2LocationRecord -> ShowS

show :: IP2LocationRecord -> String

showList :: [IP2LocationRecord] -> ShowS

getAPIVersion :: String

The getAPIVersion function returns a string containing the API version.

doInit :: String -> IO Meta

The doInit function returns the Meta record containing metadata from the BIN database file. It takes one argument, of type String, which is the path to the BIN database file.

doQuery :: String -> Meta -> String -> IO IP2LocationRecord

The doQuery function returns an IP2LocationRecord containing geolocation data for an IP address. It takes 3 arguments; the BIN database file path (String), the metadata from doInit function (Meta record) & either IPv4 or IPv6 address (String).