LogoLogo
SentianceInsights-Control-TowerLegacy DocsImportant Security Notice
  • Introduction
  • Integrating the SDK
    • Getting Started
    • Android Quick Start
      • 1. Including the SDK
      • 2. Initialization
      • 3. User Creation
      • 4. Enabling Detections
      • 5. SDK Status Updates
      • 6. Permissions
      • 7. Additional Requirements
    • iOS Quick Start
      • 1. Including the SDK
        • Using CocoaPods
        • Using Carthage
        • Using Swift Package Manager
        • Manual Integration
      • 2. Project Settings
      • 3. Initialization
      • 4. User Creation
      • 5. Enabling Detections
      • 6. SDK Status Updates
      • 7. Permissions
      • 8. Additional Requirements
    • React Native Quick Start
      • 1. Including the SDK
      • 2. Configuration
      • 3. Initialization
      • 4. User Creation
      • 5. Enabling Detections
      • 6. SDK Status Updates
    • Flutter Quick Start
      • 1. Including the SDK
      • 2. Configuration
      • 3. Initialization
      • 4. User Creation
      • 5. Enabling Detections
      • 6. SDK Status Updates
    • What Comes After Integration
    • Integration (FAQ)
    • Detections (FAQ)
  • Sentiance Insights
    • Overview of Sentiance Insights
      • Driving Insights
        • Transports
        • Driving Events and Scores
        • Car Crashes
      • Mobility and Lifestyle Insights
        • Visit Essentials
        • User Segmentation
    • Engagement
      • User Adaptive Score
      • Streaks
      • Challenges
      • Reward System
      • Communication Campaign
      • Social Groups
        • Technical Details
    • Accessing Sentiance Insights
      • via On Device API
      • via Cloud API
      • via Firehose - Realtime Messages
      • via Offloads
  • FAQ
    • Security, Privacy and Terms of Service (FAQ)
  • Important topics
    • SDK
      • Appendix
        • Android
          • Android 10 Update Behavior
          • Android Battery Optimization
          • Artifacts & Dependencies
          • Manifest Permissions
          • Notification Management
          • Sample Notification
          • Supported API Levels
        • iOS
          • App Store Privacy Section
          • App Store Release
          • Apple Privacy Manifest
          • ARM Simulator Support
          • Dependencies
          • iOS 13 permission changes
          • Supported iOS Versions & Architectures
          • Swift Support
          • v5.x Framework Files
          • v6.x Framework Files
        • Controlled Detections
          • Automatic Detections
          • Automatic Detections with Forced Trips
          • Controlled Trips Only
          • Checking Trip Status
        • Control Sending Data
        • Custom User Metadata
        • Detecting Vehicle Crashes
        • Feature Production Readiness
        • Migration Guide
          • Android
          • iOS
          • React Native
          • Flutter
        • On-Device Features
        • React Native
        • SDK Initialization
        • User Access Token
        • User Creation
        • User Linking
        • Xamarin
      • API Reference
        • Android
          • AsyncInitializationError
          • AsyncInitializationResult
          • DateTime
          • DetectionStatus
          • DisableDetectionsError
          • DisableDetectionsResult
          • Driving Insights
            • CallWhileMovingEvent
            • DrivingInsight
            • DrivingInsightsApi
            • DrivingInsightsReadyListener
            • HarshDrivingEvent
              • Type
            • PhoneUsageEvent
            • SafetyScores
            • SafetyScoreRequestParameters
              • Builder
              • OccupantRoles
              • Period
              • TransportModes
            • SpeedingEvent
          • Smart Geofences
            • DetectionMode
            • SmartGeofence
            • SmartGeofenceApi
            • SmartGeofenceEvent
              • Type
            • SmartGeofenceEventListener
            • SmartGeofencesRefreshError
              • SmartGeofencesRefreshFailureReason
            • SmartGeofencesRefreshResult
          • EnableDetectionsError
            • EnableDetectionsFailureReason
          • EnableDetectionsResult
          • EventTimeline
            • EventType
            • TransportMode
            • Event
              • OffTheGridEvent
              • StationaryEvent
              • TransportEvent
              • UnknownEvent
            • EventTimelineUpdateListener
            • EventTimelineApi
            • OccupantRole
            • Venue
              • VenueType
              • VenueSignificance
          • Feedback
            • FeedbackApi
            • OccupantRoleFeedback
            • OccupantRoleFeedbackResult
          • GeoLocation
          • InitializationResult
            • InitializationFailureReason
          • InitState
          • MetaUserLinker
          • MetaUserLinkerAsync
          • MetaUserLinkerCallback
          • OnInitCallback
            • InitIssue
          • OnSdkStatusUpdateHandler
          • OnStartFinishedHandler
          • PendingOperation
            • OnSuccessListener
            • OnFailureListener
            • OnFailureListener
            • OnCompleteListener
          • ResetCallback
            • ResetCallback.ResetFailureReason
          • ResetError
            • ResetFailureReason
          • ResetResult
          • SdkConfig
            • LocationPermission
            • Builder
          • SdkException
          • SdkStatus
            • LocationSetting
            • Quota Status
            • StartStatus
          • SdkStatusUpdateListener
          • Sentiance
          • SentianceOptions
            • SentianceOptions.Builder
          • StartTripError
            • StartTripFailureReason
          • StartTripResult
          • StationaryInfo
          • StopTripError
            • StopTripFailureReason
          • StopTripResult
          • SubmitDetectionsCallback
          • SubmitDetectionsError
            • SubmitDetectionsFailureReason
          • SubmitDetectionsResult
          • Token
          • TokenResultCallback
          • TransmittableDataType
          • Transport Sessions
            • SensorDataChunk
            • TransportSession
            • TransportSessionApi
            • TransportSessionListener
          • Trip
            • StartTripCallback
            • StopTripCallback
            • TransportMode
            • TripTimeoutListener
            • TripType
          • TripInfo
          • UserAccessTokenError
            • UserAccessTokenFailureReason
          • UserActivity
          • UserActivityListener
          • UserActivityType
          • UserContext
            • Attribute
            • Segment
              • SegmentCategory
              • SegmentSubcategory
              • SegmentType
            • SemanticTime
          • UserContextApi
            • RequestUserContextFailureReason
            • RequestUserContextError
            • UserContextUpdateCriteria
            • UserContextUpdateListener
          • UserCreationError
            • UserCreationFailureReason
          • UserCreationOptions
            • UserCreationOptions.Builder
          • UserCreationResult
            • UserInfo
          • UserLinker
          • UserLinkerAsync
          • UserLinkerCallback
          • UserLinkingError
            • UserLinkingFailureReason
          • UserLinkingResult
          • VehicleCrashDetection
            • CrashDetectionApi
            • CrashDetectionState
            • VehicleCrashDiagnostic
            • VehicleCrashEvent
            • VehicleCrashDiagnosticListener
            • VehicleCrashListener
            • VehicleCrashSeverity
          • Waypoint
        • iOS
          • Detections
            • Enable Detections
            • Disable Detections
          • Driving Insights
            • SENTCallWhileMovingEvent
            • SENTDrivingInsights
            • SENTDrivingInsightsReadyDelegate
            • SENTHarshDrivingEvent
              • HarshDrivingEventType
            • SENTPhoneUsageEvent
            • SENTSpeedingEvent
            • SENTSafetyScores
            • SafetyScoreRequestParameters
              • SafetyScoreRequestOccupantRoleOption
              • SafetyScoreRequestPeriod
              • SafetyScoreRequestTransportModeOption
          • Event Timeline
            • EventTimelineDelegate
            • SENTOccupantRole
            • SENTTimelineEvent
              • SENTOffTheGridEvent
              • SENTStationaryEvent
              • SENTTransportEvent
              • SENTUnknownEvent
            • SENTTimelineEventType
            • SENTTimelineTransportMode
            • SENTVenue
            • SENTVenueSignificance
            • SENTVenueType
          • Feedback
            • SENTFeedback
            • SENTOccupantRoleFeedback
            • SENTOccupantRoleFeedbackResult
          • SENTCompletionHandlers
          • SENTConfig
          • SENTDate
          • SENTGeolocation
          • SENTAsyncInitializationCompletionHandler
          • SENTAsyncInitializationError
          • SENTAsyncInitializationResult
          • Sentiance
          • SENTInitializationResult
          • SENTOptions
            • SENTOptionsInitPurpose
          • SENTPublicDefinitions
          • SENTSDKStatus
          • SENTToken
          • SENTTransmittableDataType
          • SENTUserActivity
          • SENTVehicleCrashDetectionState
          • SENTVehicleCrashDiagnostic
          • SENTVehicleCrashEvent
            • SENTVehicleCrashSeverity
          • SENTWaypoint
          • Smart Geofences
            • SENTSmartGeofencesRefreshHandler
            • SmartGeofenceDetectionMode
            • SmartGeofencesRefreshError
              • SmartGeofencesRefreshFailureReason
            • SmartGeofencesRefreshResult
            • SmartGeofence
            • SmartGeofenceEvent
              • SmartGeofenceEventType
            • SmartGeofenceEventDelegate
          • Transport Sessions
            • SENTAccelerometerDataIterator
            • SENTLocationDataIterator
            • SENTSensorDataChunk
            • SENTTransportSession
          • User Context
            • SENTAttribute
            • SENTRequestUserContextCompletionHandler
            • SENTRequestUserContextError
            • SENTRequestUserContextFailureReason
            • SENTSegment
              • SENTSegmentCategory
              • SENTSegmentSubCategory
              • SENTSegmentType
            • SENTSemanticTime
            • SENTUserContext
            • SENTUserContextDelegate
            • SENTUserContextUpdateCriteria
          • User Creation & Linking
            • SENTUserInfo
            • User Creation
              • SENTUserCreationResult
              • SENTUserCreationFailureReason
              • SENTUserCreationError
              • SENTUserCreationCompletionHandler
              • SENTUserCreationOptions
            • User Linking
              • SENTNoOpUserLinker
              • SENTUserLinkingResult
              • SENTUserLinkingFailureReason
              • SENTUserLinkingError
              • SENTUserLinkingCompletionHandler
              • SENTUserLinker
        • React Native
          • core
            • Definitions
            • Examples
          • crash-detection
            • Definitions
            • Examples
          • driving-insights
            • Definitions
            • Examples
          • smart-geofences
            • Definitions
            • Examples
          • event-timeline
            • Definitions
            • Examples
          • legacy
            • Definitions
            • Examples
          • user-context
            • Definitions
            • Examples
        • Flutter
      • Battery Optimization on Android
      • How To
        • Check the Location Permissions
        • Utilize the Event Timeline API
        • Utilize the Driving Insights API
        • Utilize the User Context API
        • Utilize the Smart Geofences API
      • Troubleshooting
        • Android
        • iOS
      • Changelog
        • Android
        • iOS
        • React Native
        • Flutter
    • Authentication and Authorization
    • User Creation (via Authentication Code)
    • User Deletion
    • PlayStore Location Access Review
    • Privacy Report & Dashboard
    • Crash Detection
    • Important Security Notice
    • Injecting Fake Data
    • Custom Aggregation For Analytics
    • Merging Scores for Motorcycles and Cars
  • Links
    • SDK Standard License
    • Insights-by-Sentiance Application
    • Insights-by-Sentiance Privacy Policy
    • Journeys License
    • Technical & Organizational Measures
