NAME

Geography::Countries::LatLong - Perl extension for blah blah blah

SYNOPSIS

use Geography::Countries::LatLong;
my $array_ref   = latlong('Hungary');
my ($lat,$long) = latlong('Hungary');

DESCRIPTION

This module provides mean latitude and longitude for a large number of countries extant at the time of going to press.

Regions and continents are not supported - please see the list below.

Look-up is by country name, as returned by the Geography::Countries module, of which this is a sub-class that exports none of its parent's properties or methods.

The mean values were arrived at with the following MATLAB code, where name is a country name recognised by MATLAB:

function [lat,lon] = country_latlon(name);
  load worldmtx;
  c=worldhi(name);
  lat = mean(c.latlim);
  lon = mean(c.longlim);
  fprintf( '"%s" => ["%.4f","%.4f"],', name,lat,lon);
% end function country_latlon

You will need the Mapping Toolbox to run the above snippet.

EXPORT

countries
latlong
latlong_aspair

unsupported ($country_name)

Returns as a 1x2 anonymous array the latitude and longitude for the country supplied as the sole argument.

unsupported ($country_name)

Returns as two strings the latitude and longitude for the country supplied as the sole argument.

unsupported

Prints to STDERR a list of Geography::Countries::countries that are not supported by this module.

country

Just Geography::Countries's routine.

UNSUPPORTED COUNTRY NAMES

Africa
Americas
Areas not elsewhere specified
Areas not specified
Asia
Australia and New Zealand
Brunei Darussalam
Caribbean
Central America
Channel Islands
Czechoslovakia
Côte d'Ivoire
Democratic Kampuchea
Eastern Africa
Eastern Asia
Eastern Europe
Europe
Faeroe Islands
French Guiana
French Southern Territories
German Democratic Republic
Guinea
Holy See
Isle of Man
Latin America and the Caribbean
Mayotte
Melanesia
Micronesia, Federated States of
Micronesia-Polynesia
Middle Africa
Myanmar
Niger
Northern Africa
Northern America
Northern Europe
Occupied Palestinian Territory
Oceania
Pacific Islands (Trust Territory)
Polynesia
Réunion
Samoa
Socialist Federal Republic of Yugoslavia
South America
South-central Asia
South-eastern Asia
Southern Africa
Southern Europe
Svalbard and Jan Mayen Islands
Tokelau
Turks and Caicos Islands
Union of Soviet Socialist Republics
United States Minor Outlying Islands
Upper Volta
Wallis and Futuna Islands
Western Africa
Western Asia
Western Europe
Yugoslavia

AUTHOR

Lee Goddard - lgoddard -at- cpan -dot- org

SEE ALSO

perl, Geography::Countries.

COPYRIGHT

Copyright (C) Lee Goddard, 2003. All Rights Reserved. Made publically available under the same terms as Perl itself.