The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

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