org.apache.lucene.spatial.geopoint.search

Class GeoPointInPolygonQuery

java.lang.Object

org.apache.lucene.search.Query

org.apache.lucene.spatial.geopoint.search.GeoPointInBBoxQuery

org.apache.lucene.spatial.geopoint.search.GeoPointInPolygonQuery

public final class GeoPointInPolygonQuery
extends GeoPointInBBoxQuery

Implements a simple point in polygon query on a GeoPoint field. This is based on GeoPointInBBoxQueryImpl and is implemented using a three phase approach. First, like GeoPointInBBoxQueryImpl candidate terms are queried using a numeric range based on the morton codes of the min and max lat/lon pairs. Terms passing this initial filter are passed to a secondary filter that verifies whether the decoded lat/lon point falls within (or on the boundary) of the bounding box query. Finally, the remaining candidate term is passed to the final point in polygon check.

See Also:

Polygon

Field Summary

Fields inherited from class org.apache.lucene.spatial.geopoint.search.GeoPointInBBoxQuery

field, maxLat, maxLon, minLat, minLon, termEncoding

Constructor Summary

Constructors

Constructor and Description
GeoPointInPolygonQuery(String field, double[] polyLats, double[] polyLons) Deprecated. Use GeoPointInPolygonQuery(String, Polygon[]).
GeoPointInPolygonQuery(String field, GeoPointField.TermEncoding termEncoding, double[] polyLats, double[] polyLons) Deprecated. Use GeoPointInPolygonQuery(String, GeoPointField.TermEncoding, Polygon[]) instead.
GeoPointInPolygonQuery(String field, GeoPointField.TermEncoding termEncoding, Polygon... polygons) Constructs a new GeoPolygonQuery that will match encoded GeoPointField terms that fall within or on the boundary of the polygons defined by the input parameters.
GeoPointInPolygonQuery(String field, Polygon... polygons) Constructs a new GeoPolygonQuery that will match encoded GeoPointField terms that fall within or on the boundary of the polygons defined by the input parameters.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj) Override and implement query instance equivalence properly in a subclass.
Polygon[]	getPolygons() API utility method for returning copy of the polygon array
int	hashCode() Override and implement query hash code properly in a subclass.
Query	rewrite(IndexReader reader) throw exception if trying to change rewrite method
String	toString(String field) print out this polygon query

Methods inherited from class org.apache.lucene.spatial.geopoint.search.GeoPointInBBoxQuery

getField, getMaxLat, getMaxLon, getMinLat, getMinLon

Methods inherited from class org.apache.lucene.search.Query

classHash, createWeight, sameClassAs, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

GeoPointInPolygonQuery

public GeoPointInPolygonQuery(String field,
                              Polygon... polygons)

Constructs a new GeoPolygonQuery that will match encoded GeoPointField terms that fall within or on the boundary of the polygons defined by the input parameters.

GeoPointInPolygonQuery

@Deprecated
public GeoPointInPolygonQuery(String field,
                                          double[] polyLats,
                                          double[] polyLons)

Deprecated. Use GeoPointInPolygonQuery(String, Polygon[]).

Constructs a new GeoPolygonQuery that will match encoded GeoPointField terms that fall within or on the boundary of the polygon defined by the input parameters.

GeoPointInPolygonQuery

@Deprecated
public GeoPointInPolygonQuery(String field,
                                          GeoPointField.TermEncoding termEncoding,
                                          double[] polyLats,
                                          double[] polyLons)

Deprecated. Use GeoPointInPolygonQuery(String, GeoPointField.TermEncoding, Polygon[]) instead.

Constructs a new GeoPolygonQuery that will match encoded GeoPointField terms that fall within or on the boundary of the polygon defined by the input parameters.

GeoPointInPolygonQuery

public GeoPointInPolygonQuery(String field,
                              GeoPointField.TermEncoding termEncoding,
                              Polygon... polygons)

Constructs a new GeoPolygonQuery that will match encoded GeoPointField terms that fall within or on the boundary of the polygons defined by the input parameters.

Method Detail

rewrite

public Query rewrite(IndexReader reader)

throw exception if trying to change rewrite method

Overrides:

rewrite in class GeoPointInBBoxQuery

hashCode

public int hashCode()

Description copied from class: Query

Override and implement query hash code properly in a subclass. This is required so that QueryCache works properly.

Overrides:

hashCode in class GeoPointInBBoxQuery

See Also:

Query.equals(Object)

equals

public boolean equals(Object obj)

Description copied from class: Query

Override and implement query instance equivalence properly in a subclass. This is required so that QueryCache works properly. Typically a query will be equal to another only if it's an instance of the same class and its document-filtering properties are identical that other instance. Utility methods are provided for certain repetitive code.

Overrides:

equals in class GeoPointInBBoxQuery

See Also:

Query.sameClassAs(Object), Query.classHash()

toString

public String toString(String field)

print out this polygon query

Overrides:

toString in class GeoPointInBBoxQuery

getPolygons

public Polygon[] getPolygons()

API utility method for returning copy of the polygon array