# 🛠️ TraceRoute – options Parameter

The `options` array in the TraceRoute API allows you to customize the output content and format of the route calculation. Each value in the array activates a specific feature or additional result in the response.

This tutorial explains the purpose and effect of each option, when to use them, and provides examples of how to include them in your request.



## ⚡ ENERGY_CONSUMPTION – Estimate energy usage along the route

✅ **Use case**

You want to retrieve **energy consumption estimates** for each segment of the route, based on your vehicle’s energy characteristics (like battery, weight, aerodynamic profile, etc.).

💡 **What it does**

When this option is set, the API returns a `energyConsumption` field in the response, representing the **estimated energy usage** in kilowatt-hours (kWh) across the entire route.
This helps assess whether a full trip is feasible with the current battery or if charging stops are needed.

> ⚠️ This option **requires** a `routingEnergyVehicleFeature` block in your `routingVehicleProfile`. If it's missing, the request may fail or return no consumption data.


🔧 **How to enable**

Add `ENERGY_CONSUMPTION` to the `options` array in your TraceRoute request, and make sure to include a properly filled `routingEnergyVehicleFeature`.


```
"options": ["ENERGY_CONSUMPTION"]
```

📦 **Example**


```
{
  "routingVehicleProfile": {
    "transportMode": "CAR",
    "routingEnergyVehicleFeature": {
      "batCapacity": 60.0,
      "energyLoad": 42.0,
      "payload": 100,
      "auxConsumption": 800,
      "dryWeight": 1800,
      "crr": 0.01,
      "scx": 0.6,
      "engineEfficiency": 0.9,
      "regenerativeBraking": true,
      "extTemp": 20.0,
      "maxAccel": 2.5,
      "maxDecel": -3.0
    }
  },
  "options": ["ENERGY_CONSUMPTION"],
  "destinations": [
    {
      "coordinateSat": {
        "lon": 2.3488,
        "lat": 48.8534,
        "speed": 20.0,
        "time": 1720519200000
      }
    },
    {
      "coordinateSat": {
        "lon": 2.3600,
        "lat": 48.8580,
        "speed": 35.0,
        "time": 1720519260000
      }
    },
    {
      "coordinateSat": {
        "lon": 2.3610,
        "lat": 48.8585,
        "speed": 33.0,
        "time": 1720519320000
      }
    },
    {
      "coordinateSat": {
        "lon": 2.3620,
        "lat": 48.8590,
        "speed": 36.0,
        "time": 1720519380000
      }
    },
    {
      "coordinateSat": {
        "lon": 2.3630,
        "lat": 48.8595,
        "speed": 38.0,
        "time": 1720519440000
      }
    },
    {
      "coordinateSat": {
        "lon": 2.3640,
        "lat": 48.8600,
        "speed": 40.0,
        "time": 1720519500000
      }
    },
    {
      "coordinateSat": {
        "lon": 2.3650,
        "lat": 48.8605,
        "speed": 41.0,
        "time": 1720519560000
      }
    },
    {
      "coordinateSat": {
        "lon": 2.3660,
        "lat": 48.8610,
        "speed": 42.0,
        "time": 1720519620000
      }
    },
    {
      "coordinateSat": {
        "lon": 2.3670,
        "lat": 48.8615,
        "speed": 40.0,
        "time": 1720519680000
      }
    },
    {
      "coordinateSat": {
        "lon": 2.3680,
        "lat": 48.8620,
        "speed": 38.0,
        "time": 1720519740000
      }
    },
    {
      "coordinateSat": {
        "lon": 2.3690,
        "lat": 48.8625,
        "speed": 35.0,
        "time": 1720519800000
      }
    },
    {
      "coordinateSat": {
        "lon": 2.3700,
        "lat": 48.8630,
        "speed": 30.0,
        "time": 1720519860000
      }
    }
  ]
}
```

**Response**


```
{
  "usedDestinations": [
    {
      "inputOrder": 0,
      "used": false,
      "usedOrder": 0,
      "confidenceValue": 0,
      "distanceFromRequest": 0,
      "polylineIndex": -1,
      "duration": -1,
      "length": -1
    },
    {
      "inputOrder": 1,
      "used": true,
      "usedOrder": 1,
      "matchedCoordinateGps": {
        "lon": 2.360015114939581,
        "lat": 48.858015
      },
      "confidenceValue": 0.9,
      "distanceFromRequest": 2,
      "polylineIndex": -1,
      "duration": -1,
      "length": -1
    },
    {
      "inputOrder": 2,
      "used": true,
      "usedOrder": 2,
      "matchedCoordinateGps": {
        "lon": 2.361159644312669,
        "lat": 48.8586675
      },
      "confidenceValue": 0.85,
      "distanceFromRequest": 22.01,
      "polylineIndex": -1,
      "duration": 51,
      "length": 222
    },
    {
      "inputOrder": 3,
      "used": true,
      "usedOrder": 3,
      "matchedCoordinateGps": {
        "lon": 2.3622205992189427,
        "lat": 48.85888
      },
      "confidenceValue": 0.28927187521472786,
      "distanceFromRequest": 20.96,
      "polylineIndex": -1,
      "duration": 92,
      "length": 330
    },
    {
      "inputOrder": 4,
      "used": true,
      "usedOrder": 4,
      "matchedCoordinateGps": {
        "lon": 2.3632036770414344,
        "lat": 48.859815
      },
      "confidenceValue": 0.4585633810385473,
      "distanceFromRequest": 38.11,
      "polylineIndex": -1,
      "duration": 212,
      "length": 770
    },
    {
      "inputOrder": 5,
      "used": true,
      "usedOrder": 5,
      "matchedCoordinateGps": {
        "lon": 2.3640594759297437,
        "lat": 48.86009
      },
      "confidenceValue": 0.6287187675009722,
      "distanceFromRequest": 10.92,
      "polylineIndex": -1,
      "duration": 254,
      "length": 878
    },
    {
      "inputOrder": 6,
      "used": true,
      "usedOrder": 6,
      "matchedCoordinateGps": {
        "lon": 2.36456,
        "lat": 48.86013
      },
      "confidenceValue": 0.23113073511408522,
      "distanceFromRequest": 52.3,
      "polylineIndex": -1,
      "duration": 274,
      "length": 940
    },
    {
      "inputOrder": 7,
      "used": true,
      "usedOrder": 7,
      "matchedCoordinateGps": {
        "lon": 2.3660428283122403,
        "lat": 48.86114125
      },
      "confidenceValue": 0.85,
      "distanceFromRequest": 16.03,
      "polylineIndex": -1,
      "duration": 394,
      "length": 1342
    },
    {
      "inputOrder": 8,
      "used": true,
      "usedOrder": 8,
      "matchedCoordinateGps": {
        "lon": 2.3669423826336007,
        "lat": 48.861375
      },
      "confidenceValue": 0.23983956831897124,
      "distanceFromRequest": 14.54,
      "polylineIndex": -1,
      "duration": 501,
      "length": 1656
    },
    {
      "inputOrder": 9,
      "used": true,
      "usedOrder": 9,
      "matchedCoordinateGps": {
        "lon": 2.3679160573446674,
        "lat": 48.86215125
      },
      "confidenceValue": 0.35939913638776866,
      "distanceFromRequest": 17.92,
      "polylineIndex": -1,
      "duration": 567,
      "length": 1938
    },
    {
      "inputOrder": 10,
      "used": true,
      "usedOrder": 10,
      "matchedCoordinateGps": {
        "lon": 2.369032257414646,
        "lat": 48.86244875
      },
      "confidenceValue": 0.85,
      "distanceFromRequest": 6.17,
      "polylineIndex": -1,
      "duration": 583,
      "length": 2026
    },
    {
      "inputOrder": 11,
      "used": true,
      "usedOrder": 11,
      "matchedCoordinateGps": {
        "lon": 2.3701541802535973,
        "lat": 48.86275125
      },
      "confidenceValue": 0.85,
      "distanceFromRequest": 29.9,
      "polylineIndex": -1,
      "duration": 599,
      "length": 2114
    }
  ],
  "routingRoutes": [
    {
      "length": 2114,
      "duration": 599,
      "trafficDelay": 0,
      "averageSpeed": 12.705175,
      "maximumSpeed": 0,
      "startUTurnThreshold": 3000,
      "energyConsumption": 0.4256013630880502,
      "startStopInfo": {
        "start": {
          "lon": 2.36002,
          "lat": 48.85802
        },
        "stop": {
          "lon": 2.37015,
          "lat": 48.86275
        },
        "distanceFirstMatched": 0.56,
        "distanceLastMatched": 0.14,
        "interDests": null
      }
    }
  ]
}
```

> ✅ Enables the `energyConsumption` field in the response, helping you estimate the vehicle’s energy needs across the route.




## 🧭 NO_MINIMAL_WAYPOINTS – Disable minimal waypoint filtering

✅ **Use case**

You want **all original waypoints** used in the request to be returned in the response, **even those not required to reproduce the route**. This is useful for debugging or for precise post-analysis of GPS data.

💡 **What it does**

By default, the TraceRoute service filters out intermediate waypoints that are not needed to reconstruct the final route.
This **"minimal waypoints" algorithm** improves performance and response size.

Enabling `NO_MINIMAL_WAYPOINTS` disables this behavior:

🔁 **All input coordinates** marked with `keptByMinimalWp = true` are preserved in the response,

📈 Resulting in faster processing and better fidelity when analyzing the full trace.

> ℹ️ This is a **sub-option** of the `WAYPOINTS` option.
It has no effect unless `WAYPOINTS` is also included.


🔧 **How to enable**

Add both `WAYPOINTS` and `NO_MINIMAL_WAYPOINTS` to the options array in your TraceRoute request.

Make sure to set `"keptByMinimalWp": true` on the destinations you want to preserve.


```json
"options": ["WAYPOINTS", "NO_MINIMAL_WAYPOINTS"]
```

📦 **Example**


```
{
  "routingVehicleProfile": {
    "transportMode": "CAR",
    "routingVehicleFeature": {
      "height": 150,
      "width": 180,
      "length": 450,
      "weight": 1.5,
      "axleWeight": 0.8
    }
  },
  "options": ["WAYPOINTS", "NO_MINIMAL_WAYPOINTS", "POLYLINE"],
  "destinations": [
    {
      "coordinateSat": {
        "lon": 2.3488,
        "lat": 48.8534,
        "speed": 30.0,
        "time": 1720519200000
      },
      "keptByMinimalWp": true
    },
    {
      "coordinateSat": {
        "lon": 2.3600,
        "lat": 48.8580,
        "speed": 28.0,
        "time": 1720519260000
      },
      "keptByMinimalWp": true
    },
    {
      "coordinateSat": {
        "lon": 2.3610,
        "lat": 48.8585,
        "speed": 29.0,
        "time": 1720519320000
      },
      "keptByMinimalWp": true
    },
    {
      "coordinateSat": {
        "lon": 2.3620,
        "lat": 48.8590,
        "speed": 31.0,
        "time": 1720519380000
      },
      "keptByMinimalWp": true
    },
    {
      "coordinateSat": {
        "lon": 2.3630,
        "lat": 48.8595,
        "speed": 34.0,
        "time": 1720519440000
      },
      "keptByMinimalWp": true
    },
    {
      "coordinateSat": {
        "lon": 2.3640,
        "lat": 48.8600,
        "speed": 36.0,
        "time": 1720519500000
      },
      "keptByMinimalWp": true
    },
    {
      "coordinateSat": {
        "lon": 2.3650,
        "lat": 48.8605,
        "speed": 38.0,
        "time": 1720519560000
      },
      "keptByMinimalWp": true
    },
    {
      "coordinateSat": {
        "lon": 2.3660,
        "lat": 48.8610,
        "speed": 39.0,
        "time": 1720519620000
      },
      "keptByMinimalWp": true
    },
    {
      "coordinateSat": {
        "lon": 2.3670,
        "lat": 48.8615,
        "speed": 40.0,
        "time": 1720519680000
      },
      "keptByMinimalWp": true
    },
    {
      "coordinateSat": {
        "lon": 2.3680,
        "lat": 48.8620,
        "speed": 32.0,
        "time": 1720519740000
      },
      "keptByMinimalWp": true
    }
  ]
}
```

**Response**


