Class Point

  • All Implemented Interfaces:
    Puntal


    public class Point
    extends Geometry
    implements Puntal
    Represents a single point. A Point is topologically valid if and only if:
    • the coordinate which defines it (if any) is a valid coordinate (i.e does not have an NaN X or Y ordinate)
    See Also:
    Serialized Form
    • Constructor Detail

      • Point

        public Point​(Coordinate coordinate,
                     PrecisionModel precisionModel,
                     int SRID)
        Deprecated. Use GeometryFactory instead
        Constructs a Point with the given coordinate.
        Parameters:
        coordinate - the coordinate on which to base this Point , or null to create the empty geometry.
        precisionModel - the specification of the grid of allowable points for this Point
        SRID - the ID of the Spatial Reference System used by this Point
      • Point

        public Point​(CoordinateSequence coordinates,
                     GeometryFactory factory)
        Parameters:
        coordinates - contains the single coordinate on which to base this Point , or null to create the empty geometry.
    • Method Detail

      • getNumPoints

        public int getNumPoints​()
        Description copied from class: Geometry
        Returns the count of this Geometrys vertices. The Geometry s contained by composite Geometrys must be Geometry's; that is, they must implement getNumPoints
        Specified by:
        getNumPoints in class Geometry
        Returns:
        the number of vertices in this Geometry
      • isEmpty

        public boolean isEmpty​()
        Description copied from class: Geometry
        Tests whether the set of points covered by this Geometry is empty.
        Specified by:
        isEmpty in class Geometry
        Returns:
        true if this Geometry does not cover any points
      • isSimple

        public boolean isSimple​()
        Description copied from class: Geometry
        Tests whether this Geometry is simple. The SFS definition of simplicity follows the general rule that a Geometry is simple if it has no points of self-tangency, self-intersection or other anomalous points.

        Simplicity is defined for each Geometry subclass as follows:

        • Valid polygonal geometries are simple, since their rings must not self-intersect. isSimple tests for this condition and reports false if it is not met. (This is a looser test than checking for validity).
        • Linear rings have the same semantics.
        • Linear geometries are simple iff they do not self-intersect at points other than boundary points.
        • Zero-dimensional geometries (points) are simple iff they have no repeated points.
        • Empty Geometrys are always simple.
          Overrides:
          isSimple in class Geometry
          Returns:
          true if this Geometry is simple
          See Also:
          Geometry.isValid()
        • 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).

          Specified by:
          getDimension in class Geometry
          Returns:
          the topological dimension of this geometry.
        • getBoundaryDimension

          public int getBoundaryDimension​()
          Description copied from class: Geometry
          Returns the dimension of this Geometrys inherent boundary.
          Specified by:
          getBoundaryDimension in class Geometry
          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.
        • getX

          public double getX​()
        • getY

          public double getY​()
        • getCoordinate

          public Coordinate getCoordinate​()
          Description copied from class: Geometry
          Returns a vertex of this Geometry (usually, but not necessarily, the first one). The returned coordinate should not be assumed to be an actual Coordinate object used in the internal representation.
          Specified by:
          getCoordinate in class Geometry
          Returns:
          a Coordinate which is a vertex of this Geometry.
        • getGeometryType

          public java.lang.String getGeometryType​()
          Description copied from class: Geometry
          Returns the name of this Geometry's actual class.
          Specified by:
          getGeometryType in class Geometry
          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.
          Specified by:
          getBoundary in class Geometry
          Returns:
          an empty GeometryCollection
          See Also:
          Geometry.getBoundary()
        • computeEnvelopeInternal

          protected Envelope computeEnvelopeInternal​()
          Description copied from class: Geometry
          Returns the minimum and maximum x and y values in this Geometry , or a null Envelope if this Geometry is empty. Unlike getEnvelopeInternal, this method calculates the Envelope each time it is called; getEnvelopeInternal caches the result of this method.
          Specified by:
          computeEnvelopeInternal in class Geometry
          Returns:
          this Geometrys bounding box; if the Geometry is empty, Envelope#isNull will return true
        • 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.

          Specified by:
          equalsExact in class Geometry
          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()
        • apply

          public void apply​(CoordinateFilter filter)
          Description copied from class: Geometry
          Performs an operation with or on this 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).
          Specified by:
          apply in class Geometry
          Parameters:
          filter - the filter to apply to this Geometry's coordinates
        • apply

          public void apply​(GeometryFilter filter)
          Description copied from class: Geometry
          Performs an operation with or on this Geometry and its subelement Geometrys (if any). Only GeometryCollections and subclasses have subelement Geometry's.
          Specified by:
          apply in class Geometry
          Parameters:
          filter - the filter to apply to this Geometry (and its children, if it is a GeometryCollection).
        • apply

          public void apply​(GeometryComponentFilter filter)
          Description copied from class: Geometry
          Performs an operation with or on this Geometry and its component Geometry's. Only GeometryCollections and Polygons have component Geometry's; for Polygons they are the LinearRings of the shell and holes.
          Specified by:
          apply in class Geometry
          Parameters:
          filter - the filter to apply to this Geometry.
        • clone

          public java.lang.Object clone​()
          Creates and returns a full copy of this Point object. (including all coordinates contained by it).
          Overrides:
          clone in class Geometry
          Returns:
          a clone of this instance
        • reverse

          public Geometry reverse​()
          Description copied from class: Geometry
          Computes a new geometry which has all component coordinate sequences in reverse order (opposite orientation) to this one.
          Specified by:
          reverse in class Geometry
          Returns:
          a reversed geometry
        • normalize

          public void normalize​()
          Description copied from class: Geometry
          Converts this Geometry 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.

          Specified by:
          normalize in class Geometry
        • compareToSameClass

          protected int compareToSameClass​(java.lang.Object other)
          Description copied from class: Geometry
          Returns whether this Geometry is greater than, equal to, or less than another Geometry having the same class.
          Specified by:
          compareToSameClass in class Geometry
          Parameters:
          other - a Geometry having the same class as this Geometry
          Returns:
          a positive number, 0, or a negative number, depending on whether this object is greater than, equal to, or less than o, as defined in "Normal Form For Geometry" in the JTS Technical Specifications
        • compareToSameClass

          protected int compareToSameClass​(java.lang.Object other,
                                           CoordinateSequenceComparator comp)
          Description copied from class: Geometry
          Returns whether this Geometry is greater than, equal to, or less than another Geometry of the same class. using the given CoordinateSequenceComparator.
          Specified by:
          compareToSameClass in class Geometry
          Parameters:
          other - a Geometry having the same class as this Geometry
          comp - a CoordinateSequenceComparator
          Returns:
          a positive number, 0, or a negative number, depending on whether this object is greater than, equal to, or less than o, as defined in "Normal Form For Geometry" in the JTS Technical Specifications