Package org.locationtech.jts.io.geojson

Class GeoJsonReader

  • public class GeoJsonReader
extends java.lang.Object
    Reads a GeoJson Geometry from a JSON fragment into a Geometry.

    A specification of the GeoJson format can be found at the GeoJson web site: http://geojson.org/geojson-spec.html.

    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 default PrecisionModel to create a GeometryFactory.
      GeoJsonReader​(GeometryFactory geometryFactory)
      This constructor accepts a GeometryFactory 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 a Reader into a single Geometry.
      Geometry read​(java.lang.String json)
      Reads a GeoJson Geometry from a String into a single Geometry.

      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • GeoJsonReader

        public GeoJsonReader()
        The default constructor uses the SRID from the Geojson CRS and the default PrecisionModel to create a GeometryFactory. 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 a GeometryFactory 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 single Geometry.
        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 a Reader into a single Geometry.
        Parameters:
        reader - The input source
        Returns:
        The resulting JTS Geometry
        Throws:
        ParseException - throws a ParseException if the JSON string cannot be parsed