Geography/Countries/LatLong version 0.92
========================================

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

This module requires these other modules and libraries:

  Geography::Countries


NAME
    Geography::Countries::LatLong - mean latitude and longitude

SYNOPSIS
            use Geography::Countries::LatLong;
            if ( Geography::Countries::LatLong::supports('Hungary') ){
                    my $array_ref    = latlong('Hungary');
                    my ($lat, $long) = latlongr('Hungary');
            }

DESCRIPTION
    This module provides mean latitude and longitude for a large number of
    countries named in English.

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

    Look-up is by the English name of the country, 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 ($country_name)
    Returns as a 1x2 anonymous array the latitude and longitude for the
    country supplied as the sole argument, or "undef" if the country is not
    supported.

  supports ($country)
    Returns a true value if the sole argument is a country name supported by
    this module; otherwise, returns "undef".

  unsupported
    "warn"s to "STDERR" a list of "Geography::Countries::countries" that are
    not supported by this module.

  country
    Just "Geography::Countries"'s routine.

UNSUPPORTED NAMES
    It is no reflection on the countries listed: I just don't have the data
    at the time of writing.

            Democratic Kampuchea
            Faeroe Islands
            French Guiana
            French Southern Territories
            Holy See
            Melanesia
            Micronesia-Polynesia
            Myanmar
            Pacific Islands (Trust Territory)
            Svalbard and Jan Mayen Islands
            Tokelau
            Turks and Caicos Islands
            Upper Volta
            Wallis and Futuna Islands

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

SEE ALSO
    perl, Geography::Countries.

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


