elasticsearch/docs/reference/query-dsl
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
..
_query-template.asciidoc
bool-query.asciidoc
boosting-query.asciidoc
combined-fields-query.asciidoc [DOCS] Fix `combined_fields` query ref in `multi_match` query docs (#81456) 2021-12-07 16:47:44 -05:00
compound-queries.asciidoc
constant-score-query.asciidoc
dis-max-query.asciidoc
distance-feature-query.asciidoc
exists-query.asciidoc
full-text-queries.asciidoc
function-score-query.asciidoc [DOCS] Correct spelling for geo terms (#76028) 2021-08-03 09:55:48 -04:00
fuzzy-query.asciidoc
geo-bounding-box-query.asciidoc Soft-deprecation of point/geo_point formats (#86835) 2022-05-17 23:46:43 +02:00
geo-distance-query.asciidoc Soft-deprecation of point/geo_point formats (#86835) 2022-05-17 23:46:43 +02:00
geo-polygon-query.asciidoc [DOCS] Correct spelling for geo terms (#76028) 2021-08-03 09:55:48 -04:00
geo-queries.asciidoc [DOCS] Correct spelling for geo terms (#76028) 2021-08-03 09:55:48 -04:00
geo-shape-query.asciidoc fixed typo (#84694) (#84726) 2022-03-07 14:30:51 -05:00
has-child-query.asciidoc
has-parent-query.asciidoc
ids-query.asciidoc
intervals-query.asciidoc
joining-queries.asciidoc
match-all-query.asciidoc
match-bool-prefix-query.asciidoc
match-phrase-prefix-query.asciidoc
match-phrase-query.asciidoc
match-query.asciidoc
minimum-should-match.asciidoc
mlt-query.asciidoc
multi-match-query.asciidoc [DOCS] Fix `combined_fields` query ref in `multi_match` query docs (#81456) 2021-12-07 16:47:44 -05:00
multi-term-rewrite.asciidoc
nested-query.asciidoc [DOCS] Clarify `nested` query behavior for `must_not` clauses (#82727) 2022-01-18 10:14:26 -05:00
parent-id-query.asciidoc [DOCS] Fix typo in parent-child example request (#76646) 2021-08-18 08:59:36 -04:00
percolate-query.asciidoc [DOCS] Fix percolate query headings (#83988) 2022-02-15 15:56:04 -05:00
pinned-query.asciidoc [DOCS] Remove `testenv` annotations from doc snippet tests (#80023) 2021-11-05 18:38:50 -04:00
prefix-query.asciidoc
query-string-query.asciidoc [DOCS] Note that `default_field` support wildcards (#81127) 2022-01-04 08:26:13 -05:00
query-string-syntax.asciidoc [DOCS] Query strings are normalized for fuzzy (`~`) operator (#73921) 2021-06-28 13:13:41 -04:00
query_filter_context.asciidoc
range-query.asciidoc
rank-feature-query.asciidoc [DOCS] Fix `track_total_hits` xref (#82739) 2022-01-18 12:43:17 -05:00
regexp-query.asciidoc
regexp-syntax.asciidoc [DOCS] Document missing `flag` values for `regexp` query (#82265) 2022-01-18 14:15:29 -05:00
script-query.asciidoc
script-score-query.asciidoc
shape-queries.asciidoc [DOCS] Remove `testenv` annotations from doc snippet tests (#80023) 2021-11-05 18:38:50 -04:00
shape-query.asciidoc [DOCS] Remove `testenv` annotations from doc snippet tests (#80023) 2021-11-05 18:38:50 -04:00
simple-query-string-query.asciidoc
span-containing-query.asciidoc
span-field-masking-query.asciidoc Rename field_masking_span to span_field_masking (#74718) 2021-07-09 08:56:38 +01:00
span-first-query.asciidoc
span-multi-term-query.asciidoc `indices.query.bool.max_clause_count` now limits all query clauses (#75297) 2021-07-21 12:16:30 +02:00
span-near-query.asciidoc
span-not-query.asciidoc
span-or-query.asciidoc
span-queries.asciidoc Rename field_masking_span to span_field_masking (#74718) 2021-07-09 08:56:38 +01:00
span-term-query.asciidoc
span-within-query.asciidoc
special-queries.asciidoc [DOCS] Correct spelling for geo terms (#76028) 2021-08-03 09:55:48 -04:00
term-level-queries.asciidoc
term-query.asciidoc
terms-query.asciidoc [DOCS] Re-add network traffic para to `term` query (#83047) 2022-01-25 10:27:10 -05:00
terms-set-query.asciidoc
wildcard-query.asciidoc [DOCS] Add `wildcard` parameter to `wildcard` query docs (#79722) 2021-10-26 12:35:11 -04:00
wrapper-query.asciidoc