public class Polygon extends Geometry implements Polygonal
LinearRings.
The boundary rings of the polygon may have any orientation.
Polygons are closed, simple geometries by definition.
The polygon model conforms to the assertions specified in the OpenGIS Simple Features Specification for SQL.
A Polygon is topologically valid if and only if:
TYPENAME_GEOMETRYCOLLECTION, TYPENAME_LINEARRING, TYPENAME_LINESTRING, TYPENAME_MULTILINESTRING, TYPENAME_MULTIPOINT, TYPENAME_MULTIPOLYGON, TYPENAME_POINT, TYPENAME_POLYGON| Constructor and Description |
|---|
Polygon(LinearRing shell,
LinearRing[] holes,
GeometryFactory factory)
Constructs a
Polygon with the given exterior boundary and
interior boundaries. |
Polygon(LinearRing shell,
LinearRing[] holes,
PrecisionModel precisionModel,
int SRID)
Deprecated.
Use GeometryFactory instead
|
Polygon(LinearRing shell,
PrecisionModel precisionModel,
int SRID)
Deprecated.
Use GeometryFactory instead
|
| Modifier and Type | Method and Description |
|---|---|
void |
apply(CoordinateFilter filter)
Performs an operation with or on this
Geometry's
coordinates. |
void |
apply(CoordinateSequenceFilter filter)
Performs an operation on the coordinates in this
Geometry's
CoordinateSequences. |
void |
apply(GeometryComponentFilter filter)
Performs an operation with or on this Geometry and its
component Geometry's.
|
void |
apply(GeometryFilter filter)
Performs an operation with or on this
Geometry and its
subelement Geometrys (if any). |
Object |
clone()
Deprecated.
|
Geometry |
convexHull()
Computes the smallest convex
Polygon that contains all the
points in the Geometry. |
boolean |
equalsExact(Geometry other,
double tolerance)
Returns true if the two
Geometrys are exactly equal,
up to a specified distance tolerance. |
double |
getArea()
Returns the area of this
Polygon |
Geometry |
getBoundary()
Computes the boundary of this geometry
|
int |
getBoundaryDimension()
Returns the dimension of this
Geometrys inherent boundary. |
Coordinate |
getCoordinate()
Returns a vertex of this geometry
(usually, but not necessarily, the first one),
or
null if the geometry is empty. |
Coordinate[] |
getCoordinates()
Returns an array containing the values of all the vertices for
this geometry.
|
int |
getDimension()
Returns the dimension of this geometry.
|
LinearRing |
getExteriorRing() |
String |
getGeometryType()
Returns the name of this Geometry's actual class.
|
LinearRing |
getInteriorRingN(int n) |
double |
getLength()
Returns the perimeter of this
Polygon |
int |
getNumInteriorRing() |
int |
getNumPoints()
Returns the count of this
Geometrys vertices. |
boolean |
isEmpty()
Tests whether the set of points covered by this
Geometry is
empty. |
boolean |
isRectangle()
Tests whether this is a rectangular
Polygon. |
void |
normalize()
Converts this
Geometry to normal form (or
canonical form ). |
Polygon |
reverse()
Computes a new geometry which has all component coordinate sequences
in reverse order (opposite orientation) to this one.
|
buffer, buffer, buffer, compareTo, compareTo, contains, copy, coveredBy, covers, crosses, difference, disjoint, distance, equals, equals, equalsExact, equalsNorm, equalsTopo, geometryChanged, getCentroid, getEnvelope, getEnvelopeInternal, getFactory, getGeometryN, getInteriorPoint, getNumGeometries, getPrecisionModel, getSRID, getUserData, hasDimension, hashCode, intersection, intersects, isSimple, isValid, isWithinDistance, norm, overlaps, relate, relate, setSRID, setUserData, symDifference, toString, toText, touches, union, union, withinpublic Polygon(LinearRing shell, PrecisionModel precisionModel, int SRID)
Polygon with the given exterior boundary.shell - the outer boundary of the new Polygon,
or null or an empty LinearRing if the empty
geometry is to be created.precisionModel - the specification of the grid of allowable points
for this PolygonSRID - the ID of the Spatial Reference System used by this
Polygonpublic Polygon(LinearRing shell, LinearRing[] holes, PrecisionModel precisionModel, int SRID)
Polygon with the given exterior boundary and
interior boundaries.shell - the outer boundary of the new Polygon,
or null or an empty LinearRing if the empty
geometry is to be created.holes - the inner boundaries of the new Polygon
, or null or empty LinearRings if the empty
geometry is to be created.precisionModel - the specification of the grid of allowable points
for this PolygonSRID - the ID of the Spatial Reference System used by this
Polygonpublic Polygon(LinearRing shell, LinearRing[] holes, GeometryFactory factory)
Polygon with the given exterior boundary and
interior boundaries.shell - the outer boundary of the new Polygon,
or null or an empty LinearRing if the empty
geometry is to be created.holes - the inner boundaries of the new Polygon
, or null or empty LinearRings if the empty
geometry is to be created.public Coordinate getCoordinate()
Geometrynull if the geometry is empty.
The returned coordinate should not be assumed
to be an actual Coordinate object used in
the internal representation.getCoordinate in class GeometryGeometry.public Coordinate[] getCoordinates()
Geometry
In general, the array cannot be assumed to be the actual internal
storage for the vertices. Thus modifying the array
may not modify the geometry itself.
Use the CoordinateSequence.setOrdinate(int, int, double) method
(possibly on the components) to modify the underlying data.
If the coordinates are modified,
Geometry.geometryChanged() must be called afterwards.
getCoordinates in class GeometryGeometryGeometry.geometryChanged(),
CoordinateSequence.setOrdinate(int, int, double)public int getNumPoints()
GeometryGeometrys vertices. The Geometry
s contained by composite Geometrys must be
Geometry's; that is, they must implement getNumPointsgetNumPoints in class GeometryGeometrypublic int getDimension()
Geometry
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).
getDimension in class GeometryGeometry.hasDimension(int)public int getBoundaryDimension()
GeometryGeometrys inherent boundary.getBoundaryDimension in class GeometryDimension.FALSE if the boundary is the empty geometry.public boolean isEmpty()
GeometryGeometry is
empty.
Note this test is for topological emptiness,
not structural emptiness.
A collection containing only empty elements is reported as empty.
To check structural emptiness use Geometry.getNumGeometries().
public boolean isRectangle()
GeometryPolygon.isRectangle in class Geometrypublic LinearRing getExteriorRing()
public int getNumInteriorRing()
public LinearRing getInteriorRingN(int n)
public String getGeometryType()
GeometrygetGeometryType in class GeometryGeometrys actual classpublic double getArea()
Polygonpublic double getLength()
Polygonpublic Geometry getBoundary()
getBoundary in class GeometryGeometry.getBoundary()public boolean equalsExact(Geometry other, double tolerance)
GeometryGeometrys are exactly equal,
up to a specified distance tolerance.
Two Geometries are exactly equal within a distance tolerance
if and only if:
GeometryFactory, the SRID,
or the userData fields.
To properly test equality between different geometries,
it is usually necessary to Geometry.normalize() them first.
equalsExact in class Geometryother - the Geometry with which to compare this Geometrytolerance - distance at or below which two Coordinates
are considered equaltrue if this and the other Geometry
have identical structure and point values, up to the distance tolerance.Geometry.equalsExact(Geometry),
Geometry.normalize(),
Geometry.norm()public void apply(CoordinateFilter filter)
GeometryGeometry's
coordinates.
If this method modifies any coordinate values,
Geometry.geometryChanged() must be called to update the geometry state.
Note that you cannot use this method to
modify this Geometry if its underlying CoordinateSequence's #get method
returns a copy of the Coordinate, rather than the actual Coordinate stored
(if it even stores Coordinate objects at all).public void apply(CoordinateSequenceFilter filter)
GeometryGeometry's
CoordinateSequences.
If the filter reports that a coordinate value has been changed,
Geometry.geometryChanged() will be called automatically.public void apply(GeometryFilter filter)
GeometryGeometry and its
subelement Geometrys (if any).
Only GeometryCollections and subclasses
have subelement Geometry's.public void apply(GeometryComponentFilter filter)
Geometrypublic Object clone()
Polygon object.
(including all coordinates contained by it).public Geometry convexHull()
GeometryPolygon that contains all the
points in the Geometry. This obviously applies only to Geometry
s which contain 3 or more points; the results for degenerate cases are
specified as follows:
Number of Points in argument Geometry |
Geometry class of result |
|---|---|
| 0 | empty GeometryCollection |
| 1 | Point |
| 2 | LineString |
| 3 or more | Polygon |
convexHull in class GeometryGeometry'
s pointspublic void normalize()
GeometryGeometry to normal form (or
canonical form ). Normal form is a unique representation for Geometry
s. It can be used to test whether two Geometrys are equal
in a way that is independent of the ordering of the coordinates within
them. Normal form equality is a stronger condition than topological
equality, but weaker than pointwise equality. The definitions for normal
form use the standard lexicographical ordering for coordinates. "Sorted in
order of coordinates" means the obvious extension of this ordering to
sequences of coordinates.
NOTE that this method mutates the value of this geometry in-place. If this is not safe and/or wanted, the geometry should be cloned prior to normalization.
Copyright © 2024. All rights reserved.