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

[discrete]
[[esql-to_geopoint]]
=== `TO_GEOPOINT`

*Syntax*

[source,esql]
----
TO_GEOPOINT(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 or a `geo_point`.

*Description*

Converts an input value to a `geo_point` value.

include::types/to_geopoint.asciidoc[]

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

*Example*

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