Class GeoJsonReader


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

    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 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 as a Geometry