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.