```
{
  "usedDestinations": [
    {
      "inputOrder": 0,
      "used": true,
      "usedOrder": 0,
      "matchedCoordinateGps": {
        "lon": 2.360015114939581,
        "lat": 48.85801375
      },
      "confidenceValue": 1,
      "distanceFromRequest": 968.78,
      "polylineIndex": -1,
      "duration": -1,
      "length": -1
    },
    {
      "inputOrder": 1,
      "used": true,
      "usedOrder": 1,
      "matchedCoordinateGps": {
        "lon": 2.360015114939581,
        "lat": 48.85801375
      },
      "confidenceValue": 1,
      "distanceFromRequest": 1.89,
      "polylineIndex": -1,
      "duration": 154,
      "length": 1281
    },
    {
      "inputOrder": 2,
      "used": true,
      "usedOrder": 2,
      "matchedCoordinateGps": {
        "lon": 2.361,
        "lat": 48.8585
      },
      "confidenceValue": 1,
      "distanceFromRequest": 0,
      "polylineIndex": -1,
      "duration": 154,
      "length": 1281
    },
    {
      "inputOrder": 3,
      "used": true,
      "usedOrder": 3,
      "matchedCoordinateGps": {
        "lon": 2.362,
        "lat": 48.859
      },
      "confidenceValue": 1,
      "distanceFromRequest": 0,
      "polylineIndex": -1,
      "duration": 154,
      "length": 1281
    },
    {
      "inputOrder": 4,
      "used": true,
      "usedOrder": 4,
      "matchedCoordinateGps": {
        "lon": 2.363,
        "lat": 48.8595
      },
      "confidenceValue": 1,
      "distanceFromRequest": 0,
      "polylineIndex": -1,
      "duration": 154,
      "length": 1281
    },
    {
      "inputOrder": 5,
      "used": true,
      "usedOrder": 5,
      "matchedCoordinateGps": {
        "lon": 2.364,
        "lat": 48.86
      },
      "confidenceValue": 1,
      "distanceFromRequest": 0,
      "polylineIndex": -1,
      "duration": 154,
      "length": 1281
    },
    {
      "inputOrder": 6,
      "used": true,
      "usedOrder": 6,
      "matchedCoordinateGps": {
        "lon": 2.365,
        "lat": 48.8605
      },
      "confidenceValue": 1,
      "distanceFromRequest": 0,
      "polylineIndex": -1,
      "duration": 154,
      "length": 1281
    },
    {
      "inputOrder": 7,
      "used": true,
      "usedOrder": 7,
      "matchedCoordinateGps": {
        "lon": 2.366,
        "lat": 48.861
      },
      "confidenceValue": 1,
      "distanceFromRequest": 0,
      "polylineIndex": -1,
      "duration": 154,
      "length": 1281
    },
    {
      "inputOrder": 8,
      "used": true,
      "usedOrder": 8,
      "matchedCoordinateGps": {
        "lon": 2.36766,
        "lat": 48.86209
      },
      "confidenceValue": 0.19683106570451814,
      "distanceFromRequest": 81.55,
      "polylineIndex": -1,
      "duration": 241,
      "length": 2003
    },
    {
      "inputOrder": 9,
      "used": true,
      "usedOrder": 9,
      "matchedCoordinateGps": {
        "lon": 2.3679160573446674,
        "lat": 48.86215125
      },
      "confidenceValue": 0.27536809596388057,
      "distanceFromRequest": 17.92,
      "polylineIndex": -1,
      "duration": 247,
      "length": 2022
    }
  ],
  "routingRoutes": [
    {
      "length": 2022,
      "duration": 247,
      "trafficDelay": 0,
      "averageSpeed": 29.470446,
      "maximumSpeed": 0,
      "startUTurnThreshold": 3000,
      "boundingBox": {
        "minLon": 2.360015114939581,
        "minLat": 48.85801375,
        "maxLon": 2.3753,
        "maxLat": 48.86617
      },
      "startStopInfo": {
        "start": {
          "lon": 2.36002,
          "lat": 48.85801
        },
        "stop": {
          "lon": 2.36792,
          "lat": 48.86215
        },
        "distanceFirstMatched": 0.42,
        "distanceLastMatched": 0.14,
        "interDests": null
      },
      "polyline": [
        {
          "lon": 2.360015114939581,
          "lat": 48.85801375
        },
        {
          "lon": 2.367,
          "lat": 48.8615
        },
        {
          "lon": 2.37464,
          "lat": 48.86558
        },
        {
          "lon": 2.3753,
          "lat": 48.86617
        },
        {
          "lon": 2.36766,
          "lat": 48.86209
        },
        {
          "lon": 2.3679160573446674,
          "lat": 48.86215125
        }
      ],
      "waypoints": [
        {
          "usedDestinationIndex": 0,
          "polylineIndex": -1,
          "coordinate": {
            "lon": 2.360015114939581,
            "lat": 48.85801375
          },
          "angle": 126,
          "radius": 0,
          "uturn": false,
          "ignorePoint": false,
          "ignoreTrafficDirections": false,
          "ignoreRoadBlocks": false,
          "ignoreRestrictions": false,
          "avoidUTurn": "UNDEF",
          "useStartAngle": "UNDEF",
          "useStopRoadSide": "UNDEF"
        },
        {
          "usedDestinationIndex": 1,
          "polylineIndex": -1,
          "coordinate": {
            "lon": 2.360015114939581,
            "lat": 48.85801375
          },
          "angle": 126,
          "radius": 0,
          "uturn": false,
          "ignorePoint": false,
          "ignoreTrafficDirections": false,
          "ignoreRoadBlocks": false,
          "ignoreRestrictions": false,
          "avoidUTurn": "UNDEF",
          "useStartAngle": "UNDEF",
          "useStopRoadSide": "UNDEF"
        },
        {
          "usedDestinationIndex": 2,
          "polylineIndex": -1,
          "coordinate": {
            "lon": 2.361,
            "lat": 48.8585
          },
          "angle": 51,
          "radius": 0,
          "uturn": false,
          "ignorePoint": true,
          "ignoreTrafficDirections": false,
          "ignoreRoadBlocks": false,
          "ignoreRestrictions": false,
          "avoidUTurn": "UNDEF",
          "useStartAngle": "UNDEF",
          "useStopRoadSide": "UNDEF"
        },
        {
          "usedDestinationIndex": 3,
          "polylineIndex": -1,
          "coordinate": {
            "lon": 2.362,
            "lat": 48.859
          },
          "angle": 51,
          "radius": 0,
          "uturn": false,
          "ignorePoint": true,
          "ignoreTrafficDirections": false,
          "ignoreRoadBlocks": false,
          "ignoreRestrictions": false,
          "avoidUTurn": "UNDEF",
          "useStartAngle": "UNDEF",
          "useStopRoadSide": "UNDEF"
        },
        {
          "usedDestinationIndex": 4,
          "polylineIndex": -1,
          "coordinate": {
            "lon": 2.363,
            "lat": 48.8595
          },
          "angle": 51,
          "radius": 0,
          "uturn": false,
          "ignorePoint": true,
          "ignoreTrafficDirections": false,
          "ignoreRoadBlocks": false,
          "ignoreRestrictions": false,
          "avoidUTurn": "UNDEF",
          "useStartAngle": "UNDEF",
          "useStopRoadSide": "UNDEF"
        },
        {
          "usedDestinationIndex": 5,
          "polylineIndex": -1,
          "coordinate": {
            "lon": 2.364,
            "lat": 48.86
          },
          "angle": 51,
          "radius": 0,
          "uturn": false,
          "ignorePoint": true,
          "ignoreTrafficDirections": false,
          "ignoreRoadBlocks": false,
          "ignoreRestrictions": false,
          "avoidUTurn": "UNDEF",
          "useStartAngle": "UNDEF",
          "useStopRoadSide": "UNDEF"
        },
        {
          "usedDestinationIndex": 6,
          "polylineIndex": -1,
          "coordinate": {
            "lon": 2.365,
            "lat": 48.8605
          },
          "angle": 51,
          "radius": 0,
          "uturn": false,
          "ignorePoint": true,
          "ignoreTrafficDirections": false,
          "ignoreRoadBlocks": false,
          "ignoreRestrictions": false,
          "avoidUTurn": "UNDEF",
          "useStartAngle": "UNDEF",
          "useStopRoadSide": "UNDEF"
        },
        {
          "usedDestinationIndex": 7,
          "polylineIndex": -1,
          "coordinate": {
            "lon": 2.366,
            "lat": 48.861
          },
          "angle": 51,
          "radius": 0,
          "uturn": false,
          "ignorePoint": true,
          "ignoreTrafficDirections": false,
          "ignoreRoadBlocks": false,
          "ignoreRestrictions": false,
          "avoidUTurn": "UNDEF",
          "useStartAngle": "UNDEF",
          "useStopRoadSide": "UNDEF"
        },
        {
          "usedDestinationIndex": 8,
          "polylineIndex": -1,
          "coordinate": {
            "lon": 2.36766,
            "lat": 48.86209
          },
          "angle": 71,
          "radius": 0,
          "uturn": false,
          "ignorePoint": false,
          "ignoreTrafficDirections": false,
          "ignoreRoadBlocks": false,
          "ignoreRestrictions": false,
          "avoidUTurn": "UNDEF",
          "useStartAngle": "UNDEF",
          "useStopRoadSide": "UNDEF"
        },
        {
          "usedDestinationIndex": 9,
          "polylineIndex": -1,
          "coordinate": {
            "lon": 2.3679160573446674,
            "lat": 48.86215125
          },
          "angle": 70,
          "radius": 0,
          "uturn": false,
          "ignorePoint": false,
          "ignoreTrafficDirections": false,
          "ignoreRoadBlocks": false,
          "ignoreRestrictions": false,
          "avoidUTurn": "UNDEF",
          "useStartAngle": "UNDEF",
          "useStopRoadSide": "UNDEF"
        }
      ]
    }
  ]
}
```

> ✅ Forces the API to keep all waypoints marked as `keptByMinimalWp: true` in the final result, instead of reducing to a minimal list.




## 🛤 OFFROADS – Return off-road polylines in waypoints

✅ **Use case**

You want to **identify off-road segments** between GPS points that **do not align perfectly with the road network**. This is useful when working with noisy GPS traces, or to detect areas without mapped roads (e.g. private roads, parking areas, tunnels).

💡 **What it does**

When enabled, the API adds an **offRoad** polyline to each relevant **waypoint** in the response.
This polyline connects the original GPS point to the **closest projected point on the road network**.

> 🧩 This is a **sub-option** of the `WAYPOINTS` option. It has **no effect** unless `WAYPOINTS` is also included.


Each `offRoad` field in the response is a simple array of two points:

The original GPS position

The snapped position on the road

🔧 **How to enable**

Add both `WAYPOINTS` and `OFFROADS` to the `options` array in your TraceRoute request.


```json
"options": ["WAYPOINTS", "OFFROADS"]
```

📦 **Example**


```
{
  "destinations": [
    {
      "coordinateSat": {
        "lon": 2.3470,
        "lat": 48.8540,
        "speed": 25.0,
        "time": 1720519200000
      }
    },
    {
      "coordinateSat": {
        "lon": 2.3499,
        "lat": 48.8582,
        "speed": 32.0,
        "time": 1720519260000
      }
    }
  ],
  "routingVehicleProfile": {
    "transportMode": "CAR",
    "routingVehicleFeature": {
      "height": 150,
      "width": 180,
      "length": 420,
      "weight": 1.4,
      "axleWeight": 0.8
    }
  },
  "options": ["WAYPOINTS", "OFFROADS"]
}
```

**Response**


```
{
  "usedDestinations": [
    {
      "inputOrder": 0,
      "used": true,
      "usedOrder": 0,
      "matchedCoordinateGps": {
        "lon": 2.346790437055014,
        "lat": 48.85365625
      },
      "confidenceValue": 0.06817058374151802,
      "distanceFromRequest": 41.23,
      "polylineIndex": -1,
      "duration": -1,
      "length": -1
    },
    {
      "inputOrder": 1,
      "used": true,
      "usedOrder": 1,
      "matchedCoordinateGps": {
        "lon": 2.34994,
        "lat": 48.85854
      },
      "confidenceValue": 0.07809670409272003,
      "distanceFromRequest": 37.96,
      "polylineIndex": -1,
      "duration": 251,
      "length": 836
    }
  ],
  "routingRoutes": [
    {
      "length": 836,
      "duration": 251,
      "trafficDelay": 0,
      "averageSpeed": 11.990438,
      "maximumSpeed": 0,
      "startUTurnThreshold": 3000,
      "startStopInfo": {
        "start": {
          "lon": 2.34679,
          "lat": 48.85366
        },
        "stop": {
          "lon": 2.34994,
          "lat": 48.85854
        },
        "distanceFirstMatched": 0.42,
        "distanceLastMatched": 0,
        "interDests": null
      },
      "waypoints": [
        {
          "usedDestinationIndex": 0,
          "polylineIndex": -1,
          "coordinate": {
            "lon": 2.346790437055014,
            "lat": 48.85365625
          },
          "angle": 291,
          "radius": 0,
          "uturn": false,
          "ignorePoint": false,
          "ignoreTrafficDirections": false,
          "ignoreRoadBlocks": false,
          "ignoreRestrictions": false,
          "avoidUTurn": "UNDEF",
          "useStartAngle": "UNDEF",
          "useStopRoadSide": "UNDEF"
        },
        {
          "usedDestinationIndex": 1,
          "polylineIndex": -1,
          "coordinate": {
            "lon": 2.34994,
            "lat": 48.85854
          },
          "angle": 99,
          "radius": 0,
          "uturn": false,
          "ignorePoint": false,
          "ignoreTrafficDirections": false,
          "ignoreRoadBlocks": false,
          "ignoreRestrictions": true,
          "avoidUTurn": "UNDEF",
          "useStartAngle": "UNDEF",
          "useStopRoadSide": "UNDEF"
        }
      ]
    }
  ]
}
```



## 🧪 OFFROADS_RAWDATA – Include raw map attributes for off-road segments

✅ **Use case**

You want **detailed map information** about the **off-road segments** (e.g. which road type it snapped to, surface type, etc.).
This is particularly useful for **debugging**, **analysis**, or building advanced visualizations.

💡 **What it does**

When enabled, the API includes **raw map attributes** in the `offRoadRawData` field for each `waypoint` that contains an `offRoad` segment.
These attributes reflect native metadata from the matched road segment, such as:

- Road classification
- Surface type
- Speed limit
- Access restrictions


> 🧩 This is a **sub-option** of `OFFROADS`, and has **no effect** unless `OFFROADS` is also present.


🔧 **How to enable**

Add the options `WAYPOINTS`, `OFFROADS` and `OFFROADS_RAWDATA` in your TraceRoute request.


```
"options": ["WAYPOINTS", "OFFROADS", "OFFROADS_RAWDATA"]
```

📦 **Example**


```
{
  "destinations": [
    {
      "coordinateSat": {
        "lon": 2.347,
        "lat": 48.854,
        "speed": 28.5,
        "time": 1720519200000
      }
    },
    {
      "coordinateSat": {
        "lon": 2.3499,
        "lat": 48.8582,
        "speed": 30.2,
        "time": 1720519260000
      }
    }
  ],
  "routingVehicleProfile": {
    "transportMode": "CAR",
    "routingVehicleFeature": {
      "height": 150,
      "width": 180,
      "length": 420,
      "weight": 1.4,
      "axleWeight": 0.8
    }
  },
  "options": ["WAYPOINTS", "OFFROADS", "OFFROADS_RAWDATA"]
}
```

**Response**


```
{
  "usedDestinations": [
    {
      "inputOrder": 0,
      "used": true,
      "usedOrder": 0,
      "matchedCoordinateGps": {
        "lon": 2.346790437055014,
        "lat": 48.85365625
      },
      "confidenceValue": 0.06817058374151802,
      "distanceFromRequest": 41.23,
      "polylineIndex": -1,
      "duration": -1,
      "length": -1
    },
    {
      "inputOrder": 1,
      "used": true,
      "usedOrder": 1,
      "matchedCoordinateGps": {
        "lon": 2.34994,
        "lat": 48.85854
      },
      "confidenceValue": 0.07809670409272003,
      "distanceFromRequest": 37.96,
      "polylineIndex": -1,
      "duration": 251,
      "length": 836
    }
  ],
  "routingRoutes": [
    {
      "length": 836,
      "duration": 251,
      "trafficDelay": 0,
      "averageSpeed": 11.990438,
      "maximumSpeed": 0,
      "startUTurnThreshold": 3000,
      "startStopInfo": {
        "start": {
          "lon": 2.34679,
          "lat": 48.85366
        },
        "stop": {
          "lon": 2.34994,
          "lat": 48.85854
        },
        "distanceFirstMatched": 0.42,
        "distanceLastMatched": 0,
        "interDests": null
      },
      "waypoints": [
        {
          "usedDestinationIndex": 0,
          "polylineIndex": -1,
          "coordinate": {
            "lon": 2.346790437055014,
            "lat": 48.85365625
          },
          "angle": 291,
          "radius": 0,
          "uturn": false,
          "ignorePoint": false,
          "ignoreTrafficDirections": false,
          "ignoreRoadBlocks": false,
          "ignoreRestrictions": false,
          "avoidUTurn": "UNDEF",
          "useStartAngle": "UNDEF",
          "useStopRoadSide": "UNDEF"
        },
        {
          "usedDestinationIndex": 1,
          "polylineIndex": -1,
          "coordinate": {
            "lon": 2.34994,
            "lat": 48.85854
          },
          "angle": 99,
          "radius": 0,
          "uturn": false,
          "ignorePoint": false,
          "ignoreTrafficDirections": false,
          "ignoreRoadBlocks": false,
          "ignoreRestrictions": true,
          "avoidUTurn": "UNDEF",
          "useStartAngle": "UNDEF",
          "useStopRoadSide": "UNDEF"
        }
      ]
    }
  ]
}
```

> ✅ Adds `offRoadRawData` alongside each `offRoad` segment, giving access to native road metadata for advanced inspection.




## 🛰️ OPENLR – Encode the route geometry in OpenLR format

✅ **Use case**

You want to share or store the **route geometry** in a **compact**, **interoperable format**, especially for use with systems or tools supporting **OpenLR** (like navigation SDKs, traffic systems, etc.).

💡 **What it does**

When this option is enabled, the API attempts to encode the route's geometry into an **OpenLR base64 string**, and includes it in the response under the field `openlr`.

- OpenLR is a location referencing standard designed for compact binary representation.
- The encoding may **fail** for certain types of routes (e.g. **U-turns** or geometries with high ambiguity), in which case the `openlr` field will be **absent**.


🔧 **How to enable**

Add `OPENLR` to the `options` array in your TraceRoute request.


```
"options": ["OPENLR"]
```

📦 **Example**


```
{
  "routingVehicleProfile": {
    "transportMode": "CAR",
    "routingVehicleFeature": {
      "height": 150,
      "width": 180,
      "length": 420,
      "weight": 1.4,
      "axleWeight": 0.8
    }
  },
  "options": ["OPENLR", "POLYLINE"],
  "destinations": [
    {
      "coordinateSat": {
        "lon": 7.066,
        "lat": 43.616,
        "heading": 17.6,
        "speed": 23.1,
        "time": 1396241966000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0664,
        "lat": 43.6162,
        "heading": 95.0,
        "speed": 29.3,
        "time": 1396241972000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0786,
        "lat": 43.6153,
        "heading": 119.0,
        "speed": 61.9,
        "time": 1396242062000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0805,
        "lat": 43.6147,
        "heading": 200.9,
        "speed": 50.6,
        "time": 1396242077000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0785,
        "lat": 43.6117,
        "heading": 115.8,
        "speed": 38.1,
        "time": 1396242104000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0787,
        "lat": 43.6118,
        "heading": 15.6,
        "speed": 26.0,
        "time": 1396242107000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0793,
        "lat": 43.6128,
        "heading": 76.0,
        "speed": 26.6,
        "time": 1396242128000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0814,
        "lat": 43.6116,
        "heading": 269.9,
        "speed": 5.6,
        "time": 1396242172000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0811,
        "lat": 43.6117,
        "heading": 338.7,
        "speed": 7.5,
        "time": 1396242182000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0812,
        "lat": 43.6119,
        "heading": 47.3,
        "speed": 14.9,
        "time": 1396242190000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0815,
        "lat": 43.6119,
        "heading": 127.1,
        "speed": 8.5,
        "time": 1396242198000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0816,
        "lat": 43.6118,
        "heading": 0.0,
        "speed": 0.0,
        "time": 1396242288000,
        "sat": 11
      }
    }
  ]
}
```

