The GEOWITHIN
field specifier (case sensitive) allows you to find documents that have a document field that describes a location region that wholly fits within a specified point or polygonal shape.
When you specify a polygon, GEOWITHIN
matches points and polygons that occur wholly within the polygon. When you specify a point, GEOWITHIN
matches only points that exactly match that point.
FieldText=GEOWITHIN{POINT(coordX coordY)}:POSITION
or
FieldText=GEOWITHIN{POLYGON((coordX coordY, coordX coordY,...))}:POSITION
coordX coordY
|
The coordinates for a point or one of the vertices of a polygon. For a polygon, specify an X/Y pair of coordinates for each vertex, working either clockwise or counterclockwise around the polygon. The polygon can be concave, but the edges cannot cross themselves. The polygon can also contain holes. You can specify coordinates with decimal numbers. |
POSITION
|
The document field containing the position information. This field must contain unified geospatial location information (that is, Well-known text format POINT or POLYGON definitions). You can specify multiple options for the location fields, in form |
NOTE: You can optimize this field specifier by configuring the position field with the
field property.
FieldText=GEOWITHIN{POLYGON((1 1, -1 1, 0 -2, 1 -1))}:LOCATION
This example matches all documents whose (X,Y) position is within the quadrilateral with vertices at (1,1), (-1,1), (0,-2), (1,-1). A document returns if it has a LOCATION
field that contains either a POINT or POLYOGN definition that occurs wholly within the specified quadrilateral.
|