The POLYGON
field specifier (case sensitive) allows you to find documents whose X/Y position is within a specified polygonal shape.
You can specify the document position fields either as a pair of fields (corresponding to X and Y coordinate fields), or a single field that uses POINT or POLYGON definitions to specify position information (for example, a unified
field). If you use unified fields and the document contains a POLYGON definition, the document matches only if the polygon fits wholly within the polygon you specify in the field operator.
FieldText=POLYGON{coordX,coordY,coordX,coordY,...}:POSITION
coordX,coordY
|
The coordinates for one of the vertices. Specify an X/Y pair of coordinates for each vertex of the polygon working either clockwise or counterclockwise around the polygon. The polygon can be concave, but the edges cannot cross themselves. You can specify coordinates with decimal numbers. |
POSITION
|
The document field or fields that contain the position value. You can use one of the following options to specify location fields:
You can specify multiple options for the location fields, in form : NOTE: If you use multiple position fields or field pairs, Distributed Action Handler cannot match documents where a pair of split geospatial fields occurs interleaved with other geospatial fields. For example, if you use In such cases, you can rewrite the query, in the form |
NOTE: You can optimize this field specifier by configuring your coordinate fields with the
or
property types. If you want to use a single field with POINT or POLYGON definitions, you can optimize the field specifier only by using the unified
property.
FieldText=POLYGON{1,1,-1,1,0,-2,1,-1}:XPOS:YPOS:POSITION
This example matches all documents whose (X,Y) position is within the quadrilateral with vertices at (1,1), (-1,1), (0,-2), (1,-1).
|