**Response**


```
{
  "usedDestinations": [
    {
      "inputOrder": 0,
      "used": true,
      "usedOrder": 0,
      "matchedCoordinateGps": {
        "lon": 7.06602,
        "lat": 43.61618
      },
      "confidenceValue": 0.07689281992526473,
      "distanceFromRequest": 20.1,
      "polylineIndex": -1,
      "duration": -1,
      "length": -1
    },
    {
      "inputOrder": 1,
      "used": true,
      "usedOrder": 1,
      "matchedCoordinateGps": {
        "lon": 7.066398283397998,
        "lat": 43.616205
      },
      "confidenceValue": 0.09921131156872807,
      "distanceFromRequest": 0.56,
      "polylineIndex": -1,
      "duration": 4,
      "length": 31
    },
    {
      "inputOrder": 2,
      "used": true,
      "usedOrder": 2,
      "matchedCoordinateGps": {
        "lon": 7.078628713869563,
        "lat": 43.61534125
      },
      "confidenceValue": 0.5117017827481006,
      "distanceFromRequest": 5.14,
      "polylineIndex": -1,
      "duration": 121,
      "length": 1128
    },
    {
      "inputOrder": 3,
      "used": true,
      "usedOrder": 3,
      "matchedCoordinateGps": {
        "lon": 7.080403748959592,
        "lat": 43.6147275
      },
      "confidenceValue": 0.22820475819113992,
      "distanceFromRequest": 8.34,
      "polylineIndex": -1,
      "duration": 143,
      "length": 1324
    },
    {
      "inputOrder": 4,
      "used": true,
      "usedOrder": 4,
      "matchedCoordinateGps": {
        "lon": 7.07845,
        "lat": 43.61179
      },
      "confidenceValue": 0.1539186659438396,
      "distanceFromRequest": 10.8,
      "polylineIndex": -1,
      "duration": 179,
      "length": 1718
    },
    {
      "inputOrder": 5,
      "used": true,
      "usedOrder": 5,
      "matchedCoordinateGps": {
        "lon": 7.07866,
        "lat": 43.61185
      },
      "confidenceValue": 0.16108117941441358,
      "distanceFromRequest": 6.43,
      "polylineIndex": -1,
      "duration": 181,
      "length": 1737
    },
    {
      "inputOrder": 6,
      "used": true,
      "usedOrder": 6,
      "matchedCoordinateGps": {
        "lon": 7.079378967392794,
        "lat": 43.6128575
      },
      "confidenceValue": 0.27133317856160843,
      "distanceFromRequest": 9.03,
      "polylineIndex": -1,
      "duration": 199,
      "length": 1895
    },
    {
      "inputOrder": 7,
      "used": true,
      "usedOrder": 7,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1558036422356276,
      "distanceFromRequest": 20.37,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 8,
      "used": true,
      "usedOrder": 8,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.15467894682254785,
      "distanceFromRequest": 6.54,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 9,
      "used": true,
      "usedOrder": 9,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1844632357817026,
      "distanceFromRequest": 23.43,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 10,
      "used": true,
      "usedOrder": 10,
      "matchedCoordinateGps": {
        "lon": 7.081303332134546,
        "lat": 43.61164
      },
      "confidenceValue": 0.1586887555888732,
      "distanceFromRequest": 33,
      "polylineIndex": -1,
      "duration": 229,
      "length": 2102
    },
    {
      "inputOrder": 11,
      "used": true,
      "usedOrder": 11,
      "matchedCoordinateGps": {
        "lon": 7.081771510364167,
        "lat": 43.6116975
      },
      "confidenceValue": 0.18750892219842968,
      "distanceFromRequest": 17.92,
      "polylineIndex": -1,
      "duration": 243,
      "length": 2151
    }
  ],
  "routingRoutes": [
    {
      "length": 2151,
      "duration": 243,
      "trafficDelay": 0,
      "averageSpeed": 31.866667,
      "maximumSpeed": 0,
      "startUTurnThreshold": 3000,
      "boundingBox": {
        "minLon": 7.06602,
        "minLat": 43.61153,
        "maxLon": 7.081771510364167,
        "maxLat": 43.6175
      },
      "startStopInfo": {
        "start": {
          "lon": 7.06602,
          "lat": 43.61618
        },
        "stop": {
          "lon": 7.08177,
          "lat": 43.6117
        },
        "distanceFirstMatched": 0,
        "distanceLastMatched": 0.28,
        "interDests": null
      },
      "polyline": [
        {
          "lon": 7.06602,
          "lat": 43.61618
        },
        {
          "lon": 7.06627,
          "lat": 43.61621
        },
        {
          "lon": 7.06668,
          "lat": 43.6162
        },
        {
          "lon": 7.06701,
          "lat": 43.61621
        },
```

> ✅ Adds an openlr field in the response with a base64-encoded representation of the route geometry.
⚠️ May be missing if encoding is not possible (e.g. U-turns).




## 🧩 POLYLINE – Return the route geometry as a polyline

✅ **Use case**

You want to visualize the full geometry of the matched route on a map using a compact and standard format like an encoded polyline.

💡 **What it does**

When the `POLYLINE` option is enabled, the response includes an additional `polyline` field that contains the encoded geometry of the route. This is useful for displaying the route on a frontend map or storing it efficiently.

🔧 **How to enable**

Add `POLYLINE` to the `options` array of your TraceRoute request.


```
"options": ["POLYLINE"]
```

📦 **Example**


```
{
  "routingVehicleProfile": {
    "transportMode": "CAR",
    "routingVehicleFeature": {
      "height": 150,
      "width": 180,
      "length": 420,
      "weight": 1400
    }
  },
  "options": ["POLYLINE"],
  "destinations": [
    {
      "coordinateSat": {
        "lon": 7.066,
        "lat": 43.616,
        "heading": 17.6,
        "speed": 23.1,
        "time": 1396241966000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0664,
        "lat": 43.6162,
        "heading": 95.0,
        "speed": 29.3,
        "time": 1396241972000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0786,
        "lat": 43.6153,
        "heading": 119.0,
        "speed": 61.9,
        "time": 1396242062000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0805,
        "lat": 43.6147,
        "heading": 200.9,
        "speed": 50.6,
        "time": 1396242077000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0785,
        "lat": 43.6117,
        "heading": 115.8,
        "speed": 38.1,
        "time": 1396242104000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0787,
        "lat": 43.6118,
        "heading": 15.6,
        "speed": 26.0,
        "time": 1396242107000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0793,
        "lat": 43.6128,
        "heading": 76.0,
        "speed": 26.6,
        "time": 1396242128000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0814,
        "lat": 43.6116,
        "heading": 269.9,
        "speed": 5.6,
        "time": 1396242172000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0811,
        "lat": 43.6117,
        "heading": 338.7,
        "speed": 7.5,
        "time": 1396242182000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0812,
        "lat": 43.6119,
        "heading": 47.3,
        "speed": 14.9,
        "time": 1396242190000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0815,
        "lat": 43.6119,
        "heading": 127.1,
        "speed": 8.5,
        "time": 1396242198000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0816,
        "lat": 43.6118,
        "heading": 0.0,
        "speed": 0.0,
        "time": 1396242288000,
        "sat": 11
      }
    }
  ]
}
```

**Response**


```
{
  "usedDestinations": [
    {
      "inputOrder": 0,
      "used": true,
      "usedOrder": 0,
      "matchedCoordinateGps": {
        "lon": 7.06602,
        "lat": 43.61618
      },
      "confidenceValue": 0.07689281992526473,
      "distanceFromRequest": 20.1,
      "polylineIndex": -1,
      "duration": -1,
      "length": -1
    },
    {
      "inputOrder": 1,
      "used": true,
      "usedOrder": 1,
      "matchedCoordinateGps": {
        "lon": 7.066398283397998,
        "lat": 43.616205
      },
      "confidenceValue": 0.09921131156872807,
      "distanceFromRequest": 0.56,
      "polylineIndex": -1,
      "duration": 4,
      "length": 31
    },
    {
      "inputOrder": 2,
      "used": true,
      "usedOrder": 2,
      "matchedCoordinateGps": {
        "lon": 7.078628713869563,
        "lat": 43.61534125
      },
      "confidenceValue": 0.5117017827481006,
      "distanceFromRequest": 5.14,
      "polylineIndex": -1,
      "duration": 121,
      "length": 1128
    },
    {
      "inputOrder": 3,
      "used": true,
      "usedOrder": 3,
      "matchedCoordinateGps": {
        "lon": 7.080403748959592,
        "lat": 43.6147275
      },
      "confidenceValue": 0.22820475819113992,
      "distanceFromRequest": 8.34,
      "polylineIndex": -1,
      "duration": 143,
      "length": 1324
    },
    {
      "inputOrder": 4,
      "used": true,
      "usedOrder": 4,
      "matchedCoordinateGps": {
        "lon": 7.07845,
        "lat": 43.61179
      },
      "confidenceValue": 0.1539186659438396,
      "distanceFromRequest": 10.8,
      "polylineIndex": -1,
      "duration": 179,
      "length": 1718
    },
    {
      "inputOrder": 5,
      "used": true,
      "usedOrder": 5,
      "matchedCoordinateGps": {
        "lon": 7.07866,
        "lat": 43.61185
      },
      "confidenceValue": 0.16108117941441358,
      "distanceFromRequest": 6.43,
      "polylineIndex": -1,
      "duration": 181,
      "length": 1737
    },
    {
      "inputOrder": 6,
      "used": true,
      "usedOrder": 6,
      "matchedCoordinateGps": {
        "lon": 7.079378967392794,
        "lat": 43.6128575
      },
      "confidenceValue": 0.27133317856160843,
      "distanceFromRequest": 9.03,
      "polylineIndex": -1,
      "duration": 199,
      "length": 1895
    },
    {
      "inputOrder": 7,
      "used": true,
      "usedOrder": 7,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1558036422356276,
      "distanceFromRequest": 20.37,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 8,
      "used": true,
      "usedOrder": 8,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.15467894682254785,
      "distanceFromRequest": 6.54,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 9,
      "used": true,
      "usedOrder": 9,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1844632357817026,
      "distanceFromRequest": 23.43,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 10,
      "used": true,
      "usedOrder": 10,
      "matchedCoordinateGps": {
        "lon": 7.081303332134546,
        "lat": 43.61164
      },
      "confidenceValue": 0.1586887555888732,
      "distanceFromRequest": 33,
      "polylineIndex": -1,
      "duration": 229,
      "length": 2102
    },
    {
      "inputOrder": 11,
      "used": true,
      "usedOrder": 11,
      "matchedCoordinateGps": {
        "lon": 7.081771510364167,
        "lat": 43.6116975
      },
      "confidenceValue": 0.18750892219842968,
      "distanceFromRequest": 17.92,
      "polylineIndex": -1,
      "duration": 243,
      "length": 2151
    }
  ],
  "routingRoutes": [
    {
      "length": 2151,
      "duration": 243,
      "trafficDelay": 0,
      "averageSpeed": 31.866667,
      "maximumSpeed": 0,
      "startUTurnThreshold": 3000,
      "boundingBox": {
        "minLon": 7.06602,
        "minLat": 43.61153,
        "maxLon": 7.081771510364167,
        "maxLat": 43.6175
      },
      "startStopInfo": {
        "start": {
          "lon": 7.06602,
          "lat": 43.61618
        },
        "stop": {
          "lon": 7.08177,
          "lat": 43.6117
        },
        "distanceFirstMatched": 0,
        "distanceLastMatched": 0.28,
        "interDests": null
      },
      "polyline": [
        {
          "lon": 7.06602,
          "lat": 43.61618
        },
        {
          "lon": 7.06627,
          "lat": 43.61621
        },
        {
          "lon": 7.06668,
          "lat": 43.6162
        },
```

> ✅ Returns a polyline field in the response for efficient geometry rendering on maps.




## 🧩 REVGEO_POSTAL_ADDRESS – Return postal addresses of matched coordinates

✅ **Use case**

You want to retrieve the postal address (street name, number, city, zip code, etc.) corresponding to each matched GPS coordinate in your TraceRoute request.

💡 **What it does**

When this option is enabled, the API performs a reverse geocoding on each matched coordinate and returns detailed postal address information. This is useful for displaying contextual data like start and end addresses or logging route steps.

🔧 **How to enable**

Add `REVGEO_POSTAL_ADDRESS` to the `options` array in your TraceRoute request.


```
"options": ["REVGEO_POSTAL_ADDRESS"]
```

📦 **Example**


```
{
  "routingVehicleProfile": {
    "transportMode": "CAR",
    "routingVehicleFeature": {
      "height": 160,
      "width": 180,
      "length": 450,
      "weight": 1300
    }
  },
  "options": ["REVGEO_POSTAL_ADDRESS", "POLYLINE"],
  "destinations": [
    {
      "coordinateSat": {
        "lon": 7.066,
        "lat": 43.616,
        "heading": 17.6,
        "speed": 23.1,
        "time": 1396241966000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0664,
        "lat": 43.6162,
        "heading": 95.0,
        "speed": 29.3,
        "time": 1396241972000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0786,
        "lat": 43.6153,
        "heading": 119.0,
        "speed": 61.9,
        "time": 1396242062000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0805,
        "lat": 43.6147,
        "heading": 200.9,
        "speed": 50.6,
        "time": 1396242077000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0785,
        "lat": 43.6117,
        "heading": 115.8,
        "speed": 38.1,
        "time": 1396242104000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0787,
        "lat": 43.6118,
        "heading": 15.6,
        "speed": 26.0,
        "time": 1396242107000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0793,
        "lat": 43.6128,
        "heading": 76.0,
        "speed": 26.6,
        "time": 1396242128000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0814,
        "lat": 43.6116,
        "heading": 269.9,
        "speed": 5.6,
        "time": 1396242172000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0811,
        "lat": 43.6117,
        "heading": 338.7,
        "speed": 7.5,
        "time": 1396242182000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0812,
        "lat": 43.6119,
        "heading": 47.3,
        "speed": 14.9,
        "time": 1396241966000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0815,
        "lat": 43.6119,
        "heading": 127.1,
        "speed": 8.5,
        "time": 1396242198000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0816,
        "lat": 43.6118,
        "heading": 0.0,
        "speed": 0.0,
        "time": 1396242288000,
        "sat": 11
      }
    }
  ]
}
```

**Response**


