Class MultiPolygon

java.lang.Object
org.locationtech.jts.geom.Geometry
org.locationtech.jts.geom.GeometryCollection
org.locationtech.jts.geom.MultiPolygon
All Implemented Interfaces:
Serializable, Cloneable, Comparable, Polygonal
public class MultiPolygon extends GeometryCollection implements Polygonal
Models a collection of Polygons.

As per the OGC SFS specification, the Polygons in a MultiPolygon may not overlap, and may only touch at single points. This allows the topological point-set semantics to be well-defined.

Version:
1.7
See Also:

  • Constructor Details

    • MultiPolygon

      public MultiPolygon(Polygon[] polygons, PrecisionModel precisionModel, int SRID)
      Deprecated.
      Use GeometryFactory instead
      Constructs a MultiPolygon.
      Parameters:
      polygons - the Polygons for this MultiPolygon , or null or an empty array to create the empty geometry. Elements may be empty Polygons, but not null s. The polygons must conform to the assertions specified in the OpenGIS Simple Features Specification for SQL .
      precisionModel - the specification of the grid of allowable points for this MultiPolygon
      SRID - the ID of the Spatial Reference System used by this MultiPolygon

    • MultiPolygon

      public MultiPolygon(Polygon[] polygons, GeometryFactory factory)
      Parameters:
      polygons - the Polygons for this MultiPolygon, or null or an empty array to create the empty geometry. Elements may be empty Polygons, but not nulls. The polygons must conform to the assertions specified in the OpenGIS Simple Features Specification for SQL.

  • Method Details

    • getDimension

      public int getDimension()
      Description copied from class: Geometry
      Returns the dimension of this geometry. The dimension of a geometry is is the topological dimension of its embedding in the 2-D Euclidean plane. In the JTS spatial model, dimension values are in the set {0,1,2}.

      Note that this is a different concept to the dimension of the vertex Coordinates. The geometry dimension can never be greater than the coordinate dimension. For example, a 0-dimensional geometry (e.g. a Point) may have a coordinate dimension of 3 (X,Y,Z).

      Overrides:
      getDimension in class GeometryCollection
      Returns:
      the topological dimension of this geometry.
      See Also:

    • hasDimension

      public boolean hasDimension(int dim)
      Description copied from class: Geometry
      Tests whether an atomic geometry or any element of a collection has the specified dimension. In particular, this can be used with mixed-dimension GeometryCollections to test if they contain an element of the specified dimension.
      Overrides:
      hasDimension in class GeometryCollection
      Parameters:
      dim - the dimension to test
      Returns:
      true if the geometry has or contains an element with the dimension
      See Also:

    • getBoundaryDimension

      public int getBoundaryDimension()
      Description copied from class: Geometry
      Returns the dimension of this Geometrys inherent boundary.
      Overrides:
      getBoundaryDimension in class GeometryCollection
      Returns:
      the dimension of the boundary of the class implementing this interface, whether or not this object is the empty geometry. Returns Dimension.FALSE if the boundary is the empty geometry.

    • getGeometryType

      public String getGeometryType()
      Description copied from class: Geometry
      Returns the name of this Geometry's actual class.
      Overrides:
      getGeometryType in class GeometryCollection
      Returns:
      the name of this Geometrys actual class

    • getBoundary

      public Geometry getBoundary()
      Computes the boundary of this geometry
      Overrides:
      getBoundary in class GeometryCollection
      Returns:
      a lineal geometry (which may be empty)
      See Also:

    • equalsExact

      public boolean equalsExact(Geometry other, double tolerance)
      Description copied from class: Geometry
      Returns true if the two Geometrys are exactly equal, up to a specified distance tolerance. Two Geometries are exactly equal within a distance tolerance if and only if:
      • they have the same structure
      • they have the same values for their vertices, within the given tolerance distance, in exactly the same order.
      This method does not test the values of the GeometryFactory, the SRID, or the userData fields.

      To properly test equality between different geometries, it is usually necessary to Geometry.normalize() them first.

      Overrides:
      equalsExact in class GeometryCollection
      Parameters:
      other - the Geometry with which to compare this Geometry
      tolerance - distance at or below which two Coordinates are considered equal
      Returns:
      true if this and the other Geometry have identical structure and point values, up to the distance tolerance.
      See Also:

    • reverse

      public MultiPolygon reverse()
      Creates a MultiPolygon with every component reversed. The order of the components in the collection are not reversed.
      Overrides:
      reverse in class GeometryCollection
      Returns:
      a MultiPolygon in the reverse order

    • reverseInternal

      protected MultiPolygon reverseInternal()
      Overrides:
      reverseInternal in class GeometryCollection

    • copyInternal

      protected MultiPolygon copyInternal()
      Description copied from class: Geometry
      An internal method to copy subclass-specific geometry data.
      Overrides:
      copyInternal in class GeometryCollection
      Returns:
      a copy of the target geometry object.

    • getTypeCode

      protected int getTypeCode()
      Overrides:
      getTypeCode in class GeometryCollection