• Documentation
    • Search documentation
    karat

    +

    K

    API Reference ↗
    Data connectivity & integrationPipeline Builder ExpressionsCreate geodesic line string
    Feedback

    Create geodesic line string

    Supported in: Batch, Streaming

    Creates a geodesic line between two points.

    Expression categories: Geospatial

    Declared arguments

    • End point - Longitude and latitude for the end point.
      Expression<GeoPoint>
    • Starting point - Longitude and latitude for the starting point.
      Expression<GeoPoint>
    • optional Number of steps - The number of points to return in between the start and end point of the geodesic line segment. The default value is 24 points.
      Expression<Byte | Integer | Long | Short>

    Output type: Geometry

    Examples

    Example 1: Base case

    Argument values:

    • End point: endPoint
    • Starting point: startPoint
    • Number of steps: numSteps
    startPointendPointnumStepsOutput
    {
     latitude: 20.92,
     longitude: 179.0,
    }    		{
     latitude: 20.92,
     longitude: -178.0,
    }    		3{"type":"MultiLineString","coordinates":[[[-180.0, 20.925458598035362],[-179.5, 20.926550359447504],...

    Example 2: Base case

    Argument values:

    • End point: endPoint
    • Starting point: startPoint
    • Number of steps: numSteps
    startPointendPointnumStepsOutput
    {
     latitude: 38.9072,
     longitude: -77.0369,
    }    		{
     latitude: 20.92,
     longitude: -70.0,
    }    		8{"type":"LineString","coordinates":[[-77.0369, 38.90720000000001],[-76.10884874732801, 36.9298141100...

    Example 3: Base case

    Argument values:

    • End point: endPoint
    • Starting point: startPoint
    • Number of steps: numSteps
    startPointendPointnumStepsOutput
    {
     latitude: 34.1309,
     longitude: -88.908,
    }    		{
     latitude: 34.496,
     longitude: -83.9651,
    }    		4{"type":"LineString","coordinates":[[-88.90800000000002, 34.13089999999999],[-87.9230399151116, 34.2...

    Example 4: Base case

    Argument values:

    • End point: endPoint
    • Starting point: startPoint
    • Number of steps: numSteps
    startPointendPointnumStepsOutput
    {
     latitude: 39.4953,
     longitude: -89.6352,
    }    		{
     latitude: 61.0928,
     longitude: 62.2376,
    }    		4{"type":"LineString","coordinates":[[-89.6352, 39.4953],[-83.5342527561974, 54.30031923899314],[-70....

    Example 5: Base case

    Argument values:

    • End point: endPoint
    • Starting point: startPoint
    • Number of steps: numSteps
    startPointendPointnumStepsOutput
    {
     latitude: 38.9072,
     longitude: -77.0369,
    }    		{
     latitude: 20.92,
     longitude: -70.0,
    }    		null{"type":"LineString","coordinates":[[-77.0369, 38.90720000000001],[-76.69701959729164, 38.1961853930...

    Example 6: Base case

    Argument values:

    • End point: endPoint
    • Starting point: startPoint
    • Number of steps: numSteps
    startPointendPointnumStepsOutput
    {
     latitude: 20.92,
     longitude: -70.0,
    }    		{
     latitude: null,
     longitude: -77.0369,
    }    		8null

    Example 7: Base case

    Argument values:

    • End point: endPoint
    • Starting point: startPoint
    • Number of steps: numSteps
    startPointendPointnumStepsOutput
    {
     latitude: 20.92,
     longitude: -70.0,
    }    		{
     latitude: null,
     longitude: null,
    }    		8null

    Example 8: Base case

    Argument values:

    • End point: endPoint
    • Starting point: startPoint
    • Number of steps: numSteps
    startPointendPointnumStepsOutput
    {
     latitude: 20.92,
     longitude: -70.0,
    }    		{
     latitude: 38.9072,
     longitude: null,
    }    		8null

    Example 9: Base case

    Argument values:

    • End point: endPoint
    • Starting point: startPoint
    • Number of steps: numSteps
    startPointendPointnumStepsOutput
    {
     latitude: 39.4953,
     longitude: -89.6352,
    }    		null8null

    Example 10: Base case

    Argument values:

    • End point: endPoint
    • Starting point: startPoint
    • Number of steps: numSteps
    startPointendPointnumStepsOutput
    {
     latitude: null,
     longitude: null,
    }    		{
     latitude: null,
     longitude: null,
    }    		8null

    Example 11: Base case

    Argument values:

    • End point: endPoint
    • Starting point: startPoint
    • Number of steps: numSteps
    startPointendPointnumStepsOutput
    {
     latitude: null,
     longitude: null,
    }    		{
     latitude: null,
     longitude: null,
    }    		nullnull

    Example 12: Base case

    Argument values:

    • End point: endPoint
    • Starting point: startPoint
    • Number of steps: numSteps
    startPointendPointnumStepsOutput
    nullnull8null

    Example 13: Base case

    Argument values:

    • End point: endPoint
    • Starting point: startPoint
    • Number of steps: numSteps
    startPointendPointnumStepsOutput
    {
     latitude: null,
     longitude: -77.0369,
    }    		{
     latitude: 20.92,
     longitude: -70.0,
    }    		8null

    Example 14: Base case

    Argument values:

    • End point: endPoint
    • Starting point: startPoint
    • Number of steps: numSteps
    startPointendPointnumStepsOutput
    {
     latitude: null,
     longitude: null,
    }    		{
     latitude: 20.92,
     longitude: -70.0,
    }    		8null

    Example 15: Base case

    Argument values:

    • End point: endPoint
    • Starting point: startPoint
    • Number of steps: numSteps
    startPointendPointnumStepsOutput
    {
     latitude: 38.9072,
     longitude: null,
    }    		{
     latitude: 20.92,
     longitude: -70.0,
    }    		8null

    Example 16: Base case

    Argument values:

    • End point: endPoint
    • Starting point: startPoint
    • Number of steps: numSteps
    startPointendPointnumStepsOutput
    null{
     latitude: 20.92,
     longitude: -70.0,
    }    		8null