# References (iOS)

## DKDriverTimeline

`DKDriverTimeline` is an object that contains timeline data for the given period.

```java
public struct DKDriverTimeline: Codable {
    public let period: DKPeriod
    public let allContext: [DKAllContextItem]
    public let roadContexts: [DKRoadContext: [DKRoadContextItem]]
}
```

<table><thead><tr><th>Attribute</th><th width="255.33333333333331">Type</th><th>Description</th></tr></thead><tbody><tr><td>period</td><td><a href="#dkperiod">DKPeriod</a></td><td>The kind of aggregation period for this timeline</td></tr><tr><td>allContext</td><td>[<a href="#dkallcontextitem">DKAllContextItem</a>]</td><td>The list of all global context sorted by date</td></tr><tr><td>roadContexts</td><td>[<a href="#dkroadcontext">DKRoadContext</a>: [<a href="#dkroadcontextitem">DKRoadContextItem</a>]]</td><td>The dictionary of all road context and their associated list of context data sorted by date</td></tr></tbody></table>

## DKPeriod

`DKPeriod` indicates the aggregation size of each timeline object. It is an enum with the following values:

<table><thead><tr><th width="247">Value</th><th>Description</th></tr></thead><tbody><tr><td>week</td><td>Timeline data is aggregated week by week</td></tr><tr><td>month</td><td>Timeline data is aggregated month by month</td></tr><tr><td>year</td><td>Timeline data is aggregated year by year</td></tr></tbody></table>

```swift
public enum DKPeriod: Int, Codable {
    case week
    case month
    case year
}
```

## DKAllContextItem

`DKAllContextItem` is an object that contains data for global context for the given period.

```swift
public struct DKAllContextItem: Codable {
    public let date: Date
    public let numberTripTotal: Int
    public let numberTripScored: Int
    public let distance: Double
    public let duration: Int

    public var safety: DKSafety?
    public var ecoDriving: DKEcoDriving?
    public var phoneDistraction: DKDistraction?
    public var speeding: DKSpeeding?
    public var drivingConditions: DKDrivingConditions?
}
```

<table><thead><tr><th width="223.33333333333331">Attribute</th><th width="212">Type</th><th>Description</th></tr></thead><tbody><tr><td>date</td><td>Date</td><td>Start date of the given period</td></tr><tr><td>numberTripTotal</td><td>Int</td><td>Total number of trips made during the given period</td></tr><tr><td>numberTripScored</td><td>Int</td><td>Number of trips made that were long enough to have a score during the given period</td></tr><tr><td>distance</td><td>Double</td><td>Total distance travelled during the given period (in kilometers)</td></tr><tr><td>duration</td><td>Int</td><td>Total trip duration during the given period (in minutes)</td></tr><tr><td>safety</td><td><a href="#dksafety">DKSafety</a>?</td><td>Safety's score and sub scores for the given period (present only if safety score is configured and the period has some scored trips)</td></tr><tr><td>ecoDriving</td><td><a href="#dkecodriving">DKEcoDriving</a>?</td><td>Eco-driving's score and sub scores for the given period (present only if eco-driving score is configured and the period has some scored trips)</td></tr><tr><td>phoneDistraction</td><td><a href="#dkdistraction">DKDistraction</a>?</td><td>Distraction's score and sub scores for the given period (present only if distraction score is configured)</td></tr><tr><td>speeding</td><td><a href="#dkspeeding">DKSpeeding</a>?</td><td>Speeding's score and sub scores for the given period (present only if speeding score is configured)</td></tr><tr><td>drivingConditions</td><td><a href="#dkdrivingconditions">DKDrivingConditions</a>?</td><td>Advanced informations for a given period (total trip and distance for a specific DKDrivingCategory and by DKWeather, distance travelled by day/night and by weekdays/weekend)</td></tr></tbody></table>

## DKSafety

DKSafety is an object that contains data for safety's score and sub scores.

```swift
public struct DKSafety: Codable {
    public let score: Double
    public let acceleration: Int
    public let braking: Int
    public let adherence: Int
}
```

<table><thead><tr><th width="229">Attribute</th><th width="176.33333333333331">Type</th><th>Description</th></tr></thead><tbody><tr><td>score</td><td>Double</td><td>Global safety score for the given period (ranging from 3 to 10)</td></tr><tr><td>acceleration</td><td>Int</td><td>Number of harsh accelerations during the given period</td></tr><tr><td>braking</td><td>Int</td><td>Number of hard breakings during the given period</td></tr><tr><td>adherence</td><td>Int</td><td>Number of adherence limits during the given period</td></tr></tbody></table>

