mirror of
https://github.com/honeymoose/OpenSearch.git
synced 2025-02-11 07:25:23 +00:00
b41d5747f0
GeoDistance query, sort, and scripts make use of a crazy GeoDistance enum for handling 4 different ways of computing geo distance: SLOPPY_ARC, ARC, FACTOR, and PLANE. Only two of these are necessary: ARC, PLANE. This commit removes SLOPPY_ARC, and FACTOR and cleans up the way Geo distance is computed.
107 lines
4.1 KiB
Plaintext
107 lines
4.1 KiB
Plaintext
[[search-aggregations-bucket-geodistance-aggregation]]
|
|
=== Geo Distance Aggregation
|
|
|
|
A multi-bucket aggregation that works on `geo_point` fields and conceptually works very similar to the <<search-aggregations-bucket-range-aggregation,range>> aggregation. The user can define a point of origin and a set of distance range buckets. The aggregation evaluate the distance of each document value from the origin point and determines the buckets it belongs to based on the ranges (a document belongs to a bucket if the distance between the document and the origin falls within the distance range of the bucket).
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
{
|
|
"aggs" : {
|
|
"rings_around_amsterdam" : {
|
|
"geo_distance" : {
|
|
"field" : "location",
|
|
"origin" : "52.3760, 4.894",
|
|
"ranges" : [
|
|
{ "to" : 100 },
|
|
{ "from" : 100, "to" : 300 },
|
|
{ "from" : 300 }
|
|
]
|
|
}
|
|
}
|
|
}
|
|
}
|
|
--------------------------------------------------
|
|
|
|
Response:
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
{
|
|
"aggregations": {
|
|
"rings" : {
|
|
"buckets": [
|
|
{
|
|
"key": "*-100.0",
|
|
"from": 0,
|
|
"to": 100.0,
|
|
"doc_count": 3
|
|
},
|
|
{
|
|
"key": "100.0-300.0",
|
|
"from": 100.0,
|
|
"to": 300.0,
|
|
"doc_count": 1
|
|
},
|
|
{
|
|
"key": "300.0-*",
|
|
"from": 300.0,
|
|
"doc_count": 7
|
|
}
|
|
]
|
|
}
|
|
}
|
|
}
|
|
--------------------------------------------------
|
|
|
|
The specified field must be of type `geo_point` (which can only be set explicitly in the mappings). And it can also hold an array of `geo_point` fields, in which case all will be taken into account during aggregation. The origin point can accept all formats supported by the <<geo-point,`geo_point` type>>:
|
|
|
|
* Object format: `{ "lat" : 52.3760, "lon" : 4.894 }` - this is the safest format as it is the most explicit about the `lat` & `lon` values
|
|
* String format: `"52.3760, 4.894"` - where the first number is the `lat` and the second is the `lon`
|
|
* Array format: `[4.894, 52.3760]` - which is based on the `GeoJson` standard and where the first number is the `lon` and the second one is the `lat`
|
|
|
|
By default, the distance unit is `m` (metres) but it can also accept: `mi` (miles), `in` (inches), `yd` (yards), `km` (kilometers), `cm` (centimeters), `mm` (millimeters).
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
{
|
|
"aggs" : {
|
|
"rings" : {
|
|
"geo_distance" : {
|
|
"field" : "location",
|
|
"origin" : "52.3760, 4.894",
|
|
"unit" : "mi", <1>
|
|
"ranges" : [
|
|
{ "to" : 100 },
|
|
{ "from" : 100, "to" : 300 },
|
|
{ "from" : 300 }
|
|
]
|
|
}
|
|
}
|
|
}
|
|
}
|
|
--------------------------------------------------
|
|
|
|
<1> The distances will be computed as miles
|
|
|
|
There are two distance calculation modes: `arc` (the default), and `plane`. The `arc` calculation is the most accurate. The `plane` is the fastest but least accurate. Consider using `plane` when your search context is "narrow", and spans smaller geographical areas (~5km). `plane` will return higher error margins for searches across very large areas (e.g. cross continent search). The distance calculation type can be set using the `distance_type` parameter:
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
{
|
|
"aggs" : {
|
|
"rings" : {
|
|
"geo_distance" : {
|
|
"field" : "location",
|
|
"origin" : "52.3760, 4.894",
|
|
"distance_type" : "plane",
|
|
"ranges" : [
|
|
{ "to" : 100 },
|
|
{ "from" : 100, "to" : 300 },
|
|
{ "from" : 300 }
|
|
]
|
|
}
|
|
}
|
|
}
|
|
}
|
|
--------------------------------------------------
|