GeoIP2...ountry(3pm)

💖 GeoIP2::Model::Country — the perl man page, but make it cute ✨

okay bestie, pull up a chair, because this is GeoIP2::Model::Country(3pm) from the User Contributed Perl Documentation section, and she is serving location data 🌍💅

---

🌸 NAME 🌸

GeoIP2::Model::Country — it's the model class for the GeoIP2 Precision: Country and the GeoIP2 Country database. she's the blueprint for the data that comes back, no cap 🎀

---

⭐ VERSION ⭐

version 2.006002 — that's the one, that's the era we're in, periodt 💜

---

🦋 SYNOPSIS 🦋

here's the whole vibe, copy-paste ready, literally:

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";

okay so you make a client with your account_id and license_key, you ask her about an ip, you grab the country record, and you print the iso_code. that's it. that's the whole arc. main character energy from start to finish 👑

---

🌈 DESCRIPTION 🌈

so like, this class is the model for the data you get back from the GeoIP2 Precision: Country web service and the GeoIP2 Country database. she doesn't do the looking-up herself, she's the shape of the answer 🧚✨

---

💅 METHODS 💅

this class provides the following methods, and every single one of them hands you back a record object. no strings attached (well, technically record objects attached, but you get it 🫶):

• $country->continent() — returns a GeoIP2::Record::Continent object with the continent data for the IP you asked about. continent lore, unlocked 🌍
• $country->country() — returns a GeoIP2::Record::Country object with the country data for the requested IP. this one is the country where MaxMind believes the IP is located. emphasis on believes, bestie, she's doing her best 💭
• $country->maxmind() — returns a GeoIP2::Record::MaxMind object with data about your MaxMind account. yes, your account, look at you go 💳✨
• $country->registered_country() — returns a GeoIP2::Record::Country object with the registered country data for the requested IP. this is where the ISP registered that IP block, and it may differ from the user's country. plot twist, fr fr 😭
• $country->represented_country() — returns a GeoIP2::Record::RepresentedCountry object for the country represented by the requested IP. and yes, the represented country may differ from the "country" — think military bases and that whole situation 🪖
• $country->traits() — returns a GeoIP2::Record::Traits object with the traits for the requested IP. the little details, the je ne sais quoi, the ✨traits✨

---

🫶 SUPPORT 🫶

got a bug? don't suffer in silence, bestie. submit it through:

https://github.com/maxmind/GeoIP2-perl/issues

they're nice, I promise 🙈

---

👑 AUTHORS 👑

the icons who built this:

• Dave Rolsky <drolsky@maxmind.com>
• Greg Oschwald <goschwald@maxmind.com>
• Mark Fowler <mfowler@maxmind.com>
• Olaf Alders <oalders@maxmind.com>

four legends, one module, we love to see it 💜

---

🎀 COPYRIGHT AND LICENSE 🎀

this software is copyright (c) 2013 - 2019 by MaxMind, Inc.

it's free software — you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. free as in freedom, slay 🕊️

---

okay and one last thing before you go — this page was rendered by perl v5.36.0 on 2022-11-21, and it lives in the GeoIP2...ountry(3pm) man page slot. that's the whole footer, but make it a farewell 🦋✨

bye bestie, go get those ISO codes 💖