The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

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

VERSION

version 0.0200

SYNOPSIS

  use 5.008;

  use GeoIP2::WebService::Client;

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

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

  my $traits_rec = $city->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/ISP/Org and Omni end points.

$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/ISP/Org and Omni end points.

$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/ISP/Org and Omni end points.

$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 the IP address.

This attribute is only available from the City/ISP/Org and Omni end points.

$traits_rec->organization()

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

This attribute is only available from the City/ISP/Org and Omni end points.

$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 Omni end point.

AUTHOR

Dave Rolsky <autarch@urth.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2013 by MaxMind, Inc..

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)