NAME

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

INHERITANCE

 Geo::WKT
   is a Exporter

SYNOPSIS

  # use coordinate pairs ...
  print wkt_linestring([1,2], [2,3], [3,2], [1,2]);
    # --> LINESTRING(1 2,2 3,3 2,1 2)

  # ... or coordinatie objects
  my $gp1 = Geo::Point->xy(6,7);
  my $gp2 = Geo::Point->xy(8,9);
  my $gp3 = Geo::Point->xy(6,9);
  print wkt_linestring($gp1, $gp2, $gp3);
    # --> LINESTRING(6 7,8 9,6 9)

  # Combine with Geo::Point registration of projections
  my $p = parse_wkt_point "POINT(3.5 6.7)", 'wgs84';
  print $p->toString; # point[wgs84](6.7000 3.5000)

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::Line 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 coordinate 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 coordinate 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.96, built on January 23, 2018. Website: http://perl.overmeer.net/CPAN/

LICENSE

Copyrights 2008-2018 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://dev.perl.org/licenses/