GeoIP2...Traits(3pm)

💖 GeoIP2::Record::Traits 💖

okay bestie, welcome to the GeoIP2::Record::Traits page — it's a 3pm man page from the User Contributed Perl Documentation crew, and it's literally all about the traits record that gets attached to an IP address. buckle up, it's giving "small class, big personality". 🎀

---

✨ NAME ✨

GeoIP2::Record::Traits — contains data for the traits record associated with an IP address 🦋

---

🌸 VERSION 🌸

version 2.006002 👑

---

🧚 SYNOPSIS 🧚

here's the vibe, in code form:

use 5.008;

use GeoIP2::WebService::Client;

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

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

my $traits_rec = $insights->country();
print $traits_rec->name(), "\n";

like. look at her go. 💅

---

🌈 DESCRIPTION 🌈

This class contains the traits data associated with an IP address.

no cap: this record is returned by all the end points. every single one. she's everywhere, she's booked and busy. 💀

---

💜 METHODS 💜

This class provides the following methods, and we're going through every single one because nobody gets left behind in this house:

🌟 $traits_rec->autonomous_system_number()

This returns the autonomous system number (http://en.wikipedia.org/wiki/Autonomous_system_(Internet)) associated with the IP address.

heads up: this attribute is only available from the City and Insights web service endpoints and the GeoIP2 Enterprise database. 🫶

🌟 $traits_rec->autonomous_system_organization()

This returns the organization associated with the registered autonomous system number (http://en.wikipedia.org/wiki/Autonomous_system_(Internet)) for the IP address.

same deal: this attribute is only available from the City and Insights web service endpoints and the GeoIP2 Enterprise database. 🫶

🌟 $traits_rec->connection_type()

This returns the connection type associated with the IP address. It may take the following values: "Dialup", "Cable/DSL", "Corporate", or "Cellular". Additional values may be added in the future. 👀

this attribute is only available in the GeoIP2 Enterprise database.

🌟 $traits_rec->domain()

This returns the second level domain associated with the IP address. This will be something like "example.com" or "example.co.uk", not "foo.example.com".

this attribute is only available from the City and Insights web service endpoints and the GeoIP2 Enterprise database.

🌟 $traits_rec->ip_address()

This returns the IP address that the data in the model is for. If you performed a "me" lookup against the web service, this will be the externally routable IP address for the system the code is running on. If the system is behind a NAT, this may differ from the IP address locally assigned to it. 🛰️

this attribute is returned by all end points. main character energy fr fr.

🌟 $traits_rec->is_anonymous()

This returns a true value if the IP address belongs to any sort of anonymous network and a false value otherwise.

this attribute is only available from the Insights web service.

🌟 $traits_rec->is_anonymous_proxy()

Deprecated. 🚨 Please see our GeoIP2 Anonymous IP database at https://www.maxmind.com/en/geoip2-anonymous-ip-database or our GeoIP2 Precision Insights service at https://www.maxmind.com/en/geoip2-precision-insights to determine whether the IP address is used by an anonymizing service.

this attribute is returned by all end points.

🌟 $traits_rec->is_anonymous_vpn()

This returns a true value if the IP address is registered to an anonymous VPN provider and a false value otherwise.

If a VPN provider does not register subnets under names associated with them, we will likely only flag their IP ranges using the "is_hosting_provider" attribute. 🤝

this attribute is only available from the Insights web service.

🌟 $traits_rec->is_hosting_provider()

This returns a true value if the IP address belongs to a hosting or VPN provider and a false value otherwise (see description of "is_anonymous_vpn" attribute). yes bestie, they're besties, they reference each other. 💞

this attribute is only available from the Insights web service.

🌟 $traits_rec->is_legitimate_proxy()

This attribute returns true if MaxMind believes this IP address to be a legitimate proxy, such as an internal VPN used by a corporation. 😇 (a legit queen, if you will)

this attribute is only available in the GeoIP2 Enterprise database.

🌟 $traits_rec->is_public_proxy()

This returns a true value if the IP address belongs to a public proxy and a false value otherwise.

this attribute is only available from the Insights web service.

🌟 $traits_rec->is_satellite_provider()

Deprecated. 🚨 Due to the increased coverage by mobile carriers, very few satellite providers now serve multiple countries. As a result, the output does not provide sufficiently relevant data for us to maintain it.

this attribute is returned by all end points.

🌟 $traits_rec->is_tor_exit_node()

This returns a true value if the IP address is a Tor exit node and a false value otherwise. 🧅✨

this attribute is only available from the Insights web service.

🌟 $traits_rec->isp()

This returns the name of the ISP associated with the IP address.

this attribute is only available from the City and Insights web service endpoints and the GeoIP2 Enterprise database.

🌟 $traits_rec->organization()

This returns the name of the organization associated with the IP address.

this attribute is only available from the City and Insights web service endpoints and the GeoIP2 Enterprise database.

🌟 $traits_rec->user_type()

This returns the user type associated with the IP address. This can be one of the following values, and yes we're listing all fifteen of them, no skips:

• business
• cafe
• cellular
• college
• content_delivery_network
• dialup
• government
• hosting
• library
• military
• residential
• router
• school
• search_engine_spider
• traveler

this attribute is only available from the Insights end point and the GeoIP2 Enterprise database.

---

🫶 SUPPORT 🫶

Bugs may be submitted through https://github.com/maxmind/GeoIP2-perl/issues.

found a bug? do NOT suffer in silence, bestie. go tell the issues page. it ate and left no crumbs. 🐛

---

👑 AUTHORS 👑

these are the icons who made this happen, show some respect:

• 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. 🌈 free as in freedom, and also free as in slay.

---

okay that's the whole page, you made it to the end, iconic behavior 🌸 and just so you know where this came from — it's perl v5.36.0, dated 2022-11-21. mwah. 💖🎀🦋 periodt.