NAME

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

INHERITANCE

Geo::WKT
  is a Exporter

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.04, built on November 18, 2012. 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-2012 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