NAME

Locale::Geocode::Territory

DESCRIPTION

Locale::Geocode::Territory represents an individual country or territory as listed in ISO-3166-1. This class provides methods for returning information about the territory and any administrative divisions therein.

To be listed in ISO-3166-1, a country or territory must be listed in the United Nations Terminology Bulletin Country Names or Country and Region Codes for Statistical Use of the UN Statistics Division. In order for a country or territory to be listed in the Country Names bulletin, one of the following must be true of the territory:

  - is a United Nations member state a member
  - is a member of any of the UN specialized agencies
  - a party to the Statute of the International Court of Justice

SYNOPSIS

 my $lct    = new Locale::Geocode::Territory 'US';

 # lookup a subdivision of US
 my $lcd    = $lct->lookup('TN');

 # retrieve ISO-3166-2 information for US-TN
 my $name   = $lcd->name;   # Tennessee
 my $code   = $lcd->code;   # TN

 # returns an array of Locale::Geocode::Division
 # objects representing all divisions of US
 my @divs   = $lct->divisions;

METHODS

new
lg
lookup
lookup_by_index
name
num
alpha2
alpha3
fips
has_notes
num_notes
notes
note
divisions

returns an array of Locale::Geocode::Division objects representing all territorial divisions. this method honors the configured extensions.

divisions_sorted

the same as divisions, only all objects are sorted according to the specified metadata. if metadata is not specified (or is invalid), then all divisions are sorted by name. the supported metadata is any data-oriented method of Locale::Geocode::Division (name, code, fips, region, et alia).

num_divisions

AUTHOR

 Mike Eldridge <diz@cpan.org>

CREDITS

 Kim Ryan

SEE ALSO

 L<Locale::Geocode>
 L<Locale::Geocode::Division>