Powered by GitBook
On this page
  • What are Offloads
  • Accessing Offloads
  • Types of Offloads
  • Driver Passenger
  • Driving Events (all)
  • Driving Events (significant)
  • Primary Safety Scores (transports)
  • Secondary Safety Scores (transports)
  • Primary Safety Scores (users)
  • Secondary Safety Scores (users)
  • Trajectories
  • Transports
  • Custom Scores
  • Badges
  • Challenges
  • Streaks
  • Groups
  • Group Members
  • Communications
  • Feedback
  • App Events
  • Off-the-grids
  • Daily Rewards
  1. Sentiance Insights
  2. Accessing Sentiance Insights

via Offloads

Sentiance provides data offloads with driving insights to the clients on a daily basis.

Previousvia Firehose - Realtime MessagesNextSecurity, Privacy and Terms of Service (FAQ)

Last updated 6 months ago

What are Offloads

The Sentiance platform offers various methods to access and analyze your end-users' data, one of which is through offloads—our implementation of a file-based system, typically in CSV format. Offloads generally contain data for all your users over a specific timeframe, by default a 24-hour tumbling window. Detailed field descriptions can be found below.

While offloads contain much of the core data, they do not include certain elements such as predictions, coaching data, or some fine-grained details.

Please consult with your Sentiance contact person to discuss the offloads before implementing.

