NAME

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

VERSION

version 0.0301

SYNOPSIS

  use 5.008;

  use GeoIP2::WebService::Client;

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

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

  my $location_rec = $omni->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 Omni 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>

CONTRIBUTOR

Graham Knop <haarg@haarg.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2013 by MaxMind, Inc..

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)

cpanm GeoIP2

perl -MCPAN -e shell
install GeoIP2