Geo::KML::PolyMap 1.32

Geo::KML::PolyMap is a Perl module to generate KML/KMZ-format choropleth (shaded polygonal) maps viewable in Google Earth.

SYNOPSIS

use Geo::KML::PolyMap qw(generate_kml_file generate_kmz_file);

# Clusters "Total Population" data for "Foobar City" in $entities into 5 bins;
# renders using colors from $startcolor to $endcolor;
# generates a legend; renders output to file handle passed in $kmz_filehandle
generate_kmz_file(entities => $entities,
placename => "Foobar City",
data_desc => "Total Population",
nbins => 5,
kmzfh => $filehandle_for_kmz_output,
startcolor => "FFFF0000",
endcolor => "FF00FF00");

# As above, but without a legend
generate_kml_file(entities => $entities,
placename => "Foobar City",
data_desc => "Total Population",
nbins => 5,
kmlfh => $filehandle_for_kml_output,
startcolor => "FFFF0000",
endcolor => "FF00FF00");

Geo::KML::PolyMap generates KML or KMZ-formatted maps for Google Earth. Given a set of polygonal regions and a number associated with each region (for example, city blocks and population counts on each block), Geo::KML::PolyMap generates a choropleth map showing the data value for each region as a shaded polygon. The polygons are divided into a number of bins, with the color of each bin unique. Optionally, Geo::KML::PolyMap will generate a legend along with the map file to illustrate the data ranges represented by each color.