/ 
GeoIP2-2.001000
River stage one • 2 direct dependents • 2 total dependents
/ GeoIP2::Record::Location

NAME

GeoIP2::Record::Location - Contains data for the location record associated with an IP address

VERSION

version 2.001000

SYNOPSIS

use 5.008;

use GeoIP2::WebService::Client;

my $client = GeoIP2::WebService::Client->new(
    user_id     => 42,
    license_key => 'abcdef123456',
);

my $insights = $client->insights( ip => '24.24.24.24' );

my $location_rec = $insights->location();
say $location_rec->name();

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()

This returns the radius in kilometers around the specified location where the IP address is likely to be.

This attribute is only available from the Insights end point.

$location_rec->latitude()

This returns the latitude of the location as a floating point number.

This attribute is returned by all end points except the Country end point.

$location_rec->longitude()

This returns the longitude of the location as a floating point number.

This attribute is returned by all end points except the Country end point.

$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->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.

AUTHORS

  • Dave Rolsky <drolsky@maxmind.com>

  • Greg Oschwald <goschwald@maxmind.com>

  • Olaf Alders <oalders@maxmind.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 - 2014 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.