```
{
  "usedDestinations": [
    {
      "inputOrder": 0,
      "used": true,
      "usedOrder": 0,
      "matchedCoordinateGps": {
        "lon": 7.06602,
        "lat": 43.61618
      },
      "confidenceValue": 0.07689281992526473,
      "distanceFromRequest": 20.1,
      "polylineIndex": -1,
      "duration": -1,
      "length": -1
    },
    {
      "inputOrder": 1,
      "used": true,
      "usedOrder": 1,
      "matchedCoordinateGps": {
        "lon": 7.066398283397998,
        "lat": 43.616205
      },
      "confidenceValue": 0.09921131156872807,
      "distanceFromRequest": 0.56,
      "polylineIndex": -1,
      "duration": 4,
      "length": 31
    },
    {
      "inputOrder": 2,
      "used": true,
      "usedOrder": 2,
      "matchedCoordinateGps": {
        "lon": 7.078628713869563,
        "lat": 43.61534125
      },
      "confidenceValue": 0.5117017827481006,
      "distanceFromRequest": 5.14,
      "polylineIndex": -1,
      "duration": 121,
      "length": 1128
    },
    {
      "inputOrder": 3,
      "used": true,
      "usedOrder": 3,
      "matchedCoordinateGps": {
        "lon": 7.080403748959592,
        "lat": 43.6147275
      },
      "confidenceValue": 0.22820475819113992,
      "distanceFromRequest": 8.34,
      "polylineIndex": -1,
      "duration": 143,
      "length": 1324
    },
    {
      "inputOrder": 4,
      "used": true,
      "usedOrder": 4,
      "matchedCoordinateGps": {
        "lon": 7.07845,
        "lat": 43.61179
      },
      "confidenceValue": 0.1539186659438396,
      "distanceFromRequest": 10.8,
      "polylineIndex": -1,
      "duration": 179,
      "length": 1718
    },
    {
      "inputOrder": 5,
      "used": true,
      "usedOrder": 5,
      "matchedCoordinateGps": {
        "lon": 7.07866,
        "lat": 43.61185
      },
      "confidenceValue": 0.16108117941441358,
      "distanceFromRequest": 6.43,
      "polylineIndex": -1,
      "duration": 181,
      "length": 1737
    },
    {
      "inputOrder": 6,
      "used": true,
      "usedOrder": 6,
      "matchedCoordinateGps": {
        "lon": 7.079378967392794,
        "lat": 43.6128575
      },
      "confidenceValue": 0.27133317856160843,
      "distanceFromRequest": 9.03,
      "polylineIndex": -1,
      "duration": 199,
      "length": 1895
    },
    {
      "inputOrder": 7,
      "used": true,
      "usedOrder": 7,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1558036422356276,
      "distanceFromRequest": 20.37,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 8,
      "used": true,
      "usedOrder": 8,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.15467894682254785,
      "distanceFromRequest": 6.54,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 9,
      "used": true,
      "usedOrder": 9,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1844632357817026,
      "distanceFromRequest": 23.43,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 10,
      "used": true,
      "usedOrder": 10,
      "matchedCoordinateGps": {
        "lon": 7.081303332134546,
        "lat": 43.61164
      },
      "confidenceValue": 0.1586887555888732,
      "distanceFromRequest": 33,
      "polylineIndex": -1,
      "duration": 229,
      "length": 2102
    },
    {
      "inputOrder": 11,
      "used": true,
      "usedOrder": 11,
      "matchedCoordinateGps": {
        "lon": 7.081771510364167,
        "lat": 43.6116975
      },
      "confidenceValue": 0.18750892219842968,
      "distanceFromRequest": 17.92,
      "polylineIndex": -1,
      "duration": 243,
      "length": 2151
    }
  ],
  "routingRoutes": [
    {
      "length": 2151,
      "duration": 243,
      "trafficDelay": 0,
      "averageSpeed": 31.866667,
      "maximumSpeed": 0,
      "startUTurnThreshold": 3000,
      "routingInstructions": [
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 389,
          "duration": 37,
          "fromName": "Route des Lucioles",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07047,
            "lat": 43.61731
          },
          "roundAboutExitNumber": 2,
          "toName": "Carrefour du Golf",
          "toOn": "Carrefour du Golf",
          "textDist": "At 389 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 49,
          "duration": 11,
          "fromName": "Carrefour du Golf",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07093,
            "lat": 43.61741
          },
          "roundAboutExitNumber": 2,
          "toName": "D504",
          "toOn": "Route des Colles",
          "toRn": "D504",
          "textDist": "At 49 meters",
          "text": "From Route des Lucioles at roundabout take 2nd exit on D504"
        },
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 223,
          "duration": 20,
          "fromName": "Route des Colles",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07357,
            "lat": 43.61703
          },
          "roundAboutExitNumber": 3,
          "toName": "Carrefour Saint-Philippe",
          "toOn": "Carrefour Saint-Philippe",
          "textDist": "At 223 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 104,
          "duration": 29,
          "fromName": "Carrefour Saint-Philippe",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07463,
            "lat": 43.61674
          },
          "roundAboutExitNumber": 3,
          "toName": "D504",
          "toOn": "Route des Colles",
          "toRn": "D504",
          "textDist": "At 104 meters",
          "text": "From Route des Colles at roundabout take 3rd exit on D504"
        },
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 513,
          "duration": 39,
          "fromName": "Route des Colles",
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.08045,
            "lat": 43.61509
          },
          "roundAboutExitNumber": 1,
          "toName": "Carrefour des Chappes",
          "toOn": "Carrefour des Chappes",
          "textDist": "At 513 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 8,
          "duration": 3,
          "fromName": "Carrefour des Chappes",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.08053,
            "lat": 43.61505
          },
          "roundAboutExitNumber": 1,
          "toName": "D535",
          "toOn": "Route des Chappes",
          "toRn": "D535",
          "textDist": "At 8 meters",
          "text": "From Route des Colles at roundabout take 1st exit on D535"
        },
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 361,
          "duration": 26,
          "fromName": "Route des Chappes",
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.07845,
            "lat": 43.61221
          },
          "roundAboutExitNumber": 4,
          "textDist": "At 361 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 122,
          "duration": 20,
          "manoeuvre": "BEAR_RIGHT",
          "coordinate": {
            "lon": 7.07869,
            "lat": 43.61212
          },
          "roundAboutExitNumber": 4,
          "toName": "D535",
          "toOn": "Route des Chappes",
          "toRn": "D535",
          "textDist": "At 122 meters",
          "text": "From Route des Chappes at roundabout take 4th exit on D535"
        },
        {
          "type": "FOLLOW",
          "geoElementType": "ROAD",
          "length": 107,
          "duration": 9,
          "fromName": "Route des Chappes",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07921,
            "lat": 43.61298
          },
          "roundAboutExitNumber": 0,
          "toName": "Allée Charles-Victor Naudin",
          "toOn": "Allée Charles-Victor Naudin",
          "textDist": "At 107 meters",
          "text": "From Route des Chappes make a right turn on Allée Charles-Victor Naudin"
        },
        {
          "type": "FOLLOW",
          "geoElementType": "ROAD",
          "length": 246,
          "duration": 35,
          "fromName": "Allée Charles-Victor Naudin",
          "manoeuvre": "LEFT",
          "coordinate": {
            "lon": 7.08151,
            "lat": 43.61153
          },
          "roundAboutExitNumber": 0,
          "textDist": "At 246 meters",
          "text": "From Allée Charles-Victor Naudin make a left turn"
        },
        {
          "type": "STOP",
          "geoElementType": "ROAD",
          "length": 29,
          "duration": 12,
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.08177,
            "lat": 43.6117
          },
          "roundAboutExitNumber": 0,
          "textDist": "At 29 meters",
          "text": "Destination reached"
        }
      ],
      "boundingBox": {
        "minLon": 7.06602,
        "minLat": 43.61153,
        "maxLon": 7.081771510364167,
        "maxLat": 43.6175
      },
      "startStopInfo": {
        "start": {
          "lon": 7.06602,
          "lat": 43.61618
        },
        "stop": {
          "lon": 7.08177,
          "lat": 43.6117
        },
        "distanceFirstMatched": 0,
        "distanceLastMatched": 0.28,
        "interDests": null
      },
      "polyline": [
        {
          "lon": 7.06602,
          "lat": 43.61618
        },
        {
          "lon": 7.06627,
          "lat": 43.61621
        },
```

> ✅ Returns a `postalAddress` field for each matched coordinate in the response, useful for displaying or logging real-world addresses.




## 🧩 ROUTESHEET – Return a human-readable route sheet

✅ **Use case**

You want to generate a **turn-by-turn route sheet** (like a roadbook) summarizing the key maneuvers of the itinerary, including distance, direction, and road names.

💡 **What it does**

When this option is enabled, the API returns a `routeSheet` field in the response. It contains a *list of driving instructions** extracted from the route geometry and enriched with street names, distances, and directions (e.g., "Turn right onto Avenue de la République").

This is useful for:

- displaying navigation steps to the user
- exporting simplified navigation instructions
- integrating with map-based route viewers


🔧 **How to enable**

Add `ROUTESHEET` to the `options` array in your TraceRoute request.


```
"options": ["ROUTESHEET", "POLYLINE"]
```

📦 **Example**


```
{
  "routingVehicleProfile": {
    "transportMode": "CAR",
    "routingVehicleFeature": {
      "height": 160,
      "width": 180,
      "length": 450,
      "weight": 1300
    }
  },
  "options": ["ROUTESHEET", "POLYLINE"],
  "destinations": [
    {
      "coordinateSat": {
        "lon": 7.066,
        "lat": 43.616,
        "heading": 17.6,
        "speed": 23.1,
        "time": 1396241966000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0664,
        "lat": 43.6162,
        "heading": 95.0,
        "speed": 29.3,
        "time": 1396241972000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0786,
        "lat": 43.6153,
        "heading": 119.0,
        "speed": 61.9,
        "time": 1396242062000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0805,
        "lat": 43.6147,
        "heading": 200.9,
        "speed": 50.6,
        "time": 1396242077000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0785,
        "lat": 43.6117,
        "heading": 115.8,
        "speed": 38.1,
        "time": 1396242104000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0787,
        "lat": 43.6118,
        "heading": 15.6,
        "speed": 26.0,
        "time": 1396242107000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0793,
        "lat": 43.6128,
        "heading": 76.0,
        "speed": 26.6,
        "time": 1396242128000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0814,
        "lat": 43.6116,
        "heading": 269.9,
        "speed": 5.6,
        "time": 1396242172000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0811,
        "lat": 43.6117,
        "heading": 338.7,
        "speed": 7.5,
        "time": 1396242182000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0812,
        "lat": 43.6119,
        "heading": 47.3,
        "speed": 14.9,
        "time": 1396242188000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0815,
        "lat": 43.6119,
        "heading": 127.1,
        "speed": 8.5,
        "time": 1396242198000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0816,
        "lat": 43.6118,
        "heading": 0.0,
        "speed": 0.0,
        "time": 1396242288000,
        "sat": 11
      }
    }
  ]
}
```

**Response**


```
{
  "usedDestinations": [
    {
      "inputOrder": 0,
      "used": true,
      "usedOrder": 0,
      "matchedCoordinateGps": {
        "lon": 7.06602,
        "lat": 43.61618
      },
      "confidenceValue": 0.07689281992526473,
      "distanceFromRequest": 20.1,
      "polylineIndex": -1,
      "duration": -1,
      "length": -1
    },
    {
      "inputOrder": 1,
      "used": true,
      "usedOrder": 1,
      "matchedCoordinateGps": {
        "lon": 7.066398283397998,
        "lat": 43.616205
      },
      "confidenceValue": 0.09921131156872807,
      "distanceFromRequest": 0.56,
      "polylineIndex": -1,
      "duration": 4,
      "length": 31
    },
    {
      "inputOrder": 2,
      "used": true,
      "usedOrder": 2,
      "matchedCoordinateGps": {
        "lon": 7.078628713869563,
        "lat": 43.61534125
      },
      "confidenceValue": 0.5117017827481006,
      "distanceFromRequest": 5.14,
      "polylineIndex": -1,
      "duration": 121,
      "length": 1128
    },
    {
      "inputOrder": 3,
      "used": true,
      "usedOrder": 3,
      "matchedCoordinateGps": {
        "lon": 7.080403748959592,
        "lat": 43.6147275
      },
      "confidenceValue": 0.22820475819113992,
      "distanceFromRequest": 8.34,
      "polylineIndex": -1,
      "duration": 143,
      "length": 1324
    },
    {
      "inputOrder": 4,
      "used": true,
      "usedOrder": 4,
      "matchedCoordinateGps": {
        "lon": 7.07845,
        "lat": 43.61179
      },
      "confidenceValue": 0.1539186659438396,
      "distanceFromRequest": 10.8,
      "polylineIndex": -1,
      "duration": 179,
      "length": 1718
    },
    {
      "inputOrder": 5,
      "used": true,
      "usedOrder": 5,
      "matchedCoordinateGps": {
        "lon": 7.07866,
        "lat": 43.61185
      },
      "confidenceValue": 0.16108117941441358,
      "distanceFromRequest": 6.43,
      "polylineIndex": -1,
      "duration": 181,
      "length": 1737
    },
    {
      "inputOrder": 6,
      "used": true,
      "usedOrder": 6,
      "matchedCoordinateGps": {
        "lon": 7.079378967392794,
        "lat": 43.6128575
      },
      "confidenceValue": 0.27133317856160843,
      "distanceFromRequest": 9.03,
      "polylineIndex": -1,
      "duration": 199,
      "length": 1895
    },
    {
      "inputOrder": 7,
      "used": true,
      "usedOrder": 7,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1558036422356276,
      "distanceFromRequest": 20.37,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 8,
      "used": true,
      "usedOrder": 8,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.15467894682254785,
      "distanceFromRequest": 6.54,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 9,
      "used": true,
      "usedOrder": 9,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1844632357817026,
      "distanceFromRequest": 23.43,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 10,
      "used": true,
      "usedOrder": 10,
      "matchedCoordinateGps": {
        "lon": 7.081303332134546,
        "lat": 43.61164
      },
      "confidenceValue": 0.1586887555888732,
      "distanceFromRequest": 33,
      "polylineIndex": -1,
      "duration": 229,
      "length": 2102
    },
    {
      "inputOrder": 11,
      "used": true,
      "usedOrder": 11,
      "matchedCoordinateGps": {
        "lon": 7.081771510364167,
        "lat": 43.6116975
      },
      "confidenceValue": 0.18750892219842968,
      "distanceFromRequest": 17.92,
      "polylineIndex": -1,
      "duration": 243,
      "length": 2151
    }
  ],
  "routingRoutes": [
    {
      "length": 2151,
      "duration": 243,
      "trafficDelay": 0,
      "averageSpeed": 31.866667,
      "maximumSpeed": 0,
      "startUTurnThreshold": 3000,
      "routingInstructions": [
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 389,
          "duration": 37,
          "fromName": "Route des Lucioles",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07047,
            "lat": 43.61731
          },
          "roundAboutExitNumber": 2,
          "toName": "Carrefour du Golf",
          "toOn": "Carrefour du Golf",
          "textDist": "At 389 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 49,
          "duration": 11,
          "fromName": "Carrefour du Golf",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07093,
            "lat": 43.61741
          },
          "roundAboutExitNumber": 2,
          "toName": "D504",
          "toOn": "Route des Colles",
          "toRn": "D504",
          "textDist": "At 49 meters",
          "text": "From Route des Lucioles at roundabout take 2nd exit on D504"
        },
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 223,
          "duration": 20,
          "fromName": "Route des Colles",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07357,
            "lat": 43.61703
          },
          "roundAboutExitNumber": 3,
          "toName": "Carrefour Saint-Philippe",
          "toOn": "Carrefour Saint-Philippe",
          "textDist": "At 223 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 104,
          "duration": 29,
          "fromName": "Carrefour Saint-Philippe",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07463,
            "lat": 43.61674
          },
          "roundAboutExitNumber": 3,
          "toName": "D504",
          "toOn": "Route des Colles",
          "toRn": "D504",
          "textDist": "At 104 meters",
          "text": "From Route des Colles at roundabout take 3rd exit on D504"
        },
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 513,
          "duration": 39,
          "fromName": "Route des Colles",
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.08045,
            "lat": 43.61509
          },
          "roundAboutExitNumber": 1,
          "toName": "Carrefour des Chappes",
          "toOn": "Carrefour des Chappes",
          "textDist": "At 513 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 8,
          "duration": 3,
          "fromName": "Carrefour des Chappes",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.08053,
            "lat": 43.61505
          },
          "roundAboutExitNumber": 1,
          "toName": "D535",
          "toOn": "Route des Chappes",
          "toRn": "D535",
          "textDist": "At 8 meters",
          "text": "From Route des Colles at roundabout take 1st exit on D535"
        },
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 361,
          "duration": 26,
          "fromName": "Route des Chappes",
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.07845,
            "lat": 43.61221
          },
          "roundAboutExitNumber": 4,
          "textDist": "At 361 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 122,
          "duration": 20,
          "manoeuvre": "BEAR_RIGHT",
          "coordinate": {
            "lon": 7.07869,
            "lat": 43.61212
          },
          "roundAboutExitNumber": 4,
          "toName": "D535",
          "toOn": "Route des Chappes",
          "toRn": "D535",
          "textDist": "At 122 meters",
          "text": "From Route des Chappes at roundabout take 4th exit on D535"
        },
        {
          "type": "FOLLOW",
          "geoElementType": "ROAD",
          "length": 107,
          "duration": 9,
          "fromName": "Route des Chappes",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07921,
            "lat": 43.61298
          },
          "roundAboutExitNumber": 0,
          "toName": "Allée Charles-Victor Naudin",
          "toOn": "Allée Charles-Victor Naudin",
          "textDist": "At 107 meters",
          "text": "From Route des Chappes make a right turn on Allée Charles-Victor Naudin"
        },
        {
          "type": "FOLLOW",
          "geoElementType": "ROAD",
          "length": 246,
          "duration": 35,
          "fromName": "Allée Charles-Victor Naudin",
          "manoeuvre": "LEFT",
          "coordinate": {
            "lon": 7.08151,
            "lat": 43.61153
          },
          "roundAboutExitNumber": 0,
          "textDist": "At 246 meters",
          "text": "From Allée Charles-Victor Naudin make a left turn"
        },
        {
          "type": "STOP",
          "geoElementType": "ROAD",
          "length": 29,
          "duration": 12,
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.08177,
            "lat": 43.6117
          },
          "roundAboutExitNumber": 0,
          "textDist": "At 29 meters",
          "text": "Destination reached"
        }
      ],
      "boundingBox": {
        "minLon": 7.06602,
        "minLat": 43.61153,
        "maxLon": 7.081771510364167,
        "maxLat": 43.6175
      },
      "startStopInfo": {
        "start": {
          "lon": 7.06602,
          "lat": 43.61618
        },
        "stop": {
          "lon": 7.08177,
          "lat": 43.6117
        },
        "distanceFirstMatched": 0,
        "distanceLastMatched": 0.28,
        "interDests": null
      },
      "polyline": [
        {
          "lon": 7.06602,
          "lat": 43.61618
        },
        {
          "lon": 7.06627,
          "lat": 43.61621
        },
```

