com.vividsolutions.jts.io
Class WKTReader
java.lang.Objectcom.vividsolutions.jts.io.WKTReader
public class WKTReader
extends java.lang.Object
Converts a geometry in Well-Known Text format to a
Geometry.
WKTReader supports
extracting
Geometry objects from either
Readers or
Strings. This allows it to function as a parser to read
Geometry
objects from text blocks embedded in other data formats (e.g. XML).
A
WKTReader is parameterized by a
GeometryFactory,
to allow it to create
Geometry objects of the appropriate
implementation. In particular, the
GeometryFactory
determines the
PrecisionModel and
SRID that is
used.
The
WKTReader converts all input numbers to the precise
internal representation.
Notes:
- The reader supports non-standard "LINEARRING" tags.
- The reader uses Double.parseDouble to perform the conversion of ASCII
numbers to floating point. This means it supports the Java
syntax for floating point literals (including scientific notation).
Syntax
The following syntax specification describes the version of Well-Known Text
supported by JTS.
(The specification uses a syntax language similar to that used in
the C and Java language specifications.)
WKTGeometry: one of
WKTPoint WKTLineString WKTLinearRing WKTPolygon
WKTMultiPoint WKTMultiLineString WKTMultiPolygon
WKTGeometryCollection
WKTPoint: POINT ( Coordinate )
WKTLineString: LINESTRING CoordinateSequence
WKTLinearRing: LINEARRING CoordinateSequence
WKTPolygon: POLYGON CoordinateSequenceList
WKTMultiPoint: MULTIPOINT CoordinateSequence
WKTMultiLineString: MULTILINESTRING CoordinateSequenceList
WKTMultiPolygon:
MULTIPOLYGON ( CoordinateSequenceList { , CoordinateSequenceList } )
WKTGeometryCollection:
GEOMETRYCOLLECTION ( WKTGeometry { , WKTGeometry } )
CoordinateSequenceList:
( CoordinateSequence { , CoordinateSequence } )
CoordinateSequence:
( Coordinate { , Coordinate } )
Coordinate:
Number Number Numberopt
Number: A Java-style floating-point number
WKTReader
public WKTReader()
WKTReader
public WKTReader(GeometryFactory geometryFactory)
geometryFactory - the factory used to create Geometrys.
read
public Geometry read(Reader reader)
throws ParseException Reads a Well-Known Text representation of a
Geometry
from a
Reader.
reader - a Reader which will return a
string (see the OpenGIS Simple Features Specification)
- a
Geometry read from reader
read
public Geometry read(String wellKnownText)
throws ParseException Reads a Well-Known Text representation of a
Geometry
from a
String.
wellKnownText - one or more strings (see the OpenGIS
Simple Features Specification) separated by whitespace
- a
Geometry specified by wellKnownText