Dave Rolsky > GeoIP2-0.0200 > GeoIP2::Record::City



Annotate this POD

View/Report Bugs
Module Version: 0.0200   Source   Latest Release: GeoIP2-0.040005


GeoIP2::Record::City - Contains data for the city record associated with an IP address


version 0.0200


  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 => '' );

  my $city_rec = $city->city();
  say $city_rec->name();


This class contains the city-level data associated with an IP address.

This record is returned by all the end points except the Country end point.


This class provides the following methods:


This returns a value from 0-100 indicating MaxMind's confidence that the city is correct.

This attribute is only available from the Omni end point.


This returns a geoname_id for the city.

This attribute is returned by all end points.


This returns a name for the city. The language chosen depends on the languages argument that was passed to the record's constructor. This will be passed through from the GeoIP2::WebService::Client object you used to fetch the data that populated this record.

If the record does not have a name in any of languages you asked for, this method returns undef.

This attribute is returned by all end points.


This returns a hash reference where the keys are language codes and the values are names. See GeoIP2::WebService::Client for a list of the possible language codes.

This attribute is returned by all end points.


Dave Rolsky <autarch@urth.org>


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

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)
syntax highlighting: