Package org.locationtech.jts.io.geojson
Class GeoJsonReader
- java.lang.Object
-
- org.locationtech.jts.io.geojson.GeoJsonReader
-
public class GeoJsonReader extends java.lang.Object
Reads a GeoJSON Geometry from a JSON fragment into aGeometry
.The current GeoJSON specification is https://tools.ietf.org/html/rfc7946. An older specification is on the GeoJSON web site: http://geojson.org/geojson-spec.html.
The reader does not require a particular orientation for polygon rings.
The reader reads empty or null coordinate arrays as empty geometries.
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.- Author:
- Martin Davis, Paul Howells, Vivid Solutions.
-
-
Constructor Summary
Constructors Constructor Description GeoJsonReader()
The default constructor uses the SRID from the Geojson CRS and the defaultPrecisionModel
to create aGeometryFactory
.GeoJsonReader(GeometryFactory geometryFactory)
This constructor accepts aGeometryFactory
that is used to create the output geometries and to override the GeoJson CRS.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Geometry
read(java.io.Reader reader)
Reads a GeoJson Geometry from aReader
into a singleGeometry
.Geometry
read(java.lang.String json)
Reads a GeoJson Geometry from a String into a singleGeometry
.
-
-
-
Constructor Detail
-
GeoJsonReader
public GeoJsonReader()
The default constructor uses the SRID from the Geojson CRS and the defaultPrecisionModel
to create aGeometryFactory
. If there is no CRS specified then the default CRS is a geographic coordinate reference system, using the WGS84 datum, and with longitude and latitude units of decimal degrees (SRID = 4326)
-
GeoJsonReader
public GeoJsonReader(GeometryFactory geometryFactory)
This constructor accepts aGeometryFactory
that is used to create the output geometries and to override the GeoJson CRS.- Parameters:
geometryFactory
- a GeometryFactory
-
-
Method Detail
-
read
public Geometry read(java.lang.String json) throws ParseException
Reads a GeoJson Geometry from a String into a singleGeometry
.- Parameters:
json
- The GeoJson String to parse- Returns:
- the resulting JTS Geometry
- Throws:
ParseException
- throws a ParseException if the JSON string cannot be parsed
-
read
public Geometry read(java.io.Reader reader) throws ParseException
Reads a GeoJson Geometry from aReader
into a singleGeometry
.- Parameters:
reader
- The input source- Returns:
- The resulting JTS Geometry
- Throws:
ParseException
- throws a ParseException if the JSON string cannot be parsed as a Geometry
-
-