https://github.com/dnmfarrell/www-ipinfo

https://github.com/dnmfarrell/www-ipinfo

Last synced: 12 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/dnmfarrell/www-ipinfo
• Owner: dnmfarrell
• License: other
• Created: 2014-09-18T02:55:56.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2014-10-15T00:19:27.000Z (over 11 years ago)
• Last Synced: 2025-12-13T06:35:46.990Z (6 months ago)
• Language: Perl
• Size: 152 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.pod
  • Changelog: Changes
  • License: LICENSE

Awesome Lists containing this project

README

          
=pod

=encoding UTF-8

=head1 NAME

WWW::ipinfo - Returns your ip address and geolocation data using L

=head1 VERSION

version 0.05

=head1 SYNOPSIS

    use WWW::ipinfo;

    my $ipinfo = get_ipinfo();

    my $city = $ipinfo->{city};

=head1 EXPORTS

Exports the C function.

=head1 FUNCTIONS

=head2 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};

=head1 SEE ALSO

L - a similar module that returns your ip address

L - a similar module that returns your ip address

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

=head1 CONTRIBUTORS

John D Jones III

=head1 AUTHOR

David Farrell 

=head1 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.

=cut