README.md
1Geo::IP2Location
2================
3
4This Perl module provides fast lookup of country, region, city, latitude, longitude, ZIP code, time zone, ISP name, domain name, connection type, IDD code, area code, weather station code and station, MCC, MNC, mobile carrier brand, elevation and usage type from IP address using IP2Location database. This module uses a file based .BIN database available at https://www.ip2location.com upon subscription. This database contains IP blocks as keys and other information as values. It supports IP address in IPv4 or IPv6.
5
6This module can be used in many types of project such as:
7
8 1) select the geographically closest mirror
9 2) analyze web server logs to determine the countries of visitors
10 3) credit card fraud detection
11 4) software export controls
12 5) display native language and currency
13 6) prevent password sharing and abuse of service
14 7) geotargeting in advertisement
15
16The database will be updated in monthly basis for the greater accuracy. Free sample DB1 database is available at /samples directory or download it online from https://www.ip2location.com/developers.
17
18The complete database is available at https://www.ip2location.com under premium subscription. Meanwhile, free creative-common database is also available at https://lite.ip2location.com upon sign-up.
19
20
21## INSTALLATION
22
23To install this module type the following:
24
25 perl Makefile.PL
26 make
27 make test
28 make install
29
30## DEPENDENCIES (IP2LOCATION BIN DATA FILE)
31
32This library requires IP2Location BIN data file to function. You may download the BIN data file at
33
34* IP2Location LITE BIN Data (Free): https://lite.ip2location.com
35* IP2Location Commercial BIN Data (Comprehensive): https://www.ip2location.com
36
37
38## IPv4 BIN vs IPv6 BIN
39
40Use the IPv4 BIN file if you just need to query IPv4 addresses.
41
42Use the IPv6 BIN file if you need to query BOTH IPv4 and IPv6 addresses.
43
44
45## COPYRIGHT AND LICENCE
46
47Copyright (C) 2018 by IP2Location.com
48
49This library is licensed under LGPLv3; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.
50