This query function will calculate the distance, in meters, between two geographical coordinates (lat1, lon1) and (lat2, lon2) along an ideal earth surface.

It uses the Haversine approximation, which is accurate to about 0.5%. It does not take the altitude into account.

ParameterTypeRequiredDefault ValueDescription
asstringoptional[a] _distance The name of the field that is produced by the function.
lat1stringrequired   The field to use for latitude of first point.
lat2stringrequired   The field to use for latitude of second point.
lon1stringrequired   The field to use for longitude of first point.
lon2stringrequired   The field to use for longitude of second point.

[a] Optional parameters use their default value unless explicitly set.

Note

The values of latititude and longitude coordinates must be expressed in decimal degrees.

Click + next to an example below to get the full details.

Calculate Distance Between Geographical Coordinates

Calculate the distance between two geographical coordinates using the geography:distance() function