GMLReader (JTS Topology Suite 1.20.0 API)

java.lang.Object
- org.locationtech.jts.io.gml2.GMLReader

```
public class GMLReader
extends Object
```
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.
Author:

David Zwiers, Vivid Solutions.

See Also:

GMLHandler

Constructor Summary

Constructors
Constructor Description

GMLReader()

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`Geometry`	`read(Reader reader, GeometryFactory geometryFactory)`	Reads a GML2 Geometry from a `Reader` into a single `Geometry` If a collection of Geometries is found, a `GeometryCollection` is returned.
`Geometry`	`read(String gml, GeometryFactory geometryFactory)`	Reads a GML2 Geometry from a `String` into a single `Geometry` If a collection of geometries is found, a `GeometryCollection` is returned.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - GMLReader
```
public GMLReader()
```
- Method Detail
  - read
```
public Geometry read(String gml,
                     GeometryFactory geometryFactory)
              throws SAXException,
                     IOException,
                     ParserConfigurationException
```
    Reads a GML2 Geometry from a String into a single Geometry If a collection of geometries is found, a GeometryCollection is returned.
    
    Parameters:
    
    gml - The GML String to parse
    
    geometryFactory - When null, a default will be used.
    
    Returns:
    
    the resulting JTS Geometry
    
    Throws:
    
    ParserConfigurationException
    
    IOException
    
    SAXException
    
    See Also:
    
    read(Reader, GeometryFactory)
  - read
```
public Geometry read(Reader reader,
                     GeometryFactory geometryFactory)
              throws SAXException,
                     IOException,
                     ParserConfigurationException
```
    Reads a GML2 Geometry from a Reader into a single Geometry If a collection of Geometries is found, a GeometryCollection is returned.
    
    Parameters:
    
    reader - The input source
    
    geometryFactory - When null, a default will be used.
    
    Returns:
    
    The resulting JTS Geometry
    
    Throws:
    
    SAXException
    
    IOException
    
    ParserConfigurationException