Accessing Offloads

Access to offloads is managed by the , with permissions authorized by the .

To check available offloads, use an API Key with the OFFLOADS_READ scope. The query example is:

query {
  offloads(from: "2023-06-04", to: "2023-06-04") {
    day
    type
    files {
      format
      link {
        expires_at
        url
      }
      name
      size
    }
  }
}

from and to are always days in the format YYYY-MM-DD. The response looks like the following.

{
  "data": {
    "offloads": [
      {
        "day": "2023-06-04",
        "files": [
          { "format": "csv.gz", "link": null, "name": "transports", "size": 20434 }
        ],
        "type": "OFFLOAD_TYPE_TRANSPORTS"
      },
      {
        "day": "2023-06-04",
        "files": [
          { "format": "csv.gz", "link": null, "name": "driving_events_all", "size": 277423 }
        ],
        "type": "OFFLOAD_TYPE_DRIVING_EVENTS_ALL"
      },
      {
        "day": "2023-06-04",
        "files": [
          { "format": "csv.gz", "link": null, "name": "driving_events_significant", "size": 61428 }
        ],
        "type": "OFFLOAD_TYPE_DRIVING_EVENTS_SIGNIFICANT"
      },
      {
        "day": "2023-06-04",
        "files": [
          { "format": "csv.gz", "link": null, "name": "trajectories", "size": 850284 }
        ],
        "type": "OFFLOAD_TYPE_TRAJECTORIES"
      }
    ]
  }
}