> ✅ Returns a `routeSheet` list containing detailed instructions like "Turn left", "Continue on Rue de Rivoli", etc., for each maneuver.




## 🧩 ROUTESHEET_VERBOSE_HIGH – Enable highly detailed route sheet

✅ **Use case**

You need a **very detailed route sheet** with extra information for each instruction (e.g., road classifications, more descriptive steps, segment info). Ideal for:

- advanced navigation systems,
- printing exhaustive roadbooks,
- precise driving analysis.


💡 **What it does**

This option increases the verbosity of the route sheet returned when `ROUTESHEET` is active. Each instruction includes **additional metadata**, such as:

- functional road class (FRC),
- road type,
- extended descriptions.


This option is only effective when `ROUTESHEET` is already enabled.

🔧 **How to enable**

Add both `ROUTESHEET` and `ROUTESHEET_VERBOSE_HIGH` to the `options` array in your request.


```
"options": ["ROUTESHEET", "ROUTESHEET_VERBOSE_HIGH"]
```

📦 **Example**


```
{
  "routingVehicleProfile": {
    "transportMode": "CAR",
    "routingVehicleFeature": {
      "height": 160,
      "width": 180,
      "length": 450,
      "weight": 1300
    }
  },
  "options": ["ROUTESHEET", "ROUTESHEET_VERBOSE_HIGH", "POLYLINE"],
  "destinations": [
    {
      "coordinateSat": {
        "lon": 7.066,
        "lat": 43.616,
        "heading": 17.6,
        "speed": 23.1,
        "time": 1396241966000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0664,
        "lat": 43.6162,
        "heading": 95.0,
        "speed": 29.3,
        "time": 1396241972000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0786,
        "lat": 43.6153,
        "heading": 119.0,
        "speed": 61.9,
        "time": 1396242062000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0805,
        "lat": 43.6147,
        "heading": 200.9,
        "speed": 50.6,
        "time": 1396242077000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0785,
        "lat": 43.6117,
        "heading": 115.8,
        "speed": 38.1,
        "time": 1396242104000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0787,
        "lat": 43.6118,
        "heading": 15.6,
        "speed": 26.0,
        "time": 1396242107000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0793,
        "lat": 43.6128,
        "heading": 76.0,
        "speed": 26.6,
        "time": 1396242128000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0814,
        "lat": 43.6116,
        "heading": 269.9,
        "speed": 5.6,
        "time": 1396242172000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0811,
        "lat": 43.6117,
        "heading": 338.7,
        "speed": 7.5,
        "time": 1396242182000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0812,
        "lat": 43.6119,
        "heading": 47.3,
        "speed": 14.9,
        "time": 1396242188000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0815,
        "lat": 43.6119,
        "heading": 127.1,
        "speed": 8.5,
        "time": 1396242198000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0816,
        "lat": 43.6118,
        "heading": 0.0,
        "speed": 0.0,
        "time": 1396242288000,
        "sat": 11
      }
    }
  ]
}
```

**Response**


```
{
  "usedDestinations": [
    {
      "inputOrder": 0,
      "used": true,
      "usedOrder": 0,
      "matchedCoordinateGps": {
        "lon": 7.06602,
        "lat": 43.61618
      },
      "confidenceValue": 0.07689281992526473,
      "distanceFromRequest": 20.1,
      "polylineIndex": -1,
      "duration": -1,
      "length": -1
    },
    {
      "inputOrder": 1,
      "used": true,
      "usedOrder": 1,
      "matchedCoordinateGps": {
        "lon": 7.066398283397998,
        "lat": 43.616205
      },
      "confidenceValue": 0.09921131156872807,
      "distanceFromRequest": 0.56,
      "polylineIndex": -1,
      "duration": 4,
      "length": 31
    },
    {
      "inputOrder": 2,
      "used": true,
      "usedOrder": 2,
      "matchedCoordinateGps": {
        "lon": 7.078628713869563,
        "lat": 43.61534125
      },
      "confidenceValue": 0.5117017827481006,
      "distanceFromRequest": 5.14,
      "polylineIndex": -1,
      "duration": 121,
      "length": 1128
    },
    {
      "inputOrder": 3,
      "used": true,
      "usedOrder": 3,
      "matchedCoordinateGps": {
        "lon": 7.080403748959592,
        "lat": 43.6147275
      },
      "confidenceValue": 0.22820475819113992,
      "distanceFromRequest": 8.34,
      "polylineIndex": -1,
      "duration": 143,
      "length": 1324
    },
    {
      "inputOrder": 4,
      "used": true,
      "usedOrder": 4,
      "matchedCoordinateGps": {
        "lon": 7.07845,
        "lat": 43.61179
      },
      "confidenceValue": 0.1539186659438396,
      "distanceFromRequest": 10.8,
      "polylineIndex": -1,
      "duration": 179,
      "length": 1718
    },
    {
      "inputOrder": 5,
      "used": true,
      "usedOrder": 5,
      "matchedCoordinateGps": {
        "lon": 7.07866,
        "lat": 43.61185
      },
      "confidenceValue": 0.16108117941441358,
      "distanceFromRequest": 6.43,
      "polylineIndex": -1,
      "duration": 181,
      "length": 1737
    },
    {
      "inputOrder": 6,
      "used": true,
      "usedOrder": 6,
      "matchedCoordinateGps": {
        "lon": 7.079378967392794,
        "lat": 43.6128575
      },
      "confidenceValue": 0.27133317856160843,
      "distanceFromRequest": 9.03,
      "polylineIndex": -1,
      "duration": 199,
      "length": 1895
    },
    {
      "inputOrder": 7,
      "used": true,
      "usedOrder": 7,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1558036422356276,
      "distanceFromRequest": 20.37,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 8,
      "used": true,
      "usedOrder": 8,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.15467894682254785,
      "distanceFromRequest": 6.54,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 9,
      "used": true,
      "usedOrder": 9,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1844632357817026,
      "distanceFromRequest": 23.43,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 10,
      "used": true,
      "usedOrder": 10,
      "matchedCoordinateGps": {
        "lon": 7.081303332134546,
        "lat": 43.61164
      },
      "confidenceValue": 0.1586887555888732,
      "distanceFromRequest": 33,
      "polylineIndex": -1,
      "duration": 229,
      "length": 2102
    },
    {
      "inputOrder": 11,
      "used": true,
      "usedOrder": 11,
      "matchedCoordinateGps": {
        "lon": 7.081771510364167,
        "lat": 43.6116975
      },
      "confidenceValue": 0.18750892219842968,
      "distanceFromRequest": 17.92,
      "polylineIndex": -1,
      "duration": 243,
      "length": 2151
    }
  ],
  "routingRoutes": [
    {
      "length": 2151,
      "duration": 243,
      "trafficDelay": 0,
      "averageSpeed": 31.866667,
      "maximumSpeed": 0,
      "startUTurnThreshold": 3000,
      "routingInstructions": [
        {
          "type": "FOLLOW",
          "geoElementType": "ROAD",
          "length": 20,
          "duration": 2,
          "fromName": "Route des Lucioles",
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.06627,
            "lat": 43.61621
          },
          "roundAboutExitNumber": 0,
          "toName": "Route des Lucioles",
          "toOn": "Route des Lucioles",
          "toRn": "D504",
          "textDist": "At 20 meters",
          "text": "From Route des Lucioles straight on Route des Lucioles"
        },
        {
          "type": "FOLLOW",
          "geoElementType": "ROAD",
          "length": 33,
          "duration": 4,
          "fromName": "Route des Lucioles",
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.06668,
            "lat": 43.6162
          },
          "roundAboutExitNumber": 0,
          "toName": "Route des Lucioles",
          "toOn": "Route des Lucioles",
          "toRn": "D504",
          "textDist": "At 33 meters",
          "text": "From Route des Lucioles straight on Route des Lucioles"
        },
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 336,
          "duration": 31,
          "fromName": "Route des Lucioles",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07047,
            "lat": 43.61731
          },
          "roundAboutExitNumber": 2,
          "toName": "Carrefour du Golf",
          "toOn": "Carrefour du Golf",
          "textDist": "At 336 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 49,
          "duration": 11,
          "fromName": "Carrefour du Golf",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07093,
            "lat": 43.61741
          },
          "roundAboutExitNumber": 2,
          "toName": "D504",
          "toOn": "Route des Colles",
          "toRn": "D504",
          "textDist": "At 49 meters",
          "text": "From Route des Lucioles at roundabout take 2nd exit on D504"
        },
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 223,
          "duration": 20,
          "fromName": "Route des Colles",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07357,
            "lat": 43.61703
          },
          "roundAboutExitNumber": 3,
          "toName": "Carrefour Saint-Philippe",
          "toOn": "Carrefour Saint-Philippe",
          "textDist": "At 223 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 104,
          "duration": 29,
          "fromName": "Carrefour Saint-Philippe",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07463,
            "lat": 43.61674
          },
          "roundAboutExitNumber": 3,
          "toName": "D504",
          "toOn": "Route des Colles",
          "toRn": "D504",
          "textDist": "At 104 meters",
          "text": "From Route des Colles at roundabout take 3rd exit on D504"
        },
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 513,
          "duration": 39,
          "fromName": "Route des Colles",
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.08045,
            "lat": 43.61509
          },
          "roundAboutExitNumber": 1,
          "toName": "Carrefour des Chappes",
          "toOn": "Carrefour des Chappes",
          "textDist": "At 513 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 8,
          "duration": 3,
          "fromName": "Carrefour des Chappes",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.08053,
            "lat": 43.61505
          },
          "roundAboutExitNumber": 1,
          "toName": "D535",
          "toOn": "Route des Chappes",
          "toRn": "D535",
          "textDist": "At 8 meters",
          "text": "From Route des Colles at roundabout take 1st exit on D535"
        },
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 361,
          "duration": 26,
          "fromName": "Route des Chappes",
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.07845,
            "lat": 43.61221
          },
          "roundAboutExitNumber": 4,
          "textDist": "At 361 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 122,
          "duration": 20,
          "manoeuvre": "BEAR_RIGHT",
          "coordinate": {
            "lon": 7.07869,
            "lat": 43.61212
          },
          "roundAboutExitNumber": 4,
          "toName": "D535",
          "toOn": "Route des Chappes",
          "toRn": "D535",
          "textDist": "At 122 meters",
          "text": "From Route des Chappes at roundabout take 4th exit on D535"
        },
        {
          "type": "FOLLOW",
          "geoElementType": "ROAD",
          "length": 107,
          "duration": 9,
          "fromName": "Route des Chappes",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07921,
            "lat": 43.61298
          },
          "roundAboutExitNumber": 0,
          "toName": "Allée Charles-Victor Naudin",
          "toOn": "Allée Charles-Victor Naudin",
          "textDist": "At 107 meters",
          "text": "From Route des Chappes make a right turn on Allée Charles-Victor Naudin"
        },
        {
          "type": "FOLLOW",
          "geoElementType": "ROAD",
          "length": 109,
          "duration": 15,
          "fromName": "Allée Charles-Victor Naudin",
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.08018,
            "lat": 43.61229
          },
          "roundAboutExitNumber": 0,
          "toName": "Allée Charles-Victor Naudin",
          "toOn": "Allée Charles-Victor Naudin",
          "textDist": "At 109 meters",
          "text": "From Allée Charles-Victor Naudin straight on Allée Charles-Victor Naudin"
        },
        {
          "type": "FOLLOW",
          "geoElementType": "ROAD",
          "length": 27,
          "duration": 4,
          "fromName": "Allée Charles-Victor Naudin",
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.08043,
            "lat": 43.61213
          },
          "roundAboutExitNumber": 0,
          "toName": "Allée Charles-Victor Naudin",
          "toOn": "Allée Charles-Victor Naudin",
          "textDist": "At 27 meters",
          "text": "From Allée Charles-Victor Naudin straight on Allée Charles-Victor Naudin"
        },
        {
          "type": "FOLLOW",
          "geoElementType": "ROAD",
          "length": 12,
          "duration": 3,
          "fromName": "Allée Charles-Victor Naudin",
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.08055,
            "lat": 43.61206
          },
          "roundAboutExitNumber": 0,
          "toName": "Allée Charles-Victor Naudin",
          "toOn": "Allée Charles-Victor Naudin",
          "textDist": "At 12 meters",
          "text": "From Allée Charles-Victor Naudin straight on Allée Charles-Victor Naudin"
        },
        {
          "type": "FOLLOW",
          "geoElementType": "ROAD",
          "length": 65,
          "duration": 9,
          "fromName": "Allée Charles-Victor Naudin",
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.08118,
            "lat": 43.61169
          },
          "roundAboutExitNumber": 0,
          "toName": "Allée Charles-Victor Naudin",
          "toOn": "Allée Charles-Victor Naudin",
          "textDist": "At 65 meters",
          "text": "From Allée Charles-Victor Naudin straight on Allée Charles-Victor Naudin"
        },
        {
          "type": "FOLLOW",
          "geoElementType": "ROAD",
          "length": 33,
          "duration": 4,
          "fromName": "Allée Charles-Victor Naudin",
          "manoeuvre": "LEFT",
          "coordinate": {
            "lon": 7.08151,
            "lat": 43.61153
          },
          "roundAboutExitNumber": 0,
          "textDist": "At 33 meters",
          "text": "From Allée Charles-Victor Naudin make a left turn"
        },
        {
          "type": "STOP",
          "geoElementType": "ROAD",
          "length": 29,
          "duration": 12,
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.08177,
            "lat": 43.6117
          },
          "roundAboutExitNumber": 0,
          "textDist": "At 29 meters",
          "text": "Destination reached"
        }
      ],
      "boundingBox": {
        "minLon": 7.06602,
        "minLat": 43.61153,
        "maxLon": 7.081771510364167,
        "maxLat": 43.6175
      },
      "startStopInfo": {
        "start": {
          "lon": 7.06602,
          "lat": 43.61618
        },
        "stop": {
          "lon": 7.08177,
          "lat": 43.6117
        },
        "distanceFirstMatched": 0,
        "distanceLastMatched": 0.28,
        "interDests": null
      },
      "polyline": [
        {
          "lon": 7.06602,
          "lat": 43.61618
        },
        {
          "lon": 7.06627,
          "lat": 43.61621
        },
```

> ✅ Enhances the `routeSheet` with advanced descriptive fields such as road class, road type, and enriched maneuver labels.




## 🧩 ROUTESHEET_VERBOSE_LOW – Low verbosity for the route sheet

✅ **Use case**

You want to retrieve a **simple and minimal route sheet** for clear and concise navigation instructions. This is suitable for:

- basic navigation apps,
- user interfaces with limited space,
- users who only need turn-by-turn instructions without technical details.


💡 **What it does**

When this option is enabled:

- The route sheet includes only essential information (e.g., maneuver type, road name, distance).
- It excludes verbose metadata like road classification (FRC), road type, and internal navigation codes.
- This is the default verbosity level if none is explicitly defined.


> ✅ If you specify ROUTESHEET in the options and don’t add a verbosity level, this one is applied automatically.


🔧 **How to enable**

Add the following options to your request:


```
"options": ["ROUTESHEET", "ROUTESHEET_VERBOSE_LOW"]
```

📦 **Example**


