Spatial Functions

Example Graph

GQL
INSERT (paris:City {name: "Paris", location: point(2.4, 48.9), landmark: point3d(100, 25.3, 652.1)}),
       (newYork:City {name: "New York", location: point(-74.0, 40.7), landmark: point3d(95, 23, 54)}),
       (london:City {name: "London", location: point(-0.13, 51.5), landmark: point3d(5.2, 66, 3.2)}),
       (newYork)-[:Connects]->(paris),
       (newYork)-[:Connects]->(london),
       (paris)-[:Connects]->(london)

point()

Creates a two-dimensional geographical coordinate.

GQL
RETURN point(116.3, 39.9) AS point

Result:

JSON
{
  "longitude": 116.3, "latitude": 39.9
}

point3d()

Creates a three-dimensional Cartesian coordinate.

GQL
RETURN point3d(10, 15, 5) AS point3d

Result:

JSON
{
  "x": 10, "y": 15, "z": 5
}

distance()

Computes the distance between two points. For POINT values, it uses the Haversine formula to calculate the great-circle distance on Earth in kilometers. For POINT3D values, it computes the Euclidean distance.

GQL
MATCH (n1:City {name: 'New York'})
MATCH (n2:City {name: 'London'})
RETURN distance(n1.location, n2.location)

Result: 5570.833653336143

pointget()

Extracts a coordinate value from a POINT or POINT3D value by index.

GQL
MATCH (n {name: "New York"})
RETURN pointget(n.location, 0) AS longitude, pointget(n.location, 1) AS latitude

Result: