GeoIP2::Record::LocatiUserpContributed Perl DocumGeoIP2::Record::Location(3pm)
NAME
GeoIP2::Record::Location - Contains data for the location record
associated with an IP address
VERSION
version 2.006002
SYNOPSIS
use 5.008;
use GeoIP2::WebService::Client;
my $client = GeoIP2::WebService::Client->new(
account_id => 42,
license_key => 'abcdef123456',
);
my $insights = $client->insights( ip => '24.24.24.24' );
my $location_rec = $insights->location();
print $location_rec->name(), "\n";
DESCRIPTION
This class contains the location data associated with an IP address.
This record is returned by all the end points except the Country end
point.
METHODS
This class provides the following methods:
$location_rec->accuracy_radius()
The approximate accuracy radius in kilometers around the latitude and
longitude for the IP address. This is the radius where we have a 67%
confidence that the device using the IP address resides within the
circle centered at the latitude and longitude with the provided radius.
This attribute is returned by all end points and location databases
except Country.
$location_rec->average_income()
This returns a non-negative integer representing the average income in
US dollars associated with the requested IP address.
This attribute is only available from the Insights end point and the
GeoIP2 Enterprise database.
$location_rec->latitude()
The approximate latitude of the location associated with the IP
address. This value is not precise and should not be used to identify a
particular address or household.
This attribute is returned by all end points and location databases
except Country.
$location_rec->longitude()
The approximate longitude of the location associated with the IP
address. This value is not precise and should not be used to identify a
particular address or household.
This attribute is returned by all end points and location databases
except Country.
$location_rec->metro-code()
This returns the metro code of the location if the location is in the
US. MaxMind returns the same metro codes as the Google AdWords API
(<https://developers.google.com/adwords/api/docs/appendix/cities-DMAregions>).
This attribute is returned by all end points except the Country end
point.
$location_rec->population_density()
Returns a non-negative integer representing the estimated population
per square kilometer associated with the requested IP address.
This attribute is only available from the Insights end point and the
GeoIP2 Enterprise database.
$location_rec->time_zone()
This returns the time zone associated with a location, as specified by
the IANA Time Zone Database (<http://www.iana.org/time-zones>), e.g.,
"America/New_York".
This attribute is returned by all end points except the Country end
point.
SUPPORT
Bugs may be submitted through
<https://github.com/maxmind/GeoIP2-perl/issues>.
AUTHORS
• Dave Rolsky <drolsky@maxmind.com>
• Greg Oschwald <goschwald@maxmind.com>
• Mark Fowler <mfowler@maxmind.com>
• Olaf Alders <oalders@maxmind.com>
COPYRIGHT AND LICENSE
This software is copyright (c) 2013 - 2019 by MaxMind, Inc.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
perl v5.28.1 2019-07-26 GeoIP2::Record::Location(3pm)
Generated by dwww version 1.14 on Sat Jun 13 11:25:35 CEST 2026.