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.