elasticsearch/docs/reference/aggregations
Craig Taverner 5f7ea792ac
Soft-deprecation of point/geo_point formats (#86835)
* Soft-deprecation of point/geo_point formats

Since GeoJSON and WKT are now common formats for all three types:
  geo_shape, geo_point and point
We decided to soft-deprecate the other point formats by ordering:
* GeoJSON (object with keys `type` and `coordinates`)
* WKT `POINT(x y)`
* Object with keys `lat` and `lon` (or `x` and `y` for point)
* Array [lon,lat]
* String `"lat,lon"` (or `"x,y"` in point)
* String with geohash (only in `geo_point`)

The geohash is last because it is only in one field type.
The string version is second last because it is the most controversial
being the only version to reverse the coordinate order from all other
formats (for geo_point only, since the coordinates are not reversed
in point).

In addition we replaced many examples in both documentation and tests
to prioritize WKT over the plain string format.

Many remaining examples of array format or object with keys still exist
and could be replaced by, for example, GeoJSON, if we feel the need.

* Incorrect quote position
2022-05-17 23:46:43 +02:00
..
bucket Soft-deprecation of point/geo_point formats (#86835) 2022-05-17 23:46:43 +02:00
metrics Soft-deprecation of point/geo_point formats (#86835) 2022-05-17 23:46:43 +02:00
pipeline [ML][Docs] fix minimum buckets for change_point agg (#86396) 2022-05-04 09:37:46 -04:00
bucket.asciidoc [DOCS] Adds frequent items agg docs (#86037) 2022-05-05 16:07:24 +02:00
metrics.asciidoc [DOCS] Fix acasting for agg types (#67469) 2021-01-13 14:44:54 -05:00
pipeline.asciidoc Allow bucket paths to specify _count within a bucket (#85720) 2022-04-29 08:42:46 -04:00