Skip to main content

​
Overview

Some of Terminal’s endpoints return an extensions property that enables you to retreive enriched data provided by third-party vendors. This enriched data would allow you to have more contextual information about your data.

​
Supported Extensions

VendorDescriptionEndpoints
HERE Technologies Logo HERE Technologies HERE Technologies specializes in mapping technologies and location based services. It can be used to obtain rich location content such as route matching, speed limits, weather and traffic patterns. /safety/events

​
Considerations

It’s important to note that you will only be able to see the data provided by extensions if you have enabled that specific extension for your application. Please let us know if you are interested in enabling a supported extension for your application.

​
Usage

When making a GET call to a supported endpoint, you will be able to retreive the common model as well as an additional extensions property that includes data obtained from all supported extensions that you have enabled.

​
Example Response

Here’s an example of a request to /safety/events 
{
  "id": "id_pfx_01HQVHPWZ0NAV064NK9CZSCJ3V",
  "type": "distracted",
  "sourceId": "2038980691",
  "provider": "surfsight",
  "stats": {
    "averageSpeed": 88.42
  },
  "driver": "drv_01HQVFS4J4Z5SB7DTSN90J4SHG",
  "vehicle": "vcl_01HQVFS7S4GXAA229039KDZ56S",
  "startLocation": {
    "latitude": 37.81606797,
    "longitude": -122.25164267
  },
  "extensions": {
    "here": {
      "speedLimit": 105,
      "speedLimitSource": "posted",
      "truckSpeedLimit": 88,
      "roadName": "Interstate 880",
      "linkAttributes": {
        "countryCode": "USA",
        "functionalClass": "1",
        "isUrban": "true",
        "controlledAccess": "true",
        "limitedAccessRoad": "true",
        "isPaved": "true",
        "isPrivate": "false",
        "speedCategory": "4",
        "laneCategory": "3",
        "intersectionCategory": "0",
        "hasPublicAccess": "true",
        "vehicleTypes": "automobile,truck",
        "routeTypes": "highway"
      },
      "weather": {
        "latitude": 37.81606797,
        "longitude": -122.25164267,
        "temperature": 18.5,
        "humidity": 65.2,
        "pressure": 1013.25,
        "windSpeed": 3.2,
        "windDirection": 240,
        "visibility": 10.0,
        "precipitationType": "none",
        "intensityOfPrecipitation": 0,
        "dewPoint": 12.1,
        "locationId": "here_location_12345"
      }
    }
  },
  "startedAt": "2024-02-29T23:09:48.000Z"
}
⌘I