The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
GeoIP2-2.002000
River stage one • 2 direct dependents • 2 total dependents
16 ++
/ GeoIP2::Record::Location

NAME

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

VERSION

version 2.002000

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

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

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

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

  • Mark Fowler <mfowler@maxmind.com>

  • Olaf Alders <oalders@maxmind.com>

COPYRIGHT AND LICENSE

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