NAME

WWW::ipinfo - Returns your ip address and geolocation data using http://ipinfo.io

VERSION

version 0.05

SYNOPSIS

use WWW::ipinfo;

my $ipinfo = get_ipinfo();
my $city = $ipinfo->{city};

EXPORTS

Exports the get_ipinfo function.

FUNCTIONS

get_ipinfo

Returns a hashref containing ip and geolocation data. Optionally you can provide an ip address argument to get a hashref for an IP that is not your own. Works with IPv4 and IPv6 addresses.

{
  ip        => "198.115.6.53",
  hostname" => "cpe-198-115-6-53.nyc.res.rr.com",
  city      => "New York",
  region    => "New York",
  country   => "US",
  loc       => "43.7805,-79.9512",
  org       => "Time Warner Cable Internet LLC",
  postal    => "11154"
}

Example

use WWW::ipinfo;

my $ipinfo = get_ipinfo(); # get IP info for your IP address
my $ip = $ipinfo->{ip}; # your IP address

my $other_ipinfo = get_ipinfo('FE80::0202:B3FF:FE1E:8329'); #works with IPv6 addresses
my $country = $other_ipinfo->{country};

SEE ALSO

WWW::curlmyip - a similar module that returns your ip address

WWW::hmaip - a similar module that returns your ip address

WWW::IP - a module that uses up to 3 services to retrieve your IP address

CONTRIBUTORS

John D Jones III

AUTHOR

David Farrell <sillymoos@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by David Farrell.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.