geo.totalDistance() function

geo.totalDistance() is experimental and subject to change at any time.

geo.totalDistance() calculates the total distance covered by subsequent points in each input table.

Each row must contain lat (latitude) and lon (longitude) columns that represent the geographic coordinates of the point. Row sort order determines the order in which distance between points is calculated. Use the geo.units option to specify the unit of distance to return (default is km).

Function type signature
(<-tables: stream[{B with lon: float, lat: float}], ?outputColumn: A) => stream[C] where C: Record
For more information, see Function type signatures.



Total distance output column. Default is _value.


Input data. Default is piped-forward data (<-).


Return the total distance travelled per input table

import "experimental/geo"

    |> geo.totalDistance()

View example input and output

Return the total distance travelled in miles

import "experimental/geo"

option geo.units = {distance: "mile"}

    |> geo.totalDistance()

View example input and output

Was this page helpful?

Thank you for your feedback!

Introducing InfluxDB 3.0

The new core of InfluxDB built with Rust and Apache Arrow. Available today in InfluxDB Cloud Dedicated.

Learn more

State of the InfluxDB Cloud Serverless documentation

The new documentation for InfluxDB Cloud Serverless is a work in progress. We are adding new information and content almost daily. Thank you for your patience!

If there is specific information you’re looking for, please submit a documentation issue.