Offloads of several types are available (based on which Sentiance product offering you are using). Each day will contain one offload of each type and each offload item may have one or more associated files to download.

The files list their format, name, size and a link to download that file.

In the response above the link field is null since no links have been generated for these files yet. Link generation is done with an API Key with the scope OFFLOADS_GENERATE_URL.

mutation {
  generate_offload_url(day: "2023-06-04", offload_type: OFFLOAD_TYPE_TRANSPORTS) {
    offload {
      day
      type
      files {
        format
        link {
          expires_at
          url
        }
        name
        size
      }
    }
  }
}
{
  "data": {
    "generate_offload_url": {
      "offload": {
        "day": "2023-06-04",
        "files": [
          {
            "format": "csv.gz",
            "link": {
              "expires_at": "2023-06-27T11:32:29Z",
              "url": "https://sentiance-g2-driving-offloads.s3.eu-west-1.amazonaws.com/00000000000000000000000a/2023-06-04_0/transports.csv.gz?..."
            },
            "name": "transports",
            "size": 20434
          }
        ],
        "type": "OFFLOAD_TYPE_TRANSPORTS"
      }
    }
  }
}

Links expire after a set time and must be regenerated if needed. Offloads for the previous day are fully available, while current-day offloads may be incomplete.

Types of Offloads

The following offloads are available based on your product selection on the Sentiance platform.

Driver Passenger

The driver passenger offload contains a list of transports, together with a corresponding prediction of driver or passenger (of the mobile user).

Driving Events (all)

This offload file contains a list of transports, together with their corresponding lists of all driving events. The following driving events are available:

  • accelerating events

  • phone handling events

  • turning events

  • mounted events

  • braking events

  • speeding events

  • call events

  • screen events

