Package org.locationtech.jts.geom

Class MultiPoint

java.lang.Object

org.locationtech.jts.geom.Geometry

org.locationtech.jts.geom.GeometryCollection

org.locationtech.jts.geom.MultiPoint

All Implemented Interfaces:

Serializable, Cloneable, Comparable, Puntal

public class MultiPoint
extends GeometryCollection
implements Puntal

Models a collection of Points.

Any collection of Points is a valid MultiPoint.

Version:

1.7

See Also:

Serialized Form

Field Summary

Fields inherited from class org.locationtech.jts.geom.GeometryCollection

geometries

Fields inherited from class org.locationtech.jts.geom.Geometry

envelope, factory, SRID

Constructor Summary

Constructors

Constructor	Description
MultiPoint(Point[] points, GeometryFactory factory)
MultiPoint(Point[] points, PrecisionModel precisionModel, int SRID)	Deprecated. Use GeometryFactory instead

Method Summary

Modifier and Type	Method	Description
protected MultiPoint	copyInternal()	An internal method to copy subclass-specific geometry data.
boolean	equalsExact(Geometry other, double tolerance)	Returns true if the two Geometrys are exactly equal, up to a specified distance tolerance.
Geometry	getBoundary()	Gets the boundary of this geometry.
int	getBoundaryDimension()	Returns the dimension of this Geometrys inherent boundary.
protected Coordinate	getCoordinate(int n)	Returns the Coordinate at the given position.
int	getDimension()	Returns the dimension of this geometry.
String	getGeometryType()	Returns the name of this Geometry's actual class.
protected int	getSortIndex()
boolean	isValid()	Tests whether this Geometry is topologically valid, according to the OGC SFS specification.

Methods inherited from class org.locationtech.jts.geom.GeometryCollection

apply, apply, apply, apply, clone, compareToSameClass, compareToSameClass, computeEnvelopeInternal, getArea, getCoordinate, getCoordinates, getGeometryN, getLength, getNumGeometries, getNumPoints, isEmpty, normalize, reverse

Methods inherited from class org.locationtech.jts.geom.Geometry

buffer, buffer, buffer, checkNotGeometryCollection, compare, compareTo, compareTo, contains, convexHull, copy, coveredBy, covers, crosses, difference, disjoint, distance, equal, equals, equals, equalsExact, equalsNorm, equalsTopo, geometryChanged, geometryChangedAction, getCentroid, getEnvelope, getEnvelopeInternal, getFactory, getInteriorPoint, getPrecisionModel, getSRID, getUserData, hashCode, hasNonEmptyElements, hasNullElements, intersection, intersects, isEquivalentClass, isGeometryCollection, isRectangle, isSimple, isWithinDistance, norm, overlaps, relate, relate, setSRID, setUserData, symDifference, toString, toText, touches, union, union, within

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

MultiPoint

public MultiPoint(Point[] points,
                  PrecisionModel precisionModel,
                  int SRID)

Deprecated.

Use GeometryFactory instead

Constructs a MultiPoint.

Parameters:

points - the Points for this MultiPoint , or null or an empty array to create the empty geometry. Elements may be empty Points, but not nulls.

precisionModel - the specification of the grid of allowable points for this MultiPoint

SRID - the ID of the Spatial Reference System used by this MultiPoint

MultiPoint

public MultiPoint(Point[] points,
                  GeometryFactory factory)

Parameters:

points - the Points for this MultiPoint , or null or an empty array to create the empty geometry. Elements may be empty Points, but not nulls.

Method Detail

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.

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()

Gets the boundary of this geometry. Zero-dimensional geometries have no boundary by definition, so an empty GeometryCollection is returned.

Overrides:

getBoundary in class GeometryCollection

Returns:

an empty GeometryCollection

See Also:

Geometry.getBoundary()

isValid

public boolean isValid()

Description copied from class: Geometry

Tests whether this Geometry is topologically valid, according to the OGC SFS specification.

For validity rules see the Javadoc for the specific Geometry subclass.

Overrides:

isValid in class Geometry

Returns:

true if this Geometry is valid

See Also:

IsValidOp

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:

Geometry.equalsExact(Geometry), Geometry.normalize(), Geometry.norm()

getCoordinate

protected Coordinate getCoordinate(int n)

Returns the Coordinate at the given position.

Parameters:

n - the index of the Coordinate to retrieve, beginning at 0

Returns:

the nth Coordinate

copyInternal

protected MultiPoint 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.

getSortIndex

protected int getSortIndex()

Overrides:

getSortIndex in class GeometryCollection