NAME

GeoIP2::Model::Country - Model class for the GeoIP2 Country end point

VERSION

version 0.040000

SYNOPSIS

  use 5.008;

  use GeoIP2::WebService::Client;

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

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

  my $country_rec = $country->country();
  say $country_rec->iso_code();

DESCRIPTION

This class provides a model for the data returned by the GeoIP2 Country end point.

METHODS

This class provides the following methods, each of which returns a record object.

$country->continent()

Returns a GeoIP2::Record::Continent object representing continent data for the requested IP address.

$country->country()

Returns a GeoIP2::Record::Country object representing country data for the requested IP address. This record represents the country where MaxMind believes the IP is located.

$country->maxmind()

Returns a GeoIP2::Record::MaxMind object representing data about your MaxMind account.

$country->registered_country()

Returns a GeoIP2::Record::Country object representing the registered country data for the requested IP address. This record represents the country where the ISP has registered a given IP block and may differ from the user's country.

$country->represented_country()

Returns a GeoIP2::Record::RepresentedCountry object for the country represented by the requested IP address. The represented country may differ from the country for things like military bases or embassies.

$country->traits()

Returns a GeoIP2::Record::Traits object representing the traits for the requested IP address.

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; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.