com.vividsolutions.jts.io
Class WKTReader
java.lang.Object
com.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
Reader
s or
String
s. 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 Geometry
s.
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