## DKEcoDriving

`DKEcoDriving` is an object that contains data for eco-driving's score and sub scores.

```swift
public struct DKEcoDriving: Codable {
    public let score: Double
    public let efficiencyAcceleration: Double
    public let efficiencyBrake: Double
    public let efficiencySpeedMaintain: Double
    public let fuelVolume: Double
    public let fuelSaving: Double
    public let co2Mass: Double
}
```

<table><thead><tr><th>Attribute</th><th width="178.33333333333331">Type</th><th>Description</th></tr></thead><tbody><tr><td>score</td><td>Double</td><td>Global eco-driving score for the given period (ranging from 6 to 10)</td></tr><tr><td>efficiencyAcceleration</td><td>Double</td><td>Sub score of acceleration efficiency for the given period (ranging from -5 to 5)</td></tr><tr><td>efficiencyBrake</td><td>Double</td><td>Sub score of braking efficiency for the given period (ranging from -5 to 5)</td></tr><tr><td>efficiencySpeedMaintain</td><td>Double</td><td>Sub score of speed maintain efficiency for the given period (ranging from 0 to 5)</td></tr><tr><td>fuelVolume</td><td>Double</td><td>Fuel consumption during the given period (in liters)</td></tr><tr><td>fuelSaving</td><td>Double</td><td>Achievable fuel savings during the given period (in liters)</td></tr><tr><td>co2Mass</td><td>Double</td><td>CO₂ mass consumed during the given period (in kilograms)</td></tr></tbody></table>

## DKDistraction

`DKDistraction` is an object that contains data for distraction's score and sub scores.

```swift
public struct DKDistraction: Codable {
    public let score: Double
    public let unlock: Int
    public let lock: Int
    public let callForbiddenDuration: Int
    public let numberTripWithForbiddenCall: Int
    public let callForbidden: Int
    public let callAuthorizedDuration: Int
    public let callAuthorized: Int
}
```

<table><thead><tr><th width="273.3333333333333">Attribute</th><th width="168">Type</th><th>Description</th></tr></thead><tbody><tr><td>score</td><td>Double</td><td>Global distraction score for the given period (ranging from 0 to 10)</td></tr><tr><td>unlock</td><td>Int</td><td>Number of screen unlocks during the given period</td></tr><tr><td>lock</td><td>Int</td><td>Number of screen locks during the given period</td></tr><tr><td>callForbiddenDuration</td><td>Int</td><td>Duration of forbidden calls during the given period (in seconds)</td></tr><tr><td>numberTripWithForbiddenCall</td><td>Int</td><td>Number of trips during which the driver made forbidden calls during the given period</td></tr><tr><td>callForbidden</td><td>Int</td><td>Number of forbidden calls during the given period</td></tr><tr><td>callAuthorizedDuration</td><td>Int</td><td>Duration of authorized calls during the given period (in seconds)</td></tr><tr><td>callAuthorized</td><td>Int</td><td>Number of authorized calls during the given period</td></tr></tbody></table>

## DKSpeeding

`DKSpeeding` is an object that contains data for speeding's score and sub scores.

```java
public struct DKSpeeding: Codable {
    public let score: Double
    public let speedingDuration: Int
    public let speedingDistance: Double
}
```

<table><thead><tr><th>Attribute</th><th width="173.33333333333331">Type</th><th>Description</th></tr></thead><tbody><tr><td>score</td><td>Double</td><td>Global speeding score for the given period (ranging from 0 to 10)</td></tr><tr><td>speedingDuration</td><td>Int</td><td>Overspeeding duration during the given period (in seconds)</td></tr><tr><td>speedingDistance</td><td>Double</td><td>Overspeeding distance travelled during the given period (in meters)</td></tr></tbody></table>

## DKDrivingConditions

`DKDrivingConditions` is an object that contains advanced driving information for the given period.

```swift
public struct DKDrivingConditions: Codable {
        public let tripCountByCategory: [DKDrivingCategory: Int]
        public let distanceByCategory: [DKDrivingCategory: Double]
        public let tripCountByWeatherType: [DKWeather: Int]
        public let distanceByWeatherType: [DKWeather: Double]
        public let dayDistance: Double
        public let nightDistance: Double
        public let weekdaysDistance: Double
        public let weekendDistance: Double
}
```

