org.apache.solr.util

Class SpatialUtils

java.lang.Object

org.apache.solr.util.SpatialUtils

public class SpatialUtils
extends Object

Utility methods pertaining to spatial.

Method Summary

Methods

Modifier and Type	Method and Description
static com.spatial4j.core.shape.Shape	parseGeomSolrException(String geomStr, com.spatial4j.core.context.SpatialContext ctx) Parses a 'geom' parameter (might also be used to parse shapes for indexing).
static com.spatial4j.core.shape.Point	parsePoint(String str, com.spatial4j.core.context.SpatialContext ctx) Parses either "lat, lon" (spaces optional on either comma side) or "x y" style formats.
static com.spatial4j.core.shape.Point	parsePointSolrException(String externalVal, com.spatial4j.core.context.SpatialContext ctx) Calls parsePoint(String, com.spatial4j.core.context.SpatialContext) and wraps the exception with SolrException with a helpful message.
static com.spatial4j.core.shape.Rectangle	parseRectangeSolrException(String externalVal, com.spatial4j.core.context.SpatialContext ctx) Calls parseRectangle(String, com.spatial4j.core.context.SpatialContext) and wraps the exception with SolrException with a helpful message.
static com.spatial4j.core.shape.Rectangle	parseRectangle(String str, com.spatial4j.core.context.SpatialContext ctx) Parses str in the format of '[minPoint TO maxPoint]' where minPoint is the lower left corner and maxPoint is the upper-right corner of the bounding box.

Methods inherited from class java.lang.Object

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

Method Detail

parseGeomSolrException

public static com.spatial4j.core.shape.Shape parseGeomSolrException(String geomStr,
                                                    com.spatial4j.core.context.SpatialContext ctx)

Parses a 'geom' parameter (might also be used to parse shapes for indexing). geomStr can either be WKT or a rectangle-range syntax (see parseRectangle(String, com.spatial4j.core.context.SpatialContext).

parsePoint

public static com.spatial4j.core.shape.Point parsePoint(String str,
                                        com.spatial4j.core.context.SpatialContext ctx)
                                                 throws com.spatial4j.core.exception.InvalidShapeException

Parses either "lat, lon" (spaces optional on either comma side) or "x y" style formats. Spaces can be basically anywhere. And not any whitespace, just the space char.

Parameters:

str - Non-null; may have leading or trailing spaces

ctx - Non-null

Returns:

Non-null

Throws:

com.spatial4j.core.exception.InvalidShapeException - If for any reason there was a problem parsing the string or creating the point.

parsePointSolrException

public static com.spatial4j.core.shape.Point parsePointSolrException(String externalVal,
                                                     com.spatial4j.core.context.SpatialContext ctx)
                                                              throws SolrException

Calls parsePoint(String, com.spatial4j.core.context.SpatialContext) and wraps the exception with SolrException with a helpful message.

Throws:

SolrException

parseRectangle

public static com.spatial4j.core.shape.Rectangle parseRectangle(String str,
                                                com.spatial4j.core.context.SpatialContext ctx)
                                                         throws com.spatial4j.core.exception.InvalidShapeException

Parses str in the format of '[minPoint TO maxPoint]' where minPoint is the lower left corner and maxPoint is the upper-right corner of the bounding box. Both corners may optionally be wrapped with a quote and then it's parsed via parsePoint(String, com.spatial4j.core.context.SpatialContext).

Parameters:

str - Non-null; may *not* have leading or trailing spaces

ctx - Non-null

Returns:

the Rectangle

Throws:

com.spatial4j.core.exception.InvalidShapeException - If for any reason there was a problem parsing the string or creating the rectangle.

parseRectangeSolrException

public static com.spatial4j.core.shape.Rectangle parseRectangeSolrException(String externalVal,
                                                            com.spatial4j.core.context.SpatialContext ctx)
                                                                     throws SolrException

Calls parseRectangle(String, com.spatial4j.core.context.SpatialContext) and wraps the exception with SolrException with a helpful message.

Throws:

SolrException