NAME

GeoIP2::Record::Traits - Contains data for the traits record associated with an IP address

VERSION

version 2.001000

SYNOPSIS

use 5.008;

use GeoIP2::WebService::Client;

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

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

my $traits_rec = $insights->country();
say $traits_rec->name();

DESCRIPTION

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

This record is returned by all the end points.

METHODS

This class provides the following methods:

$traits_rec->autonomous_system_number()

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

This attribute is only available from the City and Insights web service endpoints.

$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.

This attribute is only available from the City and Insights web service endpoints.

$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.

$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.

$traits_rec->is_anonymous_proxy()

This returns true if the IP is an anonymous proxy. See http://dev.maxmind.com/faq/geoip#anonproxy for further details.

This attribute is returned by all end points.

$traits_rec->is_satellite_provider()

This returns true if the IP is a from a satellite provider that provides service to multiple countries.

This attribute is returned by all end points.

$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.

$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.

$traits_rec->user_type()

This returns the user type associated with the IP address. This can be one of the following values:

  • 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.

AUTHORS

  • Dave Rolsky <drolsky@maxmind.com>

  • Greg Oschwald <goschwald@maxmind.com>

  • Olaf Alders <oalders@maxmind.com>

COPYRIGHT AND LICENSE

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