elasticsearch/docs/reference/mapping
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
..
dynamic [DOCS] Update dynamic mapping docs to clarify supported match_mapping_type (#83274) 2022-02-01 10:37:27 -05:00
fields [DOCS] Custom routing for data streams 2021-11-10 07:11:50 -06:00
params Add support for dots in field names for metrics usecases (#86166) 2022-05-17 16:34:39 +02:00
types Soft-deprecation of point/geo_point formats (#86835) 2022-05-17 23:46:43 +02:00
dynamic-mapping.asciidoc [DOCS] Clean up index template xrefs (#67264) 2021-01-11 12:38:09 -05:00
explicit-mapping.asciidoc [DOCS] Replace put with create or update in API names (#70330) 2021-03-15 14:49:44 -04:00
fields.asciidoc Support fetching _tier field value (#71379) 2021-04-08 11:41:52 -07:00
mapping-settings-limit.asciidoc [DOCS] Relocate index.mapping.dimension_fields.limit setting docs (#80964) 2021-11-23 14:51:28 -05:00
params.asciidoc Add support for dots in field names for metrics usecases (#86166) 2022-05-17 16:34:39 +02:00
removal_of_types.asciidoc [DOCS] Fix double spaces (#71082) 2021-03-31 09:57:47 -04:00
runtime.asciidoc Fix a linebreak (#86739) (#86742) 2022-05-12 11:04:57 -04:00
types.asciidoc Clarify docs on field type families (#84368) 2022-02-24 13:27:36 -08:00