Package org.apache.lucene.document
Class LatLonShape
- java.lang.Object
-
- org.apache.lucene.document.LatLonShape
-
public class LatLonShape extends Object
An geo shape utility class for indexing and searching gis geometries whose vertices are latitude, longitude values (in decimal degrees).This class defines seven static factory methods for common indexing and search operations:
createIndexableFields(String, Polygon)
for indexing a geo polygon.createIndexableFields(String, Polygon, boolean)
for indexing a geo polygon with the possibility of checking for self-intersections.createIndexableFields(String, Line)
for indexing a geo linestring.createIndexableFields(String, double, double)
for indexing a lat, lon geo point.newBoxQuery()
for matching geo shapes that have someShapeField.QueryRelation
with a bounding box.newLineQuery()
for matching geo shapes that have someShapeField.QueryRelation
with a linestring.newPolygonQuery()
for matching geo shapes that have someShapeField.QueryRelation
with a polygon.newGeometryQuery()
for matching geo shapes that have someShapeField.QueryRelation
with one or moreLatLonGeometry
.
LatLonPoint
, vertex values are indexed with some loss of precision from the originaldouble
values (4.190951585769653E-8 for the latitude component and 8.381903171539307E-8 for longitude).- See Also:
PointValues
,LatLonDocValuesField
-
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static Field[]
createIndexableFields(String fieldName, double lat, double lon)
create indexable fields for point geometrystatic Field[]
createIndexableFields(String fieldName, Line line)
create indexable fields for line geometrystatic Field[]
createIndexableFields(String fieldName, Polygon polygon)
create indexable fields for polygon geometry.static Field[]
createIndexableFields(String fieldName, Polygon polygon, boolean checkSelfIntersections)
create indexable fields for polygon geometry.static Query
newBoxQuery(String field, ShapeField.QueryRelation queryRelation, double minLatitude, double maxLatitude, double minLongitude, double maxLongitude)
create a query to find all indexed geo shapes that intersect a defined bounding box *static Query
newDistanceQuery(String field, ShapeField.QueryRelation queryRelation, Circle... circle)
create a query to find all polygons that intersect a provided circle.static Query
newGeometryQuery(String field, ShapeField.QueryRelation queryRelation, LatLonGeometry... latLonGeometries)
create a query to find all indexed geo shapes that intersect a provided geometry (or array of geometries).static Query
newLineQuery(String field, ShapeField.QueryRelation queryRelation, Line... lines)
create a query to find all indexed geo shapes that intersect a provided linestring (or array of linestrings) note: does not support dateline crossingstatic Query
newPointQuery(String field, ShapeField.QueryRelation queryRelation, double[]... points)
create a query to find all indexed shapes that comply theShapeField.QueryRelation
with the provided pointsstatic Query
newPolygonQuery(String field, ShapeField.QueryRelation queryRelation, Polygon... polygons)
create a query to find all indexed geo shapes that intersect a provided polygon (or array of polygons) note: does not support dateline crossing
-
-
-
Method Detail
-
createIndexableFields
public static Field[] createIndexableFields(String fieldName, Polygon polygon)
create indexable fields for polygon geometry.
-
createIndexableFields
public static Field[] createIndexableFields(String fieldName, Polygon polygon, boolean checkSelfIntersections)
create indexable fields for polygon geometry. IfcheckSelfIntersections
is set to true, the validity of the provided polygon is checked with a small performance penalty.
-
createIndexableFields
public static Field[] createIndexableFields(String fieldName, Line line)
create indexable fields for line geometry
-
createIndexableFields
public static Field[] createIndexableFields(String fieldName, double lat, double lon)
create indexable fields for point geometry
-
newBoxQuery
public static Query newBoxQuery(String field, ShapeField.QueryRelation queryRelation, double minLatitude, double maxLatitude, double minLongitude, double maxLongitude)
create a query to find all indexed geo shapes that intersect a defined bounding box *
-
newLineQuery
public static Query newLineQuery(String field, ShapeField.QueryRelation queryRelation, Line... lines)
create a query to find all indexed geo shapes that intersect a provided linestring (or array of linestrings) note: does not support dateline crossing
-
newPolygonQuery
public static Query newPolygonQuery(String field, ShapeField.QueryRelation queryRelation, Polygon... polygons)
create a query to find all indexed geo shapes that intersect a provided polygon (or array of polygons) note: does not support dateline crossing
-
newPointQuery
public static Query newPointQuery(String field, ShapeField.QueryRelation queryRelation, double[]... points)
create a query to find all indexed shapes that comply theShapeField.QueryRelation
with the provided points
-
newDistanceQuery
public static Query newDistanceQuery(String field, ShapeField.QueryRelation queryRelation, Circle... circle)
create a query to find all polygons that intersect a provided circle.
-
newGeometryQuery
public static Query newGeometryQuery(String field, ShapeField.QueryRelation queryRelation, LatLonGeometry... latLonGeometries)
create a query to find all indexed geo shapes that intersect a provided geometry (or array of geometries).
-
-