NAME

GeoIP2::Model::Country - Model class for the GeoIP2 Precision: Country and GeoIP2 Country

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 $country = $client->country( ip => '24.24.24.24' );
  my $country_rec = $country->country();
  print $country_rec->iso_code(), "\n";

DESCRIPTION

This class provides a model for the data returned by the GeoIP2 Precision: Country web service and the GeoIP2 Country database.

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.

$country->traits()

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

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