elasticsearch/docs/reference/query-languages/esql/_snippets/functions/st_distance.md

ST_DISTANCE [esql-st_distance]

Syntax

:::{image} ../../../../../images/st_distance.svg :alt: Embedded :class: text-center :::

Parameters

geomA : Expression of type geo_point or cartesian_point. If null, the function returns null.

geomB : Expression of type geo_point or cartesian_point. If null, the function returns null. The second parameter must also have the same coordinate system as the first. This means it is not possible to combine geo_point and cartesian_point parameters.

Description

Computes the distance between two points. For cartesian geometries, this is the pythagorean distance in the same units as the original coordinates. For geographic geometries, this is the circular distance along the great circle in meters.

Supported types

geomA	geomB	result
cartesian_point	cartesian_point	double
geo_point	geo_point	double

Example

FROM airports
| WHERE abbrev == "CPH"
| EVAL distance = ST_DISTANCE(location, city_location)
| KEEP abbrev, name, location, city_location, distance

abbrev:k	name:text	location:geo_point	city_location:geo_point	distance:d
CPH	Copenhagen	POINT(12.6493508684508 55.6285017221528)	POINT(12.5683 55.6761)	7339.573896618216