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;

SOURCES

Wikipedia - http://en.wikipedia.org/wiki/ISO_3166
ISO 3166-1 - http://www.statoids.com/wab.html
ISO 3166-2 - Locale::SubCountry

METHODS

new

lg

lookup

lookup_by_index

name

num

alpha2

alpha3

fips

has_notes

num_notes

notes

note

divisions

num_divisions

AUTHOR

Mike Eldridge <diz@cpan.org>

CREDITS

Kim Ryan

SEE ALSO

L<Locale::Geocode>
L<Locale::SubCountry>
L<Geography::Countries>
L<Geography::Country>