<table><thead><tr><th width="237.33333333333331">Attribute</th><th width="247">Type</th><th>Description</th></tr></thead><tbody><tr><td>tripCountByCategory</td><td><code>[</code><a href="#dkdrivingcategory"><code>DKDrivingCategory</code></a><code>: Int]</code></td><td>Total trips count by driving category</td></tr><tr><td>distanceByCategory</td><td><code>[</code><a href="#dkdrivingcategory"><code>DKDrivingCategory</code></a><code>: Double]</code></td><td>Total distance in km by driving category</td></tr><tr><td>tripCountByWeatherType</td><td><code>[</code><a href="../../../get-started-drivekit/ios/references#dkweather"><code>DKWeather</code></a><code>: Int]</code></td><td>Total trips count by weather category</td></tr><tr><td>distanceByWeatherType</td><td><code>[</code><a href="../../../get-started-drivekit/ios/references#dkweather"><code>DKWeather</code></a><code>: Double]</code></td><td>Total distance in km count by weather category</td></tr><tr><td>dayDistance</td><td><code>Double</code></td><td>Total distance traveled by the day in km </td></tr><tr><td>nightDistance</td><td><code>Double</code></td><td>Total distance traveled by night in km</td></tr><tr><td>weekdaysDistance</td><td><code>Double</code></td><td>Total distance traveled during weekdays in km</td></tr><tr><td>weekendDistance</td><td><code>Double</code></td><td>Total distance traveled during weekend in km</td></tr></tbody></table>

## DKDrivingCategory

```swift
public enum DKDrivingCategory: Int, Codable {
    case lessThan2Km = 0
    case from2To10Km = 1
    case from10To50Km = 2
    case from50To100Km = 3
    case moreThan100Km = 4
}
```