```
{
  "routingVehicleProfile": {
    "transportMode": "CAR",
    "routingVehicleFeature": {
      "height": 160,
      "width": 180,
      "length": 450,
      "weight": 1300
    }
  },
  "options": ["ROUTESHEET", "ROUTESHEET_VERBOSE_LOW", "POLYLINE"],
  "destinations": [
    {
      "coordinateSat": {
        "lon": 7.066,
        "lat": 43.616,
        "heading": 17.6,
        "speed": 23.1,
        "time": 1396241966000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0664,
        "lat": 43.6162,
        "heading": 95.0,
        "speed": 29.3,
        "time": 1396241972000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0786,
        "lat": 43.6153,
        "heading": 119.0,
        "speed": 61.9,
        "time": 1396242062000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0805,
        "lat": 43.6147,
        "heading": 200.9,
        "speed": 50.6,
        "time": 1396242077000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0785,
        "lat": 43.6117,
        "heading": 115.8,
        "speed": 38.1,
        "time": 1396242104000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0787,
        "lat": 43.6118,
        "heading": 15.6,
        "speed": 26.0,
        "time": 1396242107000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0793,
        "lat": 43.6128,
        "heading": 76.0,
        "speed": 26.6,
        "time": 1396242128000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0814,
        "lat": 43.6116,
        "heading": 269.9,
        "speed": 5.6,
        "time": 1396242172000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0811,
        "lat": 43.6117,
        "heading": 338.7,
        "speed": 7.5,
        "time": 1396242182000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0812,
        "lat": 43.6119,
        "heading": 47.3,
        "speed": 14.9,
        "time": 1396242188000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0815,
        "lat": 43.6119,
        "heading": 127.1,
        "speed": 8.5,
        "time": 1396242198000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0816,
        "lat": 43.6118,
        "heading": 0.0,
        "speed": 0.0,
        "time": 1396242288000,
        "sat": 11
      }
    }
  ]
}
```

***Response**


```
{
  "usedDestinations": [
    {
      "inputOrder": 0,
      "used": true,
      "usedOrder": 0,
      "matchedCoordinateGps": {
        "lon": 7.06602,
        "lat": 43.61618
      },
      "confidenceValue": 0.07689281992526473,
      "distanceFromRequest": 20.1,
      "polylineIndex": -1,
      "duration": -1,
      "length": -1
    },
    {
      "inputOrder": 1,
      "used": true,
      "usedOrder": 1,
      "matchedCoordinateGps": {
        "lon": 7.066398283397998,
        "lat": 43.616205
      },
      "confidenceValue": 0.09921131156872807,
      "distanceFromRequest": 0.56,
      "polylineIndex": -1,
      "duration": 4,
      "length": 31
    },
    {
      "inputOrder": 2,
      "used": true,
      "usedOrder": 2,
      "matchedCoordinateGps": {
        "lon": 7.078628713869563,
        "lat": 43.61534125
      },
      "confidenceValue": 0.5117017827481006,
      "distanceFromRequest": 5.14,
      "polylineIndex": -1,
      "duration": 121,
      "length": 1128
    },
    {
      "inputOrder": 3,
      "used": true,
      "usedOrder": 3,
      "matchedCoordinateGps": {
        "lon": 7.080403748959592,
        "lat": 43.6147275
      },
      "confidenceValue": 0.22820475819113992,
      "distanceFromRequest": 8.34,
      "polylineIndex": -1,
      "duration": 143,
      "length": 1324
    },
    {
      "inputOrder": 4,
      "used": true,
      "usedOrder": 4,
      "matchedCoordinateGps": {
        "lon": 7.07845,
        "lat": 43.61179
      },
      "confidenceValue": 0.1539186659438396,
      "distanceFromRequest": 10.8,
      "polylineIndex": -1,
      "duration": 179,
      "length": 1718
    },
    {
      "inputOrder": 5,
      "used": true,
      "usedOrder": 5,
      "matchedCoordinateGps": {
        "lon": 7.07866,
        "lat": 43.61185
      },
      "confidenceValue": 0.16108117941441358,
      "distanceFromRequest": 6.43,
      "polylineIndex": -1,
      "duration": 181,
      "length": 1737
    },
    {
      "inputOrder": 6,
      "used": true,
      "usedOrder": 6,
      "matchedCoordinateGps": {
        "lon": 7.079378967392794,
        "lat": 43.6128575
      },
      "confidenceValue": 0.27133317856160843,
      "distanceFromRequest": 9.03,
      "polylineIndex": -1,
      "duration": 199,
      "length": 1895
    },
    {
      "inputOrder": 7,
      "used": true,
      "usedOrder": 7,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1558036422356276,
      "distanceFromRequest": 20.37,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 8,
      "used": true,
      "usedOrder": 8,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.15467894682254785,
      "distanceFromRequest": 6.54,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 9,
      "used": true,
      "usedOrder": 9,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1844632357817026,
      "distanceFromRequest": 23.43,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 10,
      "used": true,
      "usedOrder": 10,
      "matchedCoordinateGps": {
        "lon": 7.081303332134546,
        "lat": 43.61164
      },
      "confidenceValue": 0.1586887555888732,
      "distanceFromRequest": 33,
      "polylineIndex": -1,
      "duration": 229,
      "length": 2102
    },
    {
      "inputOrder": 11,
      "used": true,
      "usedOrder": 11,
      "matchedCoordinateGps": {
        "lon": 7.081771510364167,
        "lat": 43.6116975
      },
      "confidenceValue": 0.18750892219842968,
      "distanceFromRequest": 17.92,
      "polylineIndex": -1,
      "duration": 243,
      "length": 2151
    }
  ],
  "routingRoutes": [
    {
      "length": 2151,
      "duration": 243,
      "trafficDelay": 0,
      "averageSpeed": 31.866667,
      "maximumSpeed": 0,
      "startUTurnThreshold": 3000,
      "routingInstructions": [
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 389,
          "duration": 37,
          "fromName": "Route des Lucioles",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07047,
            "lat": 43.61731
          },
          "roundAboutExitNumber": 2,
          "toName": "Carrefour du Golf",
          "toOn": "Carrefour du Golf",
          "textDist": "At 389 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 49,
          "duration": 11,
          "fromName": "Carrefour du Golf",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07093,
            "lat": 43.61741
          },
          "roundAboutExitNumber": 2,
          "toName": "D504",
          "toOn": "Route des Colles",
          "toRn": "D504",
          "textDist": "At 49 meters",
          "text": "From Route des Lucioles at roundabout take 2nd exit on D504"
        },
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 223,
          "duration": 20,
          "fromName": "Route des Colles",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07357,
            "lat": 43.61703
          },
          "roundAboutExitNumber": 3,
          "toName": "Carrefour Saint-Philippe",
          "toOn": "Carrefour Saint-Philippe",
          "textDist": "At 223 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 104,
          "duration": 29,
          "fromName": "Carrefour Saint-Philippe",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07463,
            "lat": 43.61674
          },
          "roundAboutExitNumber": 3,
          "toName": "D504",
          "toOn": "Route des Colles",
          "toRn": "D504",
          "textDist": "At 104 meters",
          "text": "From Route des Colles at roundabout take 3rd exit on D504"
        },
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 513,
          "duration": 39,
          "fromName": "Route des Colles",
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.08045,
            "lat": 43.61509
          },
          "roundAboutExitNumber": 1,
          "toName": "Carrefour des Chappes",
          "toOn": "Carrefour des Chappes",
          "textDist": "At 513 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 8,
          "duration": 3,
          "fromName": "Carrefour des Chappes",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.08053,
            "lat": 43.61505
          },
          "roundAboutExitNumber": 1,
          "toName": "D535",
          "toOn": "Route des Chappes",
          "toRn": "D535",
          "textDist": "At 8 meters",
          "text": "From Route des Colles at roundabout take 1st exit on D535"
        },
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 361,
          "duration": 26,
          "fromName": "Route des Chappes",
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.07845,
            "lat": 43.61221
          },
          "roundAboutExitNumber": 4,
          "textDist": "At 361 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 122,
          "duration": 20,
          "manoeuvre": "BEAR_RIGHT",
          "coordinate": {
            "lon": 7.07869,
            "lat": 43.61212
          },
          "roundAboutExitNumber": 4,
          "toName": "D535",
          "toOn": "Route des Chappes",
          "toRn": "D535",
          "textDist": "At 122 meters",
          "text": "From Route des Chappes at roundabout take 4th exit on D535"
        },
        {
          "type": "FOLLOW",
          "geoElementType": "ROAD",
          "length": 107,
          "duration": 9,
          "fromName": "Route des Chappes",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07921,
            "lat": 43.61298
          },
          "roundAboutExitNumber": 0,
          "toName": "Allée Charles-Victor Naudin",
          "toOn": "Allée Charles-Victor Naudin",
          "textDist": "At 107 meters",
          "text": "From Route des Chappes make a right turn on Allée Charles-Victor Naudin"
        },
        {
          "type": "FOLLOW",
          "geoElementType": "ROAD",
          "length": 246,
          "duration": 35,
          "fromName": "Allée Charles-Victor Naudin",
          "manoeuvre": "LEFT",
          "coordinate": {
            "lon": 7.08151,
            "lat": 43.61153
          },
          "roundAboutExitNumber": 0,
          "textDist": "At 246 meters",
          "text": "From Allée Charles-Victor Naudin make a left turn"
        },
        {
          "type": "STOP",
          "geoElementType": "ROAD",
          "length": 29,
          "duration": 12,
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.08177,
            "lat": 43.6117
          },
          "roundAboutExitNumber": 0,
          "textDist": "At 29 meters",
          "text": "Destination reached"
        }
      ],
      "boundingBox": {
        "minLon": 7.06602,
        "minLat": 43.61153,
        "maxLon": 7.081771510364167,
        "maxLat": 43.6175
      },
      "startStopInfo": {
        "start": {
          "lon": 7.06602,
          "lat": 43.61618
        },
        "stop": {
          "lon": 7.08177,
          "lat": 43.6117
        },
        "distanceFirstMatched": 0,
        "distanceLastMatched": 0.28,
        "interDests": null
      },
      "polyline": [
        {
          "lon": 7.06602,
          "lat": 43.61618
        },
        {
          "lon": 7.06627,
          "lat": 43.61621
        },
```

> ✅ Generates a clean, human-readable route sheet focused on navigation instructions only.




## 🧩 ROUTESHEET_VERBOSE_MEDIUM – Medium verbosity for the route sheet

✅ **Use case**

You want a **moderately detailed route sheet** that includes clear navigation instructions along with extra metadata such as road types and classifications—more informative than the low verbosity level, but less technical than high verbosity.

This is suitable for:

- advanced user interfaces,
- route validation and diagnostics,
- in-vehicle systems needing contextual navigation data.


💡 **What it does**

When this option is enabled:

- The route sheet includes:
  - **road type** (motorway, secondary road, etc.),
  - **functional road class (FRC)**,
  - **maneuver type**,
  - **distance and duration** per step.
- It strikes a balance between clarity and technical detail.


⚠️ This option **must be used together** with `ROUTESHEET`.

🔧 **How to enable**

Add both of the following options in your request:


```
"options": ["ROUTESHEET", "ROUTESHEET_VERBOSE_MEDIUM"]
```

📦 **Example**


```
{
  "routingVehicleProfile": {
    "transportMode": "CAR",
    "routingVehicleFeature": {
      "height": 160,
      "width": 180,
      "length": 450,
      "weight": 1300
    }
  },
  "options": ["ROUTESHEET", "ROUTESHEET_VERBOSE_MEDIUM", "POLYLINE"],
  "destinations": [
    {
      "coordinateSat": {
        "lon": 7.066,
        "lat": 43.616,
        "heading": 17.6,
        "speed": 23.1,
        "time": 1396241966000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0664,
        "lat": 43.6162,
        "heading": 95.0,
        "speed": 29.3,
        "time": 1396241972000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0786,
        "lat": 43.6153,
        "heading": 119.0,
        "speed": 61.9,
        "time": 1396242062000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0805,
        "lat": 43.6147,
        "heading": 200.9,
        "speed": 50.6,
        "time": 1396242077000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0785,
        "lat": 43.6117,
        "heading": 115.8,
        "speed": 38.1,
        "time": 1396242104000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0787,
        "lat": 43.6118,
        "heading": 15.6,
        "speed": 26.0,
        "time": 1396242107000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0793,
        "lat": 43.6128,
        "heading": 76.0,
        "speed": 26.6,
        "time": 1396242128000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0814,
        "lat": 43.6116,
        "heading": 269.9,
        "speed": 5.6,
        "time": 1396242172000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0811,
        "lat": 43.6117,
        "heading": 338.7,
        "speed": 7.5,
        "time": 1396242182000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0812,
        "lat": 43.6119,
        "heading": 47.3,
        "speed": 14.9,
        "time": 1396242188000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0815,
        "lat": 43.6119,
        "heading": 127.1,
        "speed": 8.5,
        "time": 1396242198000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0816,
        "lat": 43.6118,
        "heading": 0.0,
        "speed": 0.0,
        "time": 1396242288000,
        "sat": 11
      }
    }
  ]
}
```

**Reponse**


