Point field type
editPoint field type
editThe point
data type facilitates the indexing of and searching
arbitrary x, y
pairs that fall in a 2-dimensional planar
coordinate system.
You can query documents using this type using shape Query.
As with geo_shape and geo_point, point
can be specified in GeoJSON
and Well-Known Text formats.
However, there are a number of additional formats that are supported for convenience and historical reasons.
In total there are five ways that a cartesian point may be specified, as demonstrated below:
PUT my-index-000001 { "mappings": { "properties": { "location": { "type": "point" } } } } PUT my-index-000001/_doc/1 { "text": "Point as an object using GeoJSON format", "location": { "type": "Point", "coordinates": [-71.34, 41.12] } } PUT my-index-000001/_doc/2 { "text": "Point as a WKT POINT primitive", "location" : "POINT (-71.34 41.12)" } PUT my-index-000001/_doc/3 { "text": "Point as an object with 'x' and 'y' keys", "location": { "x": -71.34, "y": 41.12 } } PUT my-index-000001/_doc/4 { "text": "Point as an array", "location": [ -71.34, 41.12 ] } PUT my-index-000001/_doc/5 { "text": "Point as a string", "location": "-71.34,41.12" }
Point expressed as an object, in GeoJSON format, with |
|
Point expressed as a Well-Known Text
POINT with the format: |
|
Point expressed as an object, with |
|
Point expressed as an array with the format: [ |
|
Point expressed as a string with the format: |
Unlike the case with the geo-point field type,
the order of the coordinates x
and y
is the same for all formats above.
The coordinates provided to the indexer are single precision floating point values so
the field guarantees the same accuracy provided by the java virtual machine (typically
1E-38
).
Parameters for point
fields
editThe following parameters are accepted by point
fields:
If |
|
|
If |
Accepts an point value which is substituted for any explicit |
Sorting and retrieving points
editIt is currently not possible to sort points or retrieve their fields
directly. The point
value is only retrievable through the _source
field.