Package org.locationtech.spatial4j.context.jts

Class JtsSpatialContext

java.lang.Object

org.locationtech.spatial4j.context.SpatialContext

org.locationtech.spatial4j.context.jts.JtsSpatialContext

public class JtsSpatialContext
extends SpatialContext

Enhances the default SpatialContext with support for Polygons (and other geometries) using JTS. To the extent possible, our JtsGeometry adds some amount of geodetic support over vanilla JTS which only has a Euclidean (flat plane) model.

Field Summary

Fields

Modifier and Type	Field	Description
static JtsSpatialContext	GEO

Constructor Summary

Constructors

Constructor	Description
JtsSpatialContext(JtsSpatialContextFactory factory)	Called by JtsSpatialContextFactory.newSpatialContext().

Method Summary

Modifier and Type	Method	Description
DatelineRule	getDatelineRule()	Deprecated.
GeometryFactory	getGeometryFactory()	Deprecated.
Geometry	getGeometryFrom(Shape shape)	Deprecated.
JtsShapeFactory	getShapeFactory()	A factory for Shapes.
ValidationRule	getValidationRule()	Deprecated.
boolean	isAllowMultiOverlap()	Deprecated.
boolean	isAutoIndex()	Deprecated.
Rectangle	makeRectFromRectangularPoly(Geometry geom)	Deprecated.
JtsGeometry	makeShape(Geometry geom)	Deprecated.
JtsGeometry	makeShape(Geometry geom, boolean dateline180Check, boolean allowMultiOverlap)	Deprecated.
Shape	makeShapeFromGeometry(Geometry geom)	Deprecated.
String	toString()
boolean	useJtsLineString()	Deprecated.
boolean	useJtsPoint()	Deprecated.

Methods inherited from class org.locationtech.spatial4j.context.SpatialContext

calcDistance, calcDistance, getBinaryCodec, getDistCalc, getFormats, getWktShapeParser, getWorldBounds, isGeo, isNormWrapLongitude, makeBufferedLineString, makeCircle, makeCircle, makeCollection, makeLineString, makePoint, makeRectangle, makeRectangle, normX, normY, readShape, readShapeFromWkt, toString, verifyX, verifyY

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

GEO

public static final JtsSpatialContext GEO

Constructor Detail

JtsSpatialContext

public JtsSpatialContext(JtsSpatialContextFactory factory)

Called by JtsSpatialContextFactory.newSpatialContext().

Method Detail

getShapeFactory

public JtsShapeFactory getShapeFactory()

Description copied from class: SpatialContext

A factory for Shapes.

Overrides:

getShapeFactory in class SpatialContext

isAllowMultiOverlap

@Deprecated
public boolean isAllowMultiOverlap()

Deprecated.

If geom might be a multi geometry of some kind, then might multiple component geometries overlap? Strict OGC says this is invalid but we can accept it by computing the union. Note: Our ShapeCollection mostly doesn't care but it has a method related to this ShapeCollection.relateContainsShortCircuits().

getDatelineRule

@Deprecated
public DatelineRule getDatelineRule()

Deprecated.

Returns the rule used to handle geometry objects that have dateline (aka anti-meridian) crossing considerations.

getValidationRule

@Deprecated
public ValidationRule getValidationRule()

Deprecated.

Returns the rule used to handle errors when creating a JTS Geometry, particularly after it has been read from one of the ShapeReaders.

isAutoIndex

@Deprecated
public boolean isAutoIndex()

Deprecated.

If JtsGeometry shapes should be automatically "prepared" (i.e. optimized) when read via from a ShapeReader.

See Also:

JtsGeometry.index()

getGeometryFrom

@Deprecated
public Geometry getGeometryFrom(Shape shape)

Deprecated.

Gets a JTS Geometry for the given Shape. Some shapes hold a JTS geometry whereas new ones must be created for the rest.

Parameters:

shape - Not null

Returns:

Not null

useJtsPoint

@Deprecated
public boolean useJtsPoint()

Deprecated.

Should SpatialContext.makePoint(double, double) return JtsPoint?

useJtsLineString

@Deprecated
public boolean useJtsLineString()

Deprecated.

Should SpatialContext.makeLineString(java.util.List) return JtsGeometry?

makeShapeFromGeometry

@Deprecated
public Shape makeShapeFromGeometry(Geometry geom)

Deprecated.

INTERNAL Usually creates a JtsGeometry, potentially validating, repairing, and indexing ("preparing"). This method is intended for use by ShapeReader instances. If given a direct instance of GeometryCollection then it's contents will be recursively converted and then the resulting list will be passed to SpatialContext.makeCollection(List) and returned. If given a Point then SpatialContext.makePoint(double, double) is called, which will return a JtsPoint if useJtsPoint(); otherwise a standard Spatial4j Point is returned. If given a LineString and if useJtsLineString() is true then then the geometry's parts are exposed to call SpatialContext.makeLineString(List).

makeShape

@Deprecated
public JtsGeometry makeShape(Geometry geom,
                             boolean dateline180Check,
                             boolean allowMultiOverlap)

Deprecated.

INTERNAL

Parameters:

geom - Non-null

dateline180Check - if both this is true and SpatialContext.isGeo(), then JtsGeometry will check for adjacent coordinates greater than 180 degrees longitude apart, and it will do tricks to make that line segment (and the shape as a whole) cross the dateline even though JTS doesn't have geodetic support.

allowMultiOverlap - See isAllowMultiOverlap().

See Also:

makeShape(org.locationtech.jts.geom.Geometry)

makeShape

@Deprecated
public JtsGeometry makeShape(Geometry geom)

Deprecated.

INTERNAL: Creates a Shape from a JTS Geometry. Generally, this shouldn't be called when one of the other factory methods are available, such as for points. The caller needs to have done some verification/normalization of the coordinates by now, if any. Also, note that direct instances of GeometryCollection isn't supported. Instead of calling this method, consider JtsShapeFactory.makeShapeFromGeometry(Geometry) which

getGeometryFactory

@Deprecated
public GeometryFactory getGeometryFactory()

Deprecated.

toString

public String toString()

Overrides:

toString in class SpatialContext

makeRectFromRectangularPoly

@Deprecated
public Rectangle makeRectFromRectangularPoly(Geometry geom)

Deprecated.

INTERNAL: Returns a Rectangle of the JTS Envelope (bounding box) of the given geom. This asserts that Geometry.isRectangle() is true. This method reacts to the DatelineRule setting.

Parameters:

geom - non-null

Returns:

null equivalent Rectangle.