Package com.spatial4j.core.context

Class SpatialContext

    • Field Detail

      • GEO

        public static final SpatialContext GEO
        A popular default SpatialContext implementation for geospatial.

    • Method Detail

      • calcDistance

        public double calcDistance​(Point p,
                           double x2,
                           double y2)
        Convenience that uses getDistCalc()

      • getWorldBounds

        public Rectangle getWorldBounds()
        The extent of x & y coordinates should fit within the return'ed rectangle. Do *NOT* invoke reset() on this return type.

      • isNormWrapLongitude

        public boolean isNormWrapLongitude()
        If true then normX(double) will wrap longitudes outside of the standard geodetic boundary into it. Example: 181 will become -179.

      • isGeo

        public boolean isGeo()
        Is the mathematical world model based on a sphere, or is it a flat plane? The word "geodetic" or "geodesic" is sometimes used to refer to the former, and the latter is sometimes referred to as "Euclidean" or "cartesian".

      • normX

        public double normX​(double x)
        Normalize the 'x' dimension. Might reduce precision or wrap it to be within the bounds. This is called by WKTReader before creating a shape.

      • normY

        public double normY​(double y)
        Normalize the 'y' dimension. Might reduce precision or wrap it to be within the bounds. This is called by WKTReader before creating a shape.

      • verifyX

        public void verifyX​(double x)
        Ensure fits in getWorldBounds(). It's called by any shape factory method that gets an 'x' dimension.

      • verifyY

        public void verifyY​(double y)
        Ensure fits in getWorldBounds(). It's called by any shape factory method that gets a 'y' dimension.

      • makePoint

        public Point makePoint​(double x,
                       double y)
        Construct a point.

      • makeRectangle

        public Rectangle makeRectangle​(Point lowerLeft,
                               Point upperRight)
        Construct a rectangle.

      • makeRectangle

        public Rectangle makeRectangle​(double minX,
                               double maxX,
                               double minY,
                               double maxY)
        Construct a rectangle. If just one longitude is on the dateline (+/- 180) then potentially adjust its sign to ensure the rectangle does not cross the dateline.

      • makeCircle

        public Circle makeCircle​(double x,
                         double y,
                         double distance)
        Construct a circle. The units of "distance" should be the same as x & y.

      • makeCircle

        public Circle makeCircle​(Point point,
                         double distance)
        Construct a circle. The units of "distance" should be the same as x & y.

      • makeLineString

        public Shape makeLineString​(List<Point> points)
        Constructs a line string. It's an ordered sequence of connected vertexes. There is no official shape/interface for it yet so we just return Shape.

      • makeBufferedLineString

        public Shape makeBufferedLineString​(List<Point> points,
                                    double buf)
        Constructs a buffered line string. It's an ordered sequence of connected vertexes, with a buffer distance along the line in all directions. There is no official shape/interface for it so we just return Shape.

      • makeCollection

        public <S extends Shape> ShapeCollection<S> makeCollection​(List<S> coll)
        Construct a ShapeCollection, analogous to an OGC GeometryCollection.

      • toString

        @Deprecated
public String toString​(Shape shape)
        Deprecated.
        Writes the shape to a String using the old/deprecated LegacyShapeWriter. The JTS based subclass will write it to WKT if the legacy format doesn't support that shape. Spatial4j in the near future won't support writing shapes to strings.
        Parameters:
        shape - non-null
        Returns:
        non-null