```
{
  "usedDestinations": [
    {
      "inputOrder": 0,
      "used": true,
      "usedOrder": 0,
      "matchedCoordinateGps": {
        "lon": 7.06602,
        "lat": 43.61618
      },
      "confidenceValue": 0.07689281992526473,
      "distanceFromRequest": 20.1,
      "polylineIndex": -1,
      "duration": -1,
      "length": -1
    },
    {
      "inputOrder": 1,
      "used": true,
      "usedOrder": 1,
      "matchedCoordinateGps": {
        "lon": 7.066398283397998,
        "lat": 43.616205
      },
      "confidenceValue": 0.09921131156872807,
      "distanceFromRequest": 0.56,
      "polylineIndex": -1,
      "duration": 4,
      "length": 31
    },
    {
      "inputOrder": 2,
      "used": true,
      "usedOrder": 2,
      "matchedCoordinateGps": {
        "lon": 7.078628713869563,
        "lat": 43.61534125
      },
      "confidenceValue": 0.5117017827481006,
      "distanceFromRequest": 5.14,
      "polylineIndex": -1,
      "duration": 121,
      "length": 1128
    },
    {
      "inputOrder": 3,
      "used": true,
      "usedOrder": 3,
      "matchedCoordinateGps": {
        "lon": 7.080403748959592,
        "lat": 43.6147275
      },
      "confidenceValue": 0.22820475819113992,
      "distanceFromRequest": 8.34,
      "polylineIndex": -1,
      "duration": 143,
      "length": 1324
    },
    {
      "inputOrder": 4,
      "used": true,
      "usedOrder": 4,
      "matchedCoordinateGps": {
        "lon": 7.07845,
        "lat": 43.61179
      },
      "confidenceValue": 0.1539186659438396,
      "distanceFromRequest": 10.8,
      "polylineIndex": -1,
      "duration": 179,
      "length": 1718
    },
    {
      "inputOrder": 5,
      "used": true,
      "usedOrder": 5,
      "matchedCoordinateGps": {
        "lon": 7.07866,
        "lat": 43.61185
      },
      "confidenceValue": 0.16108117941441358,
      "distanceFromRequest": 6.43,
      "polylineIndex": -1,
      "duration": 181,
      "length": 1737
    },
    {
      "inputOrder": 6,
      "used": true,
      "usedOrder": 6,
      "matchedCoordinateGps": {
        "lon": 7.079378967392794,
        "lat": 43.6128575
      },
      "confidenceValue": 0.27133317856160843,
      "distanceFromRequest": 9.03,
      "polylineIndex": -1,
      "duration": 199,
      "length": 1895
    },
    {
      "inputOrder": 7,
      "used": true,
      "usedOrder": 7,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1558036422356276,
      "distanceFromRequest": 20.37,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 8,
      "used": true,
      "usedOrder": 8,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.15467894682254785,
      "distanceFromRequest": 6.54,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 9,
      "used": true,
      "usedOrder": 9,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1844632357817026,
      "distanceFromRequest": 23.43,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 10,
      "used": true,
      "usedOrder": 10,
      "matchedCoordinateGps": {
        "lon": 7.081303332134546,
        "lat": 43.61164
      },
      "confidenceValue": 0.1586887555888732,
      "distanceFromRequest": 33,
      "polylineIndex": -1,
      "duration": 229,
      "length": 2102
    },
    {
      "inputOrder": 11,
      "used": true,
      "usedOrder": 11,
      "matchedCoordinateGps": {
        "lon": 7.081771510364167,
        "lat": 43.6116975
      },
      "confidenceValue": 0.18750892219842968,
      "distanceFromRequest": 17.92,
      "polylineIndex": -1,
      "duration": 243,
      "length": 2151
    }
  ],
  "routingRoutes": [
    {
      "length": 2151,
      "duration": 243,
      "trafficDelay": 0,
      "averageSpeed": 31.866667,
      "maximumSpeed": 0,
      "startUTurnThreshold": 3000,
      "routingInstructions": [
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 389,
          "duration": 37,
          "fromName": "Route des Lucioles",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07047,
            "lat": 43.61731
          },
          "roundAboutExitNumber": 2,
          "toName": "Carrefour du Golf",
          "toOn": "Carrefour du Golf",
          "textDist": "At 389 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 49,
          "duration": 11,
          "fromName": "Carrefour du Golf",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07093,
            "lat": 43.61741
          },
          "roundAboutExitNumber": 2,
          "toName": "D504",
          "toOn": "Route des Colles",
          "toRn": "D504",
          "textDist": "At 49 meters",
          "text": "From Route des Lucioles at roundabout take 2nd exit on D504"
        },
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 223,
          "duration": 20,
          "fromName": "Route des Colles",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07357,
            "lat": 43.61703
          },
          "roundAboutExitNumber": 3,
          "toName": "Carrefour Saint-Philippe",
          "toOn": "Carrefour Saint-Philippe",
          "textDist": "At 223 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 104,
          "duration": 29,
          "fromName": "Carrefour Saint-Philippe",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07463,
            "lat": 43.61674
          },
          "roundAboutExitNumber": 3,
          "toName": "D504",
          "toOn": "Route des Colles",
          "toRn": "D504",
          "textDist": "At 104 meters",
          "text": "From Route des Colles at roundabout take 3rd exit on D504"
        },
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 513,
          "duration": 39,
          "fromName": "Route des Colles",
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.08045,
            "lat": 43.61509
          },
          "roundAboutExitNumber": 1,
          "toName": "Carrefour des Chappes",
          "toOn": "Carrefour des Chappes",
          "textDist": "At 513 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 8,
          "duration": 3,
          "fromName": "Carrefour des Chappes",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.08053,
            "lat": 43.61505
          },
          "roundAboutExitNumber": 1,
          "toName": "D535",
          "toOn": "Route des Chappes",
          "toRn": "D535",
          "textDist": "At 8 meters",
          "text": "From Route des Colles at roundabout take 1st exit on D535"
        },
        {
          "type": "ENTER_ROUNDABOUT",
          "geoElementType": "ROAD",
          "length": 361,
          "duration": 26,
          "fromName": "Route des Chappes",
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.07845,
            "lat": 43.61221
          },
          "roundAboutExitNumber": 4,
          "textDist": "At 361 meters"
        },
        {
          "type": "EXIT_ROUNDABOUT",
          "geoElementType": "ROUNDABOUT",
          "length": 122,
          "duration": 20,
          "manoeuvre": "BEAR_RIGHT",
          "coordinate": {
            "lon": 7.07869,
            "lat": 43.61212
          },
          "roundAboutExitNumber": 4,
          "toName": "D535",
          "toOn": "Route des Chappes",
          "toRn": "D535",
          "textDist": "At 122 meters",
          "text": "From Route des Chappes at roundabout take 4th exit on D535"
        },
        {
          "type": "FOLLOW",
          "geoElementType": "ROAD",
          "length": 107,
          "duration": 9,
          "fromName": "Route des Chappes",
          "manoeuvre": "RIGHT",
          "coordinate": {
            "lon": 7.07921,
            "lat": 43.61298
          },
          "roundAboutExitNumber": 0,
          "toName": "Allée Charles-Victor Naudin",
          "toOn": "Allée Charles-Victor Naudin",
          "textDist": "At 107 meters",
          "text": "From Route des Chappes make a right turn on Allée Charles-Victor Naudin"
        },
        {
          "type": "FOLLOW",
          "geoElementType": "ROAD",
          "length": 246,
          "duration": 35,
          "fromName": "Allée Charles-Victor Naudin",
          "manoeuvre": "LEFT",
          "coordinate": {
            "lon": 7.08151,
            "lat": 43.61153
          },
          "roundAboutExitNumber": 0,
          "textDist": "At 246 meters",
          "text": "From Allée Charles-Victor Naudin make a left turn"
        },
        {
          "type": "STOP",
          "geoElementType": "ROAD",
          "length": 29,
          "duration": 12,
          "manoeuvre": "STRAIGHT",
          "coordinate": {
            "lon": 7.08177,
            "lat": 43.6117
          },
          "roundAboutExitNumber": 0,
          "textDist": "At 29 meters",
          "text": "Destination reached"
        }
      ],
      "boundingBox": {
        "minLon": 7.06602,
        "minLat": 43.61153,
        "maxLon": 7.081771510364167,
        "maxLat": 43.6175
      },
      "startStopInfo": {
        "start": {
          "lon": 7.06602,
          "lat": 43.61618
        },
        "stop": {
          "lon": 7.08177,
          "lat": 43.6117
        },
        "distanceFirstMatched": 0,
        "distanceLastMatched": 0.28,
        "interDests": null
      },
      "polyline": [
        {
          "lon": 7.06602,
          "lat": 43.61618
        },
        {
          "lon": 7.06627,
          "lat": 43.61621
        },
```

> ✅ Returns a route sheet with enriched context: maneuver types, functional road class, road types, and timing data.




## 🧩 SEGMENTIDS – Return segment IDs of the route

✅ **Use case**

You want to retrieve the **internal segment identifiers** used by the map engine to represent each portion of the route. This is helpful for:

- Debugging or analytics,
- Matching against your own map database,
- Post-processing or route indexing,
- Building segment-based routing logic or overlays.


💡 **What it does**

When enabled, the response will contain a list of **segment IDs** (`segmentIds` array) corresponding to each portion of the itinerary.

Each ID is a unique reference for a map segment used during route calculation.

> ⚠️ These IDs are **internal and opaque**; they are useful only in the context of advanced features or integration with compatible map data.


🔧 **How to enable**

Add the `SEGMENTIDS` option to the `options` array in your routing request:


```
"options": ["SEGMENTIDS"]
```

📦 **Example**


```
{
  "routingVehicleProfile": {
    "transportMode": "CAR",
    "routingVehicleFeature": {
      "height": 160,
      "width": 180,
      "length": 450,
      "weight": 1300
    }
  },
  "options": ["SEGMENTIDS"],
  "destinations": [
    {
      "coordinateSat": {
        "lon": 7.066,
        "lat": 43.616,
        "heading": 17.6,
        "speed": 23.1,
        "time": 1396241966000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0664,
        "lat": 43.6162,
        "heading": 95.0,
        "speed": 29.3,
        "time": 1396241972000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0786,
        "lat": 43.6153,
        "heading": 119.0,
        "speed": 61.9,
        "time": 1396242062000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0805,
        "lat": 43.6147,
        "heading": 200.9,
        "speed": 50.6,
        "time": 1396242077000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0785,
        "lat": 43.6117,
        "heading": 115.8,
        "speed": 38.1,
        "time": 1396242104000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0787,
        "lat": 43.6118,
        "heading": 15.6,
        "speed": 26.0,
        "time": 1396242107000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0793,
        "lat": 43.6128,
        "heading": 76.0,
        "speed": 26.6,
        "time": 1396242128000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0814,
        "lat": 43.6116,
        "heading": 269.9,
        "speed": 5.6,
        "time": 1396242172000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0811,
        "lat": 43.6117,
        "heading": 338.7,
        "speed": 7.5,
        "time": 1396242182000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0812,
        "lat": 43.6119,
        "heading": 47.3,
        "speed": 14.9,
        "time": 1396242188000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0815,
        "lat": 43.6119,
        "heading": 127.1,
        "speed": 8.5,
        "time": 1396242198000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0816,
        "lat": 43.6118,
        "heading": 0.0,
        "speed": 0.0,
        "time": 1396242288000,
        "sat": 11
      }
    }
  ]
}
```

**Response**


```
{
  "usedDestinations": [
    {
      "inputOrder": 0,
      "used": true,
      "usedOrder": 0,
      "matchedCoordinateGps": {
        "lon": 7.06602,
        "lat": 43.61618
      },
      "confidenceValue": 0.07689281992526473,
      "distanceFromRequest": 20.1,
      "polylineIndex": -1,
      "duration": -1,
      "length": -1
    },
    {
      "inputOrder": 1,
      "used": true,
      "usedOrder": 1,
      "matchedCoordinateGps": {
        "lon": 7.066398283397998,
        "lat": 43.616205
      },
      "confidenceValue": 0.09921131156872807,
      "distanceFromRequest": 0.56,
      "polylineIndex": -1,
      "duration": 4,
      "length": 31
    },
    {
      "inputOrder": 2,
      "used": true,
      "usedOrder": 2,
      "matchedCoordinateGps": {
        "lon": 7.078628713869563,
        "lat": 43.61534125
      },
      "confidenceValue": 0.5117017827481006,
      "distanceFromRequest": 5.14,
      "polylineIndex": -1,
      "duration": 121,
      "length": 1128
    },
    {
      "inputOrder": 3,
      "used": true,
      "usedOrder": 3,
      "matchedCoordinateGps": {
        "lon": 7.080403748959592,
        "lat": 43.6147275
      },
      "confidenceValue": 0.22820475819113992,
      "distanceFromRequest": 8.34,
      "polylineIndex": -1,
      "duration": 143,
      "length": 1324
    },
    {
      "inputOrder": 4,
      "used": true,
      "usedOrder": 4,
      "matchedCoordinateGps": {
        "lon": 7.07845,
        "lat": 43.61179
      },
      "confidenceValue": 0.1539186659438396,
      "distanceFromRequest": 10.8,
      "polylineIndex": -1,
      "duration": 179,
      "length": 1718
    },
    {
      "inputOrder": 5,
      "used": true,
      "usedOrder": 5,
      "matchedCoordinateGps": {
        "lon": 7.07866,
        "lat": 43.61185
      },
      "confidenceValue": 0.16108117941441358,
      "distanceFromRequest": 6.43,
      "polylineIndex": -1,
      "duration": 181,
      "length": 1737
    },
    {
      "inputOrder": 6,
      "used": true,
      "usedOrder": 6,
      "matchedCoordinateGps": {
        "lon": 7.079378967392794,
        "lat": 43.6128575
      },
      "confidenceValue": 0.27133317856160843,
      "distanceFromRequest": 9.03,
      "polylineIndex": -1,
      "duration": 199,
      "length": 1895
    },
    {
      "inputOrder": 7,
      "used": true,
      "usedOrder": 7,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1558036422356276,
      "distanceFromRequest": 20.37,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 8,
      "used": true,
      "usedOrder": 8,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.15467894682254785,
      "distanceFromRequest": 6.54,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 9,
      "used": true,
      "usedOrder": 9,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1844632357817026,
      "distanceFromRequest": 23.43,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 10,
      "used": true,
      "usedOrder": 10,
      "matchedCoordinateGps": {
        "lon": 7.081303332134546,
        "lat": 43.61164
      },
      "confidenceValue": 0.1586887555888732,
      "distanceFromRequest": 33,
      "polylineIndex": -1,
      "duration": 229,
      "length": 2102
    },
    {
      "inputOrder": 11,
      "used": true,
      "usedOrder": 11,
      "matchedCoordinateGps": {
        "lon": 7.081771510364167,
        "lat": 43.6116975
      },
      "confidenceValue": 0.18750892219842968,
      "distanceFromRequest": 17.92,
      "polylineIndex": -1,
      "duration": 243,
      "length": 2151
    }
  ],
  "routingRoutes": [
    {
      "length": 2151,
      "duration": 243,
      "trafficDelay": 0,
      "averageSpeed": 31.866667,
      "maximumSpeed": 0,
      "startUTurnThreshold": 3000,
      "startStopInfo": {
        "start": {
          "lon": 7.06602,
          "lat": 43.61618
        },
        "stop": {
          "lon": 7.08177,
          "lat": 43.6117
        },
        "distanceFirstMatched": 0,
        "distanceLastMatched": 0.28,
        "interDests": null
      },
      "segmentIds": [
        836108994,
        836108995,
        709801757,
        1381983248,
        1381983249,
        836932006,
        836932007,
        1382514048,
        1382514049,
        938906463,
        938906464,
        537879459,
        1259289174,
        1259289175,
        1223449855,
        1223449854,
        1340297066,
        1340297065,
        58347121,
        933189298,
        1170567037,
        1170567036,
        1383407095,
        1383407096,
        836109013,
        836825986,
        836825985,
        549672767,
        1223449178,
        1223449177,
        836109014,
        833135496,
        836109019,
        1214585752,
        1214585751,
        972276772,
        1223455248,
        1223455247,
        835410520,
        836108985,
        836108984,
        709801731,
        1026746968,
        1026746967,
        58436098,
        58436107,
        836108986,
        836108987,
        65389733,
        1339069509,
        1339069508,
        1338076945,
        1338076953,
        1338076952,
        1338076951
      ]
    }
  ]
}
```

> ✅ Returns a list of segment IDs used for each portion of the route, available in the `segmentIds` field of the response.




## 🧩 USED_DESTINATIONS_OFF – Disable used destinations list in response

✅ **Use case**

You want to **reduce the size** of the response or you don't need the `usedDestinations` field, which normally lists the destinations effectively matched to the route.

Useful when:

- You're only interested in the route geometry or travel times.
- You want to optimize bandwidth for mobile or embedded devices.
- You're sending a large number of coordinates and don’t want the server to echo them back.


💡 **What it does**

By default, the TraceRoute response includes a `usedDestinations` array that confirms which coordinates were used in route computation after internal simplification.

When the `USED_DESTINATIONS_OFF` option is added, this list is omitted from the response entirely.

🔧 **How to enable**

Add `USED_DESTINATIONS_OFF` to the `options` array of your request.


```
"options": ["USED_DESTINATIONS_OFF"]
```

📦 **Example**


```
{
  "routingVehicleProfile": {
    "transportMode": "CAR",
    "routingVehicleFeature": {
      "height": 160,
      "width": 180,
      "length": 450,
      "weight": 1300
    }
  },
  "options": ["USED_DESTINATIONS_OFF", "POLYLINE"],
  "destinations": [
    {
      "coordinateSat": {
        "lon": 7.066,
        "lat": 43.616,
        "heading": 17.6,
        "speed": 23.1,
        "time": 1396241966000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0664,
        "lat": 43.6162,
        "heading": 95.0,
        "speed": 29.3,
        "time": 1396241972000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0786,
        "lat": 43.6153,
        "heading": 119.0,
        "speed": 61.9,
        "time": 1396242062000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0805,
        "lat": 43.6147,
        "heading": 200.9,
        "speed": 50.6,
        "time": 1396242077000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0785,
        "lat": 43.6117,
        "heading": 115.8,
        "speed": 38.1,
        "time": 1396242104000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0787,
        "lat": 43.6118,
        "heading": 15.6,
        "speed": 26.0,
        "time": 1396242107000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0793,
        "lat": 43.6128,
        "heading": 76.0,
        "speed": 26.6,
        "time": 1396242128000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0814,
        "lat": 43.6116,
        "heading": 269.9,
        "speed": 5.6,
        "time": 1396242172000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0811,
        "lat": 43.6117,
        "heading": 338.7,
        "speed": 7.5,
        "time": 1396242182000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0812,
        "lat": 43.6119,
        "heading": 47.3,
        "speed": 14.9,
        "time": 1396242188000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0815,
        "lat": 43.6119,
        "heading": 127.1,
        "speed": 8.5,
        "time": 1396242198000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0816,
        "lat": 43.6118,
        "heading": 0.0,
        "speed": 0.0,
        "time": 1396242288000,
        "sat": 11
      }
    }
  ]
}
```

**Response**


```
{
  "routingRoutes": [
    {
      "length": 2151,
      "duration": 243,
      "trafficDelay": 0,
      "averageSpeed": 31.866667,
      "maximumSpeed": 0,
      "startUTurnThreshold": 3000,
      "boundingBox": {
        "minLon": 7.06602,
        "minLat": 43.61153,
        "maxLon": 7.081771510364167,
        "maxLat": 43.6175
      },
      "startStopInfo": {
        "start": {
          "lon": 7.06602,
          "lat": 43.61618
        },
        "stop": {
          "lon": 7.08177,
          "lat": 43.6117
        },
        "distanceFirstMatched": 0,
        "distanceLastMatched": 0.28,
        "interDests": null
      },
      "polyline": [
        {
          "lon": 7.06602,
          "lat": 43.61618
        },
        {
          "lon": 7.06627,
          "lat": 43.61621
        },
        {
          "lon": 7.06668,
          "lat": 43.6162
        },
```



