1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
package GeoIP2::Model::Country;
use strict;
use warnings;
our $VERSION = '2.006002';
use Moo;
use GeoIP2::Types qw( HashRef object_isa_type );
use Sub::Quote qw( quote_sub );
use namespace::clean -except => 'meta';
with 'GeoIP2::Role::Model::Location';
## no critic (ProhibitUnusedPrivateSubroutines)
sub _has { has(@_) }
## use critic
__PACKAGE__->_define_attributes_for_keys(
qw( continent country maxmind registered_country traits ));
1;
# ABSTRACT: Model class for the GeoIP2 Precision: Country and GeoIP2 Country
__END__
=pod
=encoding UTF-8
=head1 NAME
GeoIP2::Model::Country - Model class for the GeoIP2 Precision: Country and GeoIP2 Country
=head1 VERSION
version 2.006002
=head1 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";
=head1 DESCRIPTION
This class provides a model for the data returned by the GeoIP2 Precision:
Country web service and the GeoIP2 Country database.
=head1 METHODS
This class provides the following methods, each of which returns a record
object.
=head2 $country->continent()
Returns a L<GeoIP2::Record::Continent> object representing continent data for
the requested IP address.
=head2 $country->country()
Returns a L<GeoIP2::Record::Country> object representing country data for the
requested IP address. This record represents the country where MaxMind
believes the IP is located.
=head2 $country->maxmind()
Returns a L<GeoIP2::Record::MaxMind> object representing data about your
MaxMind account.
=head2 $country->registered_country()
Returns a L<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.
=head2 $country->represented_country()
Returns a L<GeoIP2::Record::RepresentedCountry> object for the country
represented by the requested IP address. The represented country may differ
from the C<country> for things like military bases.
=head2 $country->traits()
Returns a L<GeoIP2::Record::Traits> object representing the traits for the
requested IP address.
=head1 SUPPORT
Bugs may be submitted through L<https://github.com/maxmind/GeoIP2-perl/issues>.
=head1 AUTHORS
=over 4
=item *
Dave Rolsky <drolsky@maxmind.com>
=item *
Greg Oschwald <goschwald@maxmind.com>
=item *
Mark Fowler <mfowler@maxmind.com>
=item *
Olaf Alders <oalders@maxmind.com>
=back
=head1 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.
=cut
|
