elasticsearch/docs/reference/esql/functions/to_cartesianshape.asciidoc

[discrete]
[[esql-to_cartesianshape]]
=== `TO_CARTESIANSHAPE`

*Syntax*

[source,esql]
----
TO_CARTESIANSHAPE(v)
----

*Parameters*

`v`::
Input value. The input can be a single- or multi-valued column or an expression.
The input type must be a string, a `cartesian_shape` or a `cartesian_point`.

*Description*

Converts an input value to a `cartesian_shape` value.

A string will only be successfully converted if it respects the
{wikipedia}/Well-known_text_representation_of_geometry[WKT] format.

*Supported types*

include::types/to_cartesianshape.asciidoc[]

*Example*

[source.merge.styled,esql]
----
include::{esql-specs}/spatial_shapes.csv-spec[tag=to_cartesianshape-str]
----
[%header.monospaced.styled,format=dsv,separator=|]
|===
include::{esql-specs}/spatial_shapes.csv-spec[tag=to_cartesianshape-str-result]
|===