com.spatial4j.core.shape.jts

Class JtsGeometry

java.lang.Object

com.spatial4j.core.shape.jts.JtsGeometry

All Implemented Interfaces:

Shape

public class JtsGeometry
extends Object
implements Shape

Wraps a JTS Geometry (i.e. may be a polygon or basically anything). JTS does a great deal of the hard work, but there is work here in handling dateline wrap.

Field Summary

Fields

Modifier and Type	Field and Description
protected JtsSpatialContext	ctx
protected com.vividsolutions.jts.geom.prep.PreparedGeometry	preparedGeometry
static String	SYSPROP_ASSERT_VALIDATE System property boolean that can disable auto validation in an assert.
protected boolean	validated

Constructor Summary

Constructors

Constructor and Description
JtsGeometry(com.vividsolutions.jts.geom.Geometry geom, JtsSpatialContext ctx, boolean dateline180Check, boolean allowMultiOverlap)

Method Summary

Methods

Modifier and Type	Method and Description
protected Rectangle	computeGeoBBox(com.vividsolutions.jts.geom.Geometry geoms) Given geoms which has already been checked for being in world bounds, return the minimal longitude range of the bounding box.
boolean	equals(Object o) The sub-classes of Shape generally implement the same contract for Object.equals(Object) and Object.hashCode() amongst the same sub-interface type.
double	getArea(SpatialContext ctx) Calculates the area of the shape, in square-degrees.
Rectangle	getBoundingBox() Get the bounding box for this Shape.
JtsGeometry	getBuffered(double distance, SpatialContext ctx) Returns a buffered version of this shape.
JtsPoint	getCenter() Returns the center point of this shape.
com.vividsolutions.jts.geom.Geometry	getGeom()
boolean	hasArea() Does the shape have area? This will be false for points and lines.
int	hashCode()
void	index() Adds an index to this class internally to compute spatial relations faster.
static SpatialRelation	intersectionMatrixToSpatialRelation(com.vividsolutions.jts.geom.IntersectionMatrix matrix)
boolean	isEmpty() Shapes can be "empty", which is to say it exists nowhere.
SpatialRelation	relate(Circle circle)
protected SpatialRelation	relate(com.vividsolutions.jts.geom.Geometry oGeom)
SpatialRelation	relate(JtsGeometry jtsGeometry)
SpatialRelation	relate(Point pt)
SpatialRelation	relate(Rectangle rectangle)
SpatialRelation	relate(Shape other) Describe the relationship between the two objects.
String	toString()
void	validate() Validates the shape, throwing a descriptive error if it isn't valid.

Methods inherited from class java.lang.Object

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

Field Detail

SYSPROP_ASSERT_VALIDATE

public static final String SYSPROP_ASSERT_VALIDATE

System property boolean that can disable auto validation in an assert.

See Also:

Constant Field Values

ctx

protected final JtsSpatialContext ctx

preparedGeometry

protected com.vividsolutions.jts.geom.prep.PreparedGeometry preparedGeometry

validated

protected boolean validated

Constructor Detail

JtsGeometry

public JtsGeometry(com.vividsolutions.jts.geom.Geometry geom,
           JtsSpatialContext ctx,
           boolean dateline180Check,
           boolean allowMultiOverlap)

Method Detail

validate

public void validate()
              throws InvalidShapeException

Validates the shape, throwing a descriptive error if it isn't valid. Note that this is usually called automatically by default, but that can be disabled.

Throws:

InvalidShapeException - with descriptive error if the shape isn't valid

index

public void index()

Adds an index to this class internally to compute spatial relations faster. In JTS this is called a PreparedGeometry. This isn't done by default because it takes some time to do the optimization, and it uses more memory. Calling this method isn't thread-safe so be careful when this is done. If it was already indexed then nothing happens.

isEmpty

public boolean isEmpty()

Description copied from interface: Shape

Shapes can be "empty", which is to say it exists nowhere. The underlying coordinates are typically NaN.

Specified by:

isEmpty in interface Shape

computeGeoBBox

protected Rectangle computeGeoBBox(com.vividsolutions.jts.geom.Geometry geoms)

Given geoms which has already been checked for being in world bounds, return the minimal longitude range of the bounding box.

getBuffered

public JtsGeometry getBuffered(double distance,
                      SpatialContext ctx)

Description copied from interface: Shape

Returns a buffered version of this shape. The buffer is usually a rounded-corner buffer, although some shapes might buffer differently. This is an optional operation.

Specified by:

getBuffered in interface Shape

Returns:

Not null, and the returned shape should contain the current shape.

hasArea

public boolean hasArea()

Description copied from interface: Shape

Does the shape have area? This will be false for points and lines. It will also be false for shapes that normally have area but are constructed in a degenerate case as to not have area (e.g. a circle with 0 radius or rectangle with no height or no width).

Specified by:

hasArea in interface Shape

getArea

public double getArea(SpatialContext ctx)

Description copied from interface: Shape

Calculates the area of the shape, in square-degrees. If ctx is null then simple Euclidean calculations will be used. This figure can be an estimate.

Specified by:

getArea in interface Shape

getBoundingBox

public Rectangle getBoundingBox()

Description copied from interface: Shape

Get the bounding box for this Shape. This means the shape is within the bounding box and that it touches each side of the rectangle.

Postcondition: this.getBoundingBox().relate(this) == CONTAINS

Specified by:

getBoundingBox in interface Shape

getCenter

public JtsPoint getCenter()

Description copied from interface: Shape

Returns the center point of this shape. This is usually the same as getBoundingBox().getCenter() but it doesn't have to be.

Postcondition: this.relate(this.getCenter()) == CONTAINS

Specified by:

getCenter in interface Shape

relate

public SpatialRelation relate(Shape other)

Description copied from interface: Shape

Describe the relationship between the two objects. For example

• this is WITHIN other
• this CONTAINS other
• this is DISJOINT other
• this INTERSECTS other

Note that a Shape implementation may choose to return INTERSECTS when the true answer is WITHIN or CONTAINS for performance reasons. If a shape does this then it must document when it does. Ideally the shape will not do this approximation in all circumstances, just sometimes.

If the shapes are equal then the result is CONTAINS (preferred) or WITHIN.

Specified by:

relate in interface Shape

relate

public SpatialRelation relate(Point pt)

relate

public SpatialRelation relate(Rectangle rectangle)

relate

public SpatialRelation relate(Circle circle)

relate

public SpatialRelation relate(JtsGeometry jtsGeometry)

relate

protected SpatialRelation relate(com.vividsolutions.jts.geom.Geometry oGeom)

intersectionMatrixToSpatialRelation

public static SpatialRelation intersectionMatrixToSpatialRelation(com.vividsolutions.jts.geom.IntersectionMatrix matrix)

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Description copied from interface: Shape

The sub-classes of Shape generally implement the same contract for Object.equals(Object) and Object.hashCode() amongst the same sub-interface type. This means, for example, that multiple Point implementations of different classes are equal if they share the same x & y.

Specified by:

equals in interface Shape

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

getGeom

public com.vividsolutions.jts.geom.Geometry getGeom()