public class Polygon extends Geometry implements Polygonal
LinearRing
s.
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
CoordinateSequence s. 
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 Geometry s (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
Geometry s 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
Geometry s 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
Geometry s 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, within
public 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 Polygon
SRID
 the ID of the Spatial Reference System used by this
Polygon
public 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 LinearRing
s if the empty
geometry is to be created.precisionModel
 the specification of the grid of allowable points
for this Polygon
SRID
 the ID of the Spatial Reference System used by this
Polygon
public 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 LinearRing
s if the empty
geometry is to be created.public Coordinate getCoordinate()
Geometry
null
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 Geometry
Geometry
.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 Geometry
Geometry
Geometry.geometryChanged()
,
CoordinateSequence.setOrdinate(int, int, double)
public int getNumPoints()
Geometry
Geometry
s vertices. The Geometry
s contained by composite Geometry
s must be
Geometry's; that is, they must implement getNumPoints
getNumPoints
in class Geometry
Geometry
public int getDimension()
Geometry
Note that this is a different concept to the dimension of
the vertex Coordinate
s.
The geometry dimension can never be greater than the coordinate dimension.
For example, a 0dimensional geometry (e.g. a Point)
may have a coordinate dimension of 3 (X,Y,Z).
getDimension
in class Geometry
Geometry.hasDimension(int)
public int getBoundaryDimension()
Geometry
Geometry
s inherent boundary.getBoundaryDimension
in class Geometry
Dimension.FALSE
if the boundary is the empty geometry.public boolean isEmpty()
Geometry
Geometry
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()
Geometry
Polygon
.isRectangle
in class Geometry
public LinearRing getExteriorRing()
public int getNumInteriorRing()
public LinearRing getInteriorRingN(int n)
public String getGeometryType()
Geometry
getGeometryType
in class Geometry
Geometry
s actual classpublic double getArea()
Polygon
public double getLength()
Polygon
public Geometry getBoundary()
getBoundary
in class Geometry
Geometry.getBoundary()
public boolean equalsExact(Geometry other, double tolerance)
Geometry
Geometry
s 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 Geometry
other
 the Geometry
with which to compare this Geometry
tolerance
 distance at or below which two Coordinate
s
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)
Geometry
Geometry
'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)
Geometry
Geometry
's
CoordinateSequence
s.
If the filter reports that a coordinate value has been changed,
Geometry.geometryChanged()
will be called automatically.public void apply(GeometryFilter filter)
Geometry
Geometry
and its
subelement Geometry
s (if any).
Only GeometryCollections and subclasses
have subelement Geometry's.public void apply(GeometryComponentFilter filter)
Geometry
public Object clone()
Polygon
object.
(including all coordinates contained by it).public Geometry convexHull()
Geometry
Polygon
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 Point s in argument Geometry 
Geometry class of result 

0  empty GeometryCollection 
1  Point 
2  LineString 
3 or more  Polygon 
convexHull
in class Geometry
Geometry
'
s pointspublic void normalize()
Geometry
Geometry
to normal form (or
canonical form ). Normal form is a unique representation for Geometry
s. It can be used to test whether two Geometry
s 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 inplace. If this is not safe and/or wanted, the geometry should be cloned prior to normalization.
Copyright © 2024. All rights reserved.