Class PointLocation


  • public class PointLocation
    extends java.lang.Object
    Functions for locating points within basic geometric structures such as lines and rings.
    Author:
    Martin Davis
    • Constructor Detail

      • PointLocation

        public PointLocation()
    • Method Detail

      • isOnLine

        public static boolean isOnLine​(Coordinate p,
                                       Coordinate[] line)
        Tests whether a point lies on the line defined by a list of coordinates.
        Parameters:
        p - the point to test
        line - the line coordinates
        Returns:
        true if the point is a vertex of the line or lies in the interior of a line segment in the line
      • isOnLine

        public static boolean isOnLine​(Coordinate p,
                                       CoordinateSequence line)
        Tests whether a point lies on the line defined by a CoordinateSequence.
        Parameters:
        p - the point to test
        line - the line coordinates
        Returns:
        true if the point is a vertex of the line or lies in the interior of a line segment in the line
      • isInRing

        public static boolean isInRing​(Coordinate p,
                                       Coordinate[] ring)
        Tests whether a point lies inside or on a ring. The ring may be oriented in either direction. A point lying exactly on the ring boundary is considered to be inside the ring.

        This method does not first check the point against the envelope of the ring.

        Parameters:
        p - point to check for ring inclusion
        ring - an array of coordinates representing the ring (which must have first point identical to last point)
        Returns:
        true if p is inside ring
        See Also:
        locatePointInRing
      • locateInRing

        public static int locateInRing​(Coordinate p,
                                       Coordinate[] ring)
        Determines whether a point lies in the interior, on the boundary, or in the exterior of a ring. The ring may be oriented in either direction.

        This method does not first check the point against the envelope of the ring.

        Parameters:
        p - point to check for ring inclusion
        ring - an array of coordinates representing the ring (which must have first point identical to last point)
        Returns:
        the Location of p relative to the ring