Package org.locationtech.jts.io.gml2
Class GMLReader
java.lang.Object
org.locationtech.jts.io.gml2.GMLReader
Reads a GML2 geometry from an XML fragment into a
Geometry
.
An example of the GML2 format handled is:
<LineString> <coordinates> 24824.045318333192,38536.15071012041 26157.378651666528,37567.42733944659 26666.666,36000.0 26157.378651666528,34432.57266055341 24824.045318333192,33463.84928987959 23175.954681666804,33463.84928987959 21842.621348333472,34432.57266055341 21333.333,36000.0 21842.621348333472,37567.42733944659 23175.954681666808,38536.15071012041 </coordinates> </LineString>The reader ignores namespace prefixes, and disables both the validation and namespace options on the SAXParser. This class requires the presence of a SAX Parser available via the
SAXParserFactory.newInstance()
method.
A specification of the GML XML format can be found at the OGC web site: http://www.opengeospatial.org/.
It is the caller's responsibility to ensure that the supplied PrecisionModel
matches the precision of the incoming data.
If a lower precision for the data is required, a subsequent
process must be run on the data to reduce its precision.
To parse and build geometry directly from a SAX stream, see GMLHandler
.
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionread
(Reader reader, GeometryFactory geometryFactory) Reads a GML2 Geometry from aReader
into a singleGeometry
If a collection of Geometries is found, aGeometryCollection
is returned.read
(String gml, GeometryFactory geometryFactory) Reads a GML2 Geometry from a String into a singleGeometry
If a collection of geometries is found, aGeometryCollection
is returned.
-
Constructor Details
-
GMLReader
public GMLReader()
-
-
Method Details
-
read
public Geometry read(String gml, GeometryFactory geometryFactory) throws SAXException, IOException, ParserConfigurationException Reads a GML2 Geometry from a String into a singleGeometry
If a collection of geometries is found, aGeometryCollection
is returned.- Parameters:
gml
- The GML String to parsegeometryFactory
- When null, a default will be used.- Returns:
- the resulting JTS Geometry
- Throws:
ParserConfigurationException
IOException
SAXException
- See Also:
-
read
public Geometry read(Reader reader, GeometryFactory geometryFactory) throws SAXException, IOException, ParserConfigurationException Reads a GML2 Geometry from aReader
into a singleGeometry
If a collection of Geometries is found, aGeometryCollection
is returned.- Parameters:
reader
- The input sourcegeometryFactory
- When null, a default will be used.- Returns:
- The resulting JTS Geometry
- Throws:
SAXException
IOException
ParserConfigurationException
-