The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Geo-WKT-0.03
River stage zero No dependents
1 ++
/ Geo::WKT

NAME

Geo::WKT - Well Known Text representation of geometry information

INHERITANCE

 Geo::WKT
   is a Exporter

SYNOPSIS

DESCRIPTION

GIS application often communicate geographical structures in WKT format, defined by the OpenGIS consortium. This module translates Geo::Point objects from and to this WKT.

FUNCTIONS

Parsing Well Known Text format (WKT)

$obj->parse_wkt(STRING, [PROJECTION])

    Parse any STRING into the applicable Geo::Shape structure.

$obj->parse_wkt_geomcol(STRING, [PROJECTION])

    Convert a WKT string into Geo::Space objects, containing the exterior and optionally some interior polygons.

parse_wkt_linestring(STRING, [PROJECTION])

    Convert a WKT string into one Geo::Point object.

parse_wkt_point(STRING, [PROJECTION])

    Convert a WKT string into one Geo::Point object.

parse_wkt_polygon(STRING, [PROJECTION])

    Convert a WKT string into one Geo::Surface objects, containing the exterior and optionally some interior polygons.

Constructing Well Known Text (WKT)

wkt_geomcollection(OBJECTS)

    Whole bunch of unsorted geometries. You may specify one Geo::Space or multiple things.

wkt_linestring(OBJECT|POINTS)

    A line string is a non-closed list ('string') of points.

wkt_multilinestring(OBJECTS|ARRAY-of-LINES|ARRAYS-of-ARRAY-OF-POINTS)

    Format a list of lines into WKT. A LINE contains Geo::Point objects or ARRAY-REFs to pairs. You may also provide a Geo::Line or a Math::Polygon.

wkt_multipoint(OBJECT|POINTS)

    A set of points, which must be specified as list. They can be stored in a Geo::Space.

wkt_multipolygon(OBJECTS|ARRAY-OF-LINES|ARRAYS-OF-ARRAY-OF-POINTS)

    Format a list of closed lines into WKT. A LINE contains Geo::Point objects or ARRAY-REFs to pairs. You may also provide a Geo::Line or a Math::Polygon.

wkt_optimal(OBJECT)

    Pass any Geo::Shape object, and the easiest representation is returned.

wkt_point((X,Y)|ARRAY|GEOPOINT)

    Format one point into WKT format.

wkt_polygon((LIST of POINTS|Geo::Line|ARRAY-of-POINTS) |Geo::Surface)

    Format one polygon (exterior with optional interiors) into WKT format. An ARRAY contains Geo::Point objects or ARRAY-REFs to pairs. You may also provide a Geo::Line or Geo::Surface OBJECTS.

    example:

     wkt_polygon [2,3],[4,5];   #list of points for outer
 wkt_polygon $gp1, $gp2;    #list of Geo::Points for outer
 wkt_polygon [[2,3],[4,5]]; #array of points for outer
 wkt_polygon [$gp1, $gp2];  #array with Geo::Points for outer

 my $outer = Geo::Line->new;
 wkt_polygon $outer;
 wkt_polygon $outer, $inner1, $inner2;
 wkt_polygon [$gp1,$gp2],[$gp3,$gp4,...];

SEE ALSO

This module is part of Geo-WKT distribution version 0.03, built on May 25, 2009. Website: http://perl.overmeer.net/geo All modules in this suite: "Geo::Point", "Geo::Proj4", "Geo::WKT", "Math::Polygon", "Geo::GML", "Geo::ISO19139", "Geo::EOP", "Geo::Format::Envisat", and "Geo::Format::Landsat".

Please post questions or ideas to the mailinglist at http://geo-perl@list.hut.fi

LICENSE

Copyrights 2008-2009 by Mark Overmeer. For other contributors see ChangeLog.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See http://www.perl.com/perl/misc/Artistic.html