NAME

WWW::HostipInfo - get a country and city information from ip address via www.hostip.info API.

SYNOPSIS

use WWW::HostipInfo;

my $hostip = new WWW::HostipInfo;
my $ip     = 'xxx.xxx.xxx.xxx';
my $info   = $hostip->get_info($ip);

if($info->is_private){ warn "This is a private ip address." }

my $country_code = $info->code;
my $city_name    = $info->city;
my $region       = $info->region; # if any

$info = $hostip->recent_info->country_name; # fetch most recent data

print WWW::HostipInfo->new($ip)->get_info->city; # shortcut

DESCRIPTION

This module gets a country and city information from ip address via www.hostip.info API.

METHODS

new

$hostip = WWW::HostipInfo->new();

$hostip = WWW::HostipInfo->new( $ip );

$hostip = WWW::HostipInfo->new( { ip => $ip, url => $url, ua => $user_agent } );

returns a WWW::HostipInfo object. This method can take an ip address or a hash reference optionally.

ip

$ip = $hostip->ip([$ip]);

setter / getter to the ip address.

url

$url = $hostip->url([$url]);

setter / getter to the HostipInfo API. Default is api.hostip.info.

ua

$user_agent = $hostip->ua([$user_agent]);

setter / getter to the user agent. Default is LWP::UserAgent.

get_info

$info = $hostip->get_info();

returns a WWW::HostipInfo::Info object. If the method can't get a information, will return undef.

recent_info

$info = $hostip->get_info();

returns a WWW::HostipInfo::Info object.

WWW::HostipInfo::Info

With get_info(), WWW::HostipInfo object returns WWW::HostipInfo::Info object.

METHODS

getters for informations.

country_code

return the cuntry code. If private ip address is used, the code is 'XX'.

code

an alias to country_code

country_name

return the cuntry name.

name

an alias to country_name

country

an alias to country_name

city

return the city name as long as it is not unknown.

region

return state code if the coutnry is US.

latitude

longitude

ip

is_private

If private ip address is used, returns true.

has_unknown_city

If the object has no data for city, returns true.

has_unknown_country

If the object has no data for country, returns true.

SEE ALSO

http://www.hostip.info/, LWP

AUTHOR

Makamaka Hannyaharamitu, <makamaka[at]cpan.org>

COPYRIGHT AND LICENSE

Copyright 2005, 2009 by Makamaka Hannyaharamitu

This library is licensed under GNU GENERAL PUBLIC LICENSE

cpanm WWW::HostipInfo

perl -MCPAN -e shell
install WWW::HostipInfo