All driving events for transports are included in this offload.

Driving Events (significant)

This offload file contains a list of transports, together with their corresponding lists of significant driving events. The following driving events are available:

  • accelerating events

  • phone handling events

  • turning events

  • mounted events

  • braking events

  • speeding events

  • call events

  • screen events

Significant events are a subset of all events, and only driving events that fall under certain thresholds are included (e.g. accelerations that have a high magnitude or calls that have a long duration).

Primary Safety Scores (transports)

These offloads contain a list of transports and their corresponding primary safety scores.

The primary safety scores available are:

  • legal

  • smooth

  • attention

  • overall

Secondary Safety Scores (transports)

These offloads contain a list of transports and their corresponding secondary safety scores.

The secondary safety scores available are:

  • focus

  • harsh acceleration

  • harsh braking

  • harsh turning

  • anticipation

  • mounted

Primary Safety Scores (users)

These offloads contain a list of users and their corresponding primary safety scores, based on their overall driving.

The primary safety scores available are:

  • legal

  • smooth

  • attention

  • overall

Secondary Safety Scores (users)

These offloads contain a list of users and their corresponding secondary safety scores, based on their overall driving.

The secondary safety scores available are:

  • focus

  • harsh acceleration

  • harsh braking

  • harsh turning

  • anticipation

  • mounted

Trajectories

Trajectories are information specific about the route that a transports followed. These offloads contain information such as the total distance traveled, the mapped waypoints of the transport, and the start and end addresses.

Transports

Transports represent the period of time a user moved from one venue to another. The transports offloads contain a list of transports and their corresponding predicted transport mode (e.g. car, train, bus, etc.), duration and top speed.

Custom Scores

These offloads contain the trip by trip scores and their corresponding user scores based on your integration with the Engagement platform. Can be similar to Driving Insights scores or different if you have a custom integration.

Badges

These offloads contain events related to your user’s progress towards achieving Badges. A badge state can change to be ACTIVE, IN_PROGRESS or COMPLETED.

Challenges

These offloads contain events related to your user’s progress towards completing a challenge. A challenge state can change to: ACCEPTED, COMPLETED, IN_PROGRESS, FAILED, ABANDONED.

Streaks

These offloads contain events related to your user’s progress towards continuing and maintaining streaks. A streak state can change to: NEW, CONTINUE, BREAK.

Groups

These offloads contain information about all social groups your users create.

Group Members

These offloads contain information about users who are part of groups and their role in the groups. A user can have one of these roles: ADMIN, MEMBER, PENDING.

Communications

These offloads contain information about each communication message that was generated for your users and whether or not a user interacted with it. A communication message can have one of these states: NEW, MANUALLY_CLOSED, AUTOMATICALLY_CLOSED.

Feedback

These offloads contain information about feedback provided by your users about our transport mode and occupant role predictions.

App Events

These offloads contain events generated by your user by using the mobile app.

Off-the-grids

Daily Rewards

Contains daily rewarded points for you users for the last 7 days.

To generate a link to the offload files, you must use the mutation, giving the day of the offload and the type as input. This will respond with.

Off-the-grids correspond to segments of time when the user was offline and not sending data from their mobile device to our platform. For an explanation of the possible of the grid reasons see .

Sentiance Cloud API
API Key Scopes (OFFLOADS_READ and OFFLOADS_GENERATE_URL)
generate_offload_url
here
182B
driver_passenger.csv
5KB
driving_events_all.csv
5KB
driving_events_significant.csv
259B
primary_safety_scores_transports.csv
403B
secondary_safety_scores_transports.csv
180B
primary_safety_scores_users.csv
324B
secondary_safety_scores_users.csv
849B
trajectories.csv
620B
transports.csv
3KB
custom_scores.csv
3KB
badges.csv
2KB
challenges.csv
9KB
streaks.csv
864B
groups.csv
1KB
group_members.csv
3KB
communications.csv
3KB
feedback.csv
2KB
app_events.csv
223B
daily_rewards.csv