[discrete]
[[esql-to_cartesianshape]]
=== `TO_CARTESIANSHAPE`
Converts an input value to a `cartesian_shape` value.

The input can be a single- or multi-valued field or an expression.
The input type must be a string or a `cartesian_shape`.

A string will only be successfully converted if it respects the
https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry[WKT] format:

[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]
|===

Supported types:

include::types/to_cartesianshape.asciidoc[]