<table><thead><tr><th width="242">Attribute</th><th>Description</th></tr></thead><tbody><tr><td><code>lessThan2Km</code></td><td>Trip distance strictly below <code>2</code> km</td></tr><tr><td><code>from2To10Km</code></td><td>Trip distance in <code>[2, 10[</code> km</td></tr><tr><td><code>from10To50Km</code></td><td>Trip distance in <code>[10, 50[</code> km</td></tr><tr><td><code>from50To100Km</code></td><td>Trip distance in <code>[50, 100[</code> km</td></tr><tr><td><code>moreThan100Km</code></td><td>Trip distance is equals or above <code>100</code> km</td></tr></tbody></table>

## DKRoadContextItem

`DKRoadContextItem` is an object that contains data for the given road context and given period.

```swift
public struct DKRoadContextItem: Codable {
    public let type: DKRoadContext
    public let date: Date
    public let numberTripTotal: Int
    public let numberTripScored: Int
    public let distance: Double
    public let duration: Int
    
    public var ecoDriving: DKEcoDriving?
    public var safety: DKSafety?
}
```

<table><thead><tr><th width="223.33333333333331">Attribute</th><th width="197">Type</th><th>Description</th></tr></thead><tbody><tr><td>type</td><td><a href="#dkroadcontext">DKRoadContext</a></td><td>Road context for the given period</td></tr><tr><td>date</td><td>Date</td><td>Start date of the given period</td></tr><tr><td>numberTripTotal</td><td>Int</td><td>Total number of trips made during the given period and road context</td></tr><tr><td>numberTripScored</td><td>Int</td><td>Number of trips made that were long enough to have a score during the given period and road context</td></tr><tr><td>distance</td><td>Double</td><td>Total distance travelled during the given period and road context (in kilometers)</td></tr><tr><td>duration</td><td>Int</td><td>Total trip duration during the given period and road context (in minutes)</td></tr><tr><td>safety</td><td><a href="#dksafety">DKSafety</a>?</td><td>Safety's score and sub scores for the given period and road context (present only if safety score is configured and the period has some scored trips)</td></tr><tr><td>ecoDriving</td><td><a href="#dkecodriving">DKEcoDriving</a>?</td><td>Eco-driving's score and sub scores for the given period and road context (present only if eco-driving score is configured and the period has some scored trips)</td></tr></tbody></table>

## DKRoadContext

`DKRoadContext` indicates the kind of roads where the data was gathered. It is an enum with the following values:

| Value             | Description                                              |
| ----------------- | -------------------------------------------------------- |
| trafficJam        | The targeted driver was in traffic jams                  |
| heavyUrbanTraffic | The targeted driver was in dense city roads              |
| city              | The targeted driver was in light traffic city roads      |
| suburban          | The targeted driver was in suburban or countryside roads |
| expressways       | The targeted driver was in express ways                  |

```swift
public enum DKRoadContext: Int, Codable {
    case trafficJam
    case heavyUrbanTraffic
    case city
    case suburban
    case expressways
}
```

***

## DKDriverProfile

`DKDriverProfile` is the object describing the driver profile.

| Attribute                    | Type                                                                          | Description                                              |
| ---------------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------- |
| distance                     | [DKDistanceProfile](#dkdistanceprofile)                                       | Distance class                                           |
| activity                     | [DKActivityProfile](#dkactivityprofile)                                       | Activity class                                           |
| regularity                   | [DKRegularityProfile](#dkregularityprofile)                                   | Regularity class                                         |
| mainRoadContext              | [DKRoadContex](#dkroadcontext)t                                               | Main road context                                        |
| mobility                     | [DKMobilityProfile](#dkmobilityprofile)                                       | Mobility class                                           |
| statistics                   | [DKDriverStatistics](#dkdriverstatistics)                                     | Statistics about the driver                              |
| weekRegularity               | [DKDriverRegularity](#dkdriverregularity)                                     | Information about driver’s week regularity               |
| monthRegularity              | [DKDriverRegularity](#dkdriverregularity)                                     | Information about driver’s month regularity              |
| distanceEstimation           | [DKDriverDistanceEstimation](#dkdriverdistanceestimation)                     | Distance estimation by week, month or year               |
| roadContextInfoByRoadContext | Map<[DKRoadContext](#dkroadcontext), [DKRoadContextInfo](#dkroadcontextinfo)> | Contains information about road contexts                 |
| commonTripByType             | Map<[DKCommonTripType](#dkcommontriptype), [DKCommonTrip](#dkcommontrip)>     | Provides information about common trips, by type of trip |
| mobilityAreaRadiusByType     | Map<[DKMobilityAreaType](#dkmobilityareatype), Int>                           | Provides radius of mobility area by type of mobility     |

```swift
public struct DKDriverProfile: Codable {
    public var distance: DKDistanceProfile
    public var activity: DKActivityProfile
    public var regularity: DKRegularityProfile
    public var mainRoadContext: DKRoadContext
    public var mobility: DKMobilityProfile
    public var statistics: DKDriverStatistics
    public var weekRegularity: DKDriverRegularity
    public var monthRegularity: DKDriverRegularity
    public var distanceEstimation: DKDriverDistanceEstimation
    public var roadContextInfoByRoadContext: [DKRoadContext: DKRoadContextInfo]
    public var commonTripByType: [DKCommonTripType: DKCommonTrip]
    public var mobilityAreaRadiusByType: [DKMobilityAreaType: Int]
}
```

## DKDistanceProfile

`DKDistanceProfile` indicates the distance class of the driver.

| Value      | Description                | Estimated yearly distance (in km) |
| ---------- | -------------------------- | --------------------------------- |
| .veryShort | Very short distance driver | less than 5 000                   |
| .short     | Short distance driver      | 5 000 to 10 000                   |
| .medium    | Medium distance driver     | 10 000 to 20 000                  |
| .long      | Long distance driver       | 20 000 to 40 000                  |
| .veryLong  | Professional driver        | more than 40 000                  |

```swift
public enum DKDistanceProfile: String, Codable {
    case veryShort = "VERY_SHORT"
    case short = "SHORT"
    case medium = "MEDIUM"
    case long = "LONG"
    case veryLong = "VERY_LONG"
}
```

## DKActivityProfile

`DKActivityProfile` indicates the activity class of the driver.

| Value   | Description            | Percentage of active weeks |
| ------- | ---------------------- | -------------------------- |
| .low    | Low activity driver    | less than 30 %             |
| .medium | Medium activity driver | 30 to 60 %                 |
| .high   | High activity driver   | more than 60 %             |

```swift
public enum DKActivityProfile: String, Codable {
    case low = "LOW"
    case medium = "MEDIUM"
    case high = "HIGH"
}
```

## DKRegularityProfile

`DKRegularityProfile` indicates the regularity class of the driver.

| Value         | Description         |
| ------------- | ------------------- |
| .regular      | Regular driver      |
| .intermittent | Intermittent driver |

```swift
public enum DKRegularityProfile: String, Codable {
    case regular = "REGULAR"
    case intermittent = "INTERMITTENT"
}
```

## DKMobilityProfile

`DKMobilityProfile` indicates the mobility class of the driver.

<table><thead><tr><th width="225">Value</th><th>Description</th></tr></thead><tbody><tr><td>.narrow</td><td>90% of trips are within a radius of less than 10 km</td></tr><tr><td>.small</td><td>90% of trips are within a radius of less than 20 km</td></tr><tr><td>.medium</td><td>90% of trips are within a radius of less than 30 km</td></tr><tr><td>.large</td><td>90% of trips are within a radius of less than 50 km</td></tr><tr><td>.wide</td><td>90% of trips are within a radius of less  than 100 km</td></tr><tr><td>.vast</td><td>90% of trips are within a radius of 100 km or more</td></tr></tbody></table>

```swift
public enum DKMobilityProfile: String, Codable {
    case narrow = "NARROW"
    case small = "SMALL"
    case medium = "MEDIUM"
    case large = "LARGE"
    case wide = "WIDE"
    case vast = "VAST"
}
```

## DKDriverStatistics

`DKDriverStatistics` is an object providing statistics about the driver.

<table><thead><tr><th width="219">Attribute</th><th width="140.33333333333331">Type</th><th>Description</th></tr></thead><tbody><tr><td>tripsNumber</td><td>Int</td><td>Total number of trips</td></tr><tr><td>totalDistance</td><td>Int</td><td>Total distance (in km)</td></tr><tr><td>totalDuration</td><td>Int</td><td>Total driving duration (in min)</td></tr><tr><td>weekNumber</td><td>Int</td><td>Number of weeks since user registration</td></tr><tr><td>activeWeekNumber</td><td>Int</td><td>Number of active weeks since user registration</td></tr><tr><td>monthNumber</td><td>Int</td><td>Number of months since user registration</td></tr><tr><td>activeMonthNumber</td><td>Int</td><td>Number of active months since user registration</td></tr><tr><td>peakTime</td><td>DKTime</td><td>Peak time trip starts</td></tr><tr><td>peakDay</td><td>DKDay</td><td>Weekday with most trips completed</td></tr></tbody></table>

```swift
public struct DKDriverStatistics: Codable {
    public var tripsNumber: Int
    public var totalDistance: Int
    public var totalDuration: Int
    public var weekNumber: Int
    public var activeWeekNumber: Int
    public var monthNumber: Int
    public var activeMonthNumber: Int
    public var peakTime: DKTime
    public var peakDay: DKDay
}
```

## DKDriverRegularity

`DKDriverRegularity` is an object providing information about driver’s regularity.

<table><thead><tr><th width="295.3333333333333">Attribute</th><th width="118">Type</th><th>Description</th></tr></thead><tbody><tr><td>periodNumber</td><td>Int</td><td>Number of weeks or months used to calculate regularity</td></tr><tr><td>tripNumberMean</td><td>Int</td><td>Average number of trips per week or month</td></tr><tr><td>tripNumberStandardDeviation</td><td>Int</td><td>Standard deviation of the number of trips per week or month</td></tr><tr><td>distanceMean</td><td>Int</td><td>Average weekly or monthly distance (in km)</td></tr><tr><td>distanceStandardDeviation</td><td>Int</td><td>Standard deviation of the weekly or monthly distance (in km)</td></tr><tr><td>durationMean</td><td>Int</td><td>Average weekly or monthly driving duration (in min)</td></tr><tr><td>durationStandardDeviation</td><td>Int</td><td>Standard deviation of the weekly or monthly driving duration (in min)</td></tr></tbody></table>

```swift
public struct DKDriverRegularity: Codable {
    public var periodNumber: Int
    public var tripNumberMean: Int
    public var tripNumberStandardDeviation: Int
    public var distanceMean: Int
    public var distanceStandardDeviation: Int
    public var durationMean: Int
    public var durationStandardDeviation: Int
}
```

## DKDriverDistanceEstimation

`DKDriverDistanceEstimation` is an object providing distance estimation by week, month or year.

<table><thead><tr><th width="184.33333333333331">Attribute</th><th width="340">Type</th><th>Description</th></tr></thead><tbody><tr><td>weekDistance</td><td>Int</td><td>Estimated weekly distance (in km)</td></tr><tr><td>monthDistance</td><td>Int</td><td>Estimated monthly distance (in km)</td></tr><tr><td>yearDistance</td><td>Int</td><td>Estimated annual distance (in km)</td></tr><tr><td>confidence</td><td><a href="#dkdriverdistanceestimationconfidence">DKDriverDistanceEstimationConfidence</a></td><td>Confidence level indicator, based on the available data</td></tr></tbody></table>

```swift
public struct DKDriverDistanceEstimation: Codable {
    public var weekDistance: Int
    public var monthDistance: Int
    public var yearDistance: Int
    public var confidence: DKDriverDistanceEstimationConfidence
}
```

## DKDriverDistanceEstimationConfidence

`DKDriverDistanceEstimationConfidence` indicates the distance estimation confidence class.

<table><thead><tr><th width="270">Value</th><th>Description</th></tr></thead><tbody><tr><td>.low</td><td>If less than 8 weeks since driver’s subscription</td></tr><tr><td>.medium</td><td>If between 9 and 16 weeks since driver’s subscription</td></tr><tr><td>.high</td><td>If more than 16 weeks since driver’s subscription</td></tr></tbody></table>

```swift
public enum DKDriverDistanceEstimationConfidence: String, Codable {
    case low = "LOW"
    case medium = "MEDIUM"
    case high = "HIGH"
}
```

## DKRoadContextInfo

`DKRoadContextInfo` is an object providing information about road context for the driver.

<table><thead><tr><th width="268.3333333333333">Attribute</th><th width="166">Type</th><th>Description</th></tr></thead><tbody><tr><td>roadContext</td><td><a href="#dkroadcontext">DKRoadContext</a></td><td>Road context</td></tr><tr><td>distancePercentage</td><td>Double</td><td>Percentage of total distance driven in this context</td></tr><tr><td>durationPercentage</td><td>Double</td><td>Percentage of total duration driven in this context</td></tr><tr><td>consumedEnergyPercentage</td><td>Double</td><td>Percentage of total energy driven in this context</td></tr></tbody></table>

```swift
public struct DKRoadContextInfo: Codable {
    public var roadContext: DKRoadContext
    public var distancePercentage: Double
    public var durationPercentage: Double
    public var consumedEnergyPercentage: Double
}
```

## DKCommonTripType

`DKCommonTripType` indicates the type of trip.

<table><thead><tr><th width="272">Value</th><th>Description</th></tr></thead><tbody><tr><td>.mostFrequent</td><td>Most frequent trip</td></tr><tr><td>.unknown</td><td>Unknown type for the SDK (if a new type is added but the SDK is not up to date)</td></tr></tbody></table>

```swift
public enum DKCommonTripType: String, Codable {
    case mostFrequent = "MOST_FREQUENT"
    case unknown = "UNKNOWN"
}
```

## DKCommonTrip

`DKCommonTrip` is an object providing information about a trip.

<table><thead><tr><th width="209.33333333333331">Attribute</th><th width="227">Type</th><th>Description</th></tr></thead><tbody><tr><td>type</td><td><a href="#dkcommontriptype">DKCommonTripType</a></td><td>Type of trip</td></tr><tr><td>tripNumber</td><td>Int</td><td>Number of trips</td></tr><tr><td>distanceMean</td><td>Int</td><td>Average trip distance (in km)</td></tr><tr><td>durationMean</td><td>Int</td><td>Average trip duration (in min)</td></tr><tr><td>roadContext</td><td><a href="#dkroadcontext">DKRoadContext</a></td><td>Road context type</td></tr></tbody></table>

```swift
public struct DKCommonTrip: Codable {
    public var type: DKCommonTripType
    public var tripNumber: Int
    public var distanceMean: Int
    public var durationMean: Int
    public var roadContext: DKRoadContext
}
```

## DKMobilityAreaType

`DKMobilityAreaType` indicates the type of mobility area.

<table><thead><tr><th width="222">Value</th><th>Description</th></tr></thead><tbody><tr><td>.percentile50Th</td><td>The radius including 50% of all the user’s trips</td></tr><tr><td>.percentile90Th</td><td>The radius including 90% of all the user’s trips</td></tr></tbody></table>

```swift
public enum DKMobilityAreaType: String, Codable {
    case percentile50Th = "PERCENTILE_50TH"
    case percentile90Th = "PERCENTILE_90TH"
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.drivequant.com/driver-data/ios/references.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.