## 🧩 WAYPOINTS – Return waypoints of the itinerary

✅ **Use case**

You want to **reconstruct the route later** or send it to another device/server for **precise reproduction** of the calculated path.

Useful when:

- You want to cache and reuse a route.
- You need to analyze key points of the route, including geometry and transitions.
- You plan to visualize or simulate the route elsewhere (e.g. navigation system, custom playback).


💡 **What it does**

When enabled, the API returns a `waypoints` array containing critical points used to form the computed route. Each waypoint includes metadata such as:

- Coordinates
- Distance from origin
- Duration
- Off-road info (if enabled via `OFFROADS`)
- Segment linkage


These are minimal yet sufficient to reproduce the full route on another system.

🔧 **How to enable**

Add `WAYPOINTS` to the `options` array in your routing request:


```
"options": ["WAYPOINTS"]
```

📦 **Example**


```
{
  "routingVehicleProfile": {
    "transportMode": "CAR",
    "routingVehicleFeature": {
      "height": 160,
      "width": 180,
      "length": 450,
      "weight": 1300
    }
  },
  "options": ["WAYPOINTS", "POLYLINE"],
  "destinations": [
    {
      "coordinateSat": {
        "lon": 7.066,
        "lat": 43.616,
        "heading": 17.6,
        "speed": 23.1,
        "time": 1396241966000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0664,
        "lat": 43.6162,
        "heading": 95.0,
        "speed": 29.3,
        "time": 1396241972000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0786,
        "lat": 43.6153,
        "heading": 119.0,
        "speed": 61.9,
        "time": 1396242062000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0805,
        "lat": 43.6147,
        "heading": 200.9,
        "speed": 50.6,
        "time": 1396242077000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0785,
        "lat": 43.6117,
        "heading": 115.8,
        "speed": 38.1,
        "time": 1396242104000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0787,
        "lat": 43.6118,
        "heading": 15.6,
        "speed": 26.0,
        "time": 1396242107000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0793,
        "lat": 43.6128,
        "heading": 76.0,
        "speed": 26.6,
        "time": 1396242128000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0814,
        "lat": 43.6116,
        "heading": 269.9,
        "speed": 5.6,
        "time": 1396242172000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0811,
        "lat": 43.6117,
        "heading": 338.7,
        "speed": 7.5,
        "time": 1396242182000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0812,
        "lat": 43.6119,
        "heading": 47.3,
        "speed": 14.9,
        "time": 1396242188000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0815,
        "lat": 43.6119,
        "heading": 127.1,
        "speed": 8.5,
        "time": 1396242198000,
        "sat": 11
      }
    },
    {
      "coordinateSat": {
        "lon": 7.0816,
        "lat": 43.6118,
        "heading": 0.0,
        "speed": 0.0,
        "time": 1396242288000,
        "sat": 11
      }
    }
  ]
}
```

**Response**


```
{
  "usedDestinations": [
    {
      "inputOrder": 0,
      "used": true,
      "usedOrder": 0,
      "matchedCoordinateGps": {
        "lon": 7.06602,
        "lat": 43.61618
      },
      "confidenceValue": 0.07689281992526473,
      "distanceFromRequest": 20.1,
      "polylineIndex": -1,
      "duration": -1,
      "length": -1
    },
    {
      "inputOrder": 1,
      "used": true,
      "usedOrder": 1,
      "matchedCoordinateGps": {
        "lon": 7.066398283397998,
        "lat": 43.616205
      },
      "confidenceValue": 0.09921131156872807,
      "distanceFromRequest": 0.56,
      "polylineIndex": -1,
      "duration": 4,
      "length": 31
    },
    {
      "inputOrder": 2,
      "used": true,
      "usedOrder": 2,
      "matchedCoordinateGps": {
        "lon": 7.078628713869563,
        "lat": 43.61534125
      },
      "confidenceValue": 0.5117017827481006,
      "distanceFromRequest": 5.14,
      "polylineIndex": -1,
      "duration": 121,
      "length": 1128
    },
    {
      "inputOrder": 3,
      "used": true,
      "usedOrder": 3,
      "matchedCoordinateGps": {
        "lon": 7.080403748959592,
        "lat": 43.6147275
      },
      "confidenceValue": 0.22820475819113992,
      "distanceFromRequest": 8.34,
      "polylineIndex": -1,
      "duration": 143,
      "length": 1324
    },
    {
      "inputOrder": 4,
      "used": true,
      "usedOrder": 4,
      "matchedCoordinateGps": {
        "lon": 7.07845,
        "lat": 43.61179
      },
      "confidenceValue": 0.1539186659438396,
      "distanceFromRequest": 10.8,
      "polylineIndex": -1,
      "duration": 179,
      "length": 1718
    },
    {
      "inputOrder": 5,
      "used": true,
      "usedOrder": 5,
      "matchedCoordinateGps": {
        "lon": 7.07866,
        "lat": 43.61185
      },
      "confidenceValue": 0.16108117941441358,
      "distanceFromRequest": 6.43,
      "polylineIndex": -1,
      "duration": 181,
      "length": 1737
    },
    {
      "inputOrder": 6,
      "used": true,
      "usedOrder": 6,
      "matchedCoordinateGps": {
        "lon": 7.079378967392794,
        "lat": 43.6128575
      },
      "confidenceValue": 0.27133317856160843,
      "distanceFromRequest": 9.03,
      "polylineIndex": -1,
      "duration": 199,
      "length": 1895
    },
    {
      "inputOrder": 7,
      "used": true,
      "usedOrder": 7,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1558036422356276,
      "distanceFromRequest": 20.37,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 8,
      "used": true,
      "usedOrder": 8,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.15467894682254785,
      "distanceFromRequest": 6.54,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 9,
      "used": true,
      "usedOrder": 9,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1844632357817026,
      "distanceFromRequest": 23.43,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 10,
      "used": true,
      "usedOrder": 10,
      "matchedCoordinateGps": {
        "lon": 7.081303332134546,
        "lat": 43.61164
      },
      "confidenceValue": 0.1586887555888732,
      "distanceFromRequest": 33,
      "polylineIndex": -1,
      "duration": 229,
      "length": 2102
    },
    {
      "inputOrder": 11,
      "used": true,
      "usedOrder": 11,
      "matchedCoordinateGps": {
        "lon": 7.081771510364167,
        "lat": 43.6116975
      },
      "confidenceValue": 0.18750892219842968,
      "distanceFromRequest": 17.92,
      "polylineIndex": -1,
      "duration": 243,
      "length": 2151
    }
  ],
  "routingRoutes": [
    {
      "length": 2151,
      "duration": 243,
      "trafficDelay": 0,
      "averageSpeed": 31.866667,
      "maximumSpeed": 0,
      "startUTurnThreshold": 3000,
      "boundingBox": {
        "minLon": 7.06602,
        "minLat": 43.61153,
        "maxLon": 7.081771510364167,
        "maxLat": 43.6175
      },
      "startStopInfo": {
        "start": {
          "lon": 7.06602,
          "lat": 43.61618
        },
        "stop": {
          "lon": 7.08177,
          "lat": 43.6117
        },
        "distanceFirstMatched": 0,
        "distanceLastMatched": 0.28,
        "interDests": null
      },
      "polyline": [
        {
          "lon": 7.06602,
          "lat": 43.61618
        },
        {
          "lon": 7.06627,
          "lat": 43.61621
        },
```

> ✅ Returns minimal but complete waypoint list to reconstruct the route on another device.


## 🧭 WAYPOINTS_POLYLINE – Include Waypoint Coordinates in the Polyline

Returns the polyline of the route, enhanced with the **waypoint coordinates**.

✅ **Use case**

You want a single polyline that contains **both the route geometry and the precise waypoints** used in the computation.
This is useful to:

- Visualize or export the route **including key GPS points**
- Perform replay or synchronization between systems
- Ensure all important locations (e.g., stops) are reflected in the geometry


💡 **What it does**

When this option is enabled, the API appends the **waypoints** directly in the encoded polyline response.
Waypoints include additional attributes such as time, heading, and speed, if provided.

This is especially relevant if you combine:

- `WAYPOINTS` → returns the full list of waypoint objects
- `WAYPOINTS_POLYLINE` → returns the geometry with those waypoints inside the polyline


🔧 How to enable

Add the following option to your request:


```
"options": ["WAYPOINTS_POLYLINE"]
```

**Example**


```
{
  "routingVehicleProfile": {
    "transportMode": "CAR"
  },
  "options": ["WAYPOINTS", "WAYPOINTS_POLYLINE"],
  "destinations" : [
        {
            "coordinateSat" : {
                "lon" : 7.066,
                "lat" : 43.616,
                "heading" : 17.6,
                "speed" : 23.1,
                "time" : 1396241966000,
                "sat" : 11
            }
        },
        {
            "coordinateSat" : {
                "lon" : 7.0664,
                "lat" : 43.6162,
                "heading" : 95.0,
                "speed" : 29.3,
                "time" : 1396241972000,
                "sat" : 11
            }
        },
                {
            "coordinateSat" : {
                "lon" : 7.0786,
                "lat" : 43.6153,
                "heading" : 119.0,
                "speed" : 61.9,
                "time" : 1396242062000,
                "sat" : 11
            }
        },
        {
            "coordinateSat" : {
                "lon" : 7.0805,
                "lat" : 43.6147,
                "heading" : 200.9,
                "speed" : 50.6,
                "time" : 1396242077000,
                "sat" : 11
            }
        },
        {
            "coordinateSat" : {
                "lon" : 7.0785,
                "lat" : 43.6117,
                "heading" : 115.8,
                "speed" : 38.1,
                "time" : 1396242104000,
                "sat" : 11
            }
        },
        {
            "coordinateSat" : {
                "lon" : 7.0787,
                "lat" : 43.6118,
                "heading" : 15.6,
                "speed" : 26.0,
                "time" : 1396242107000,
                "sat" : 11
            }
        },
        {
            "coordinateSat" : {
                "lon" : 7.0793,
                "lat" : 43.6128,
                "heading" : 76.0,
                "speed" : 26.6,
                "time" : 1396242128000,
                "sat" : 11
            }
        },
        {
            "coordinateSat" : {
                "lon" : 7.0814,
                "lat" : 43.6116,
                "heading" : 269.9,
                "speed" : 5.6,
                "time" : 1396242172000,
                "sat" : 11
            }
        },
        {
            "coordinateSat" : {
                "lon" : 7.0811,
                "lat" : 43.6117,
                "heading" : 338.7,
                "speed" : 7.5,
                "time" : 1396242182000,
                "sat" : 11
            }
        },
        {
            "coordinateSat" : {
                "lon" : 7.0812,
                "lat" : 43.6119,
                "heading" : 47.3,
                "speed" : 14.9,
                "time" : 1396241966000,
                "sat" : 11
            }
        },
        {
            "coordinateSat" : {
                "lon" : 7.0815,
                "lat" : 43.6119,
                "heading" : 127.1,
                "speed" : 8.5,
                "time" : 1396242198000,
                "sat" : 11
            }
        },
        {
            "coordinateSat" : {
                "lon" : 7.0816,
                "lat" : 43.6118,
                "heading" : 0.0,
                "speed" : 0.0,
                "time" : 1396242288000,
                "sat" : 11
            }
        }
    ]
}
```

**Response**


```
{
  "usedDestinations": [
    {
      "inputOrder": 0,
      "used": true,
      "usedOrder": 0,
      "matchedCoordinateGps": {
        "lon": 7.06602,
        "lat": 43.61618
      },
      "confidenceValue": 0.07689281992526473,
      "distanceFromRequest": 20.1,
      "polylineIndex": -1,
      "duration": -1,
      "length": -1
    },
    {
      "inputOrder": 1,
      "used": true,
      "usedOrder": 1,
      "matchedCoordinateGps": {
        "lon": 7.066398283397998,
        "lat": 43.616205
      },
      "confidenceValue": 0.09921131156872807,
      "distanceFromRequest": 0.56,
      "polylineIndex": -1,
      "duration": 4,
      "length": 31
    },
    {
      "inputOrder": 2,
      "used": true,
      "usedOrder": 2,
      "matchedCoordinateGps": {
        "lon": 7.078628713869563,
        "lat": 43.61534125
      },
      "confidenceValue": 0.5117017827481006,
      "distanceFromRequest": 5.14,
      "polylineIndex": -1,
      "duration": 121,
      "length": 1128
    },
    {
      "inputOrder": 3,
      "used": true,
      "usedOrder": 3,
      "matchedCoordinateGps": {
        "lon": 7.080403748959592,
        "lat": 43.6147275
      },
      "confidenceValue": 0.22820475819113992,
      "distanceFromRequest": 8.34,
      "polylineIndex": -1,
      "duration": 143,
      "length": 1324
    },
    {
      "inputOrder": 4,
      "used": true,
      "usedOrder": 4,
      "matchedCoordinateGps": {
        "lon": 7.07845,
        "lat": 43.61179
      },
      "confidenceValue": 0.1539186659438396,
      "distanceFromRequest": 10.8,
      "polylineIndex": -1,
      "duration": 179,
      "length": 1718
    },
    {
      "inputOrder": 5,
      "used": true,
      "usedOrder": 5,
      "matchedCoordinateGps": {
        "lon": 7.07866,
        "lat": 43.61185
      },
      "confidenceValue": 0.16108117941441358,
      "distanceFromRequest": 6.43,
      "polylineIndex": -1,
      "duration": 181,
      "length": 1737
    },
    {
      "inputOrder": 6,
      "used": true,
      "usedOrder": 6,
      "matchedCoordinateGps": {
        "lon": 7.079378967392794,
        "lat": 43.6128575
      },
      "confidenceValue": 0.27133317856160843,
      "distanceFromRequest": 9.03,
      "polylineIndex": -1,
      "duration": 199,
      "length": 1895
    },
    {
      "inputOrder": 7,
      "used": true,
      "usedOrder": 7,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1558036422356276,
      "distanceFromRequest": 20.37,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 8,
      "used": true,
      "usedOrder": 8,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.15467894682254785,
      "distanceFromRequest": 6.54,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 9,
      "used": true,
      "usedOrder": 9,
      "matchedCoordinateGps": {
        "lon": 7.08118,
        "lat": 43.61169
      },
      "confidenceValue": 0.1844632357817026,
      "distanceFromRequest": 23.43,
      "polylineIndex": -1,
      "duration": 226,
      "length": 2090
    },
    {
      "inputOrder": 10,
      "used": true,
      "usedOrder": 10,
      "matchedCoordinateGps": {
        "lon": 7.081303332134546,
        "lat": 43.61164
      },
      "confidenceValue": 0.1586887555888732,
      "distanceFromRequest": 33,
      "polylineIndex": -1,
      "duration": 229,
      "length": 2102
    },
    {
      "inputOrder": 11,
      "used": true,
      "usedOrder": 11,
      "matchedCoordinateGps": {
        "lon": 7.081771510364167,
        "lat": 43.6116975
      },
      "confidenceValue": 0.18750892219842968,
      "distanceFromRequest": 17.92,
      "polylineIndex": -1,
      "duration": 243,
      "length": 2151
    }
  ],
  "routingRoutes": [
    {
      "length": 2151,
      "duration": 243,
      "trafficDelay": 0,
      "averageSpeed": 31.866667,
      "maximumSpeed": 0,
      "startUTurnThreshold": 3000,
      "boundingBox": {
        "minLon": 7.06602,
        "minLat": 43.61153,
        "maxLon": 7.081771510364167,
        "maxLat": 43.6175
      },
      "startStopInfo": {
        "start": {
          "lon": 7.06602,
          "lat": 43.61618
        },
        "stop": {
          "lon": 7.08177,
          "lat": 43.6117
        },
        "distanceFirstMatched": 0,
        "distanceLastMatched": 0.28,
        "interDests": null
      },
      "polyline": [
        {
          "lon": 7.06602,
          "lat": 43.61618
        },
        {
          "lon": 7.06627,
          "lat": 43.61621
        },
```