数据导出
UBI SDK 提供数据导出机制，方便接入方批量获取 UBI SDK 平台上托管的数据。UBI SDK 提供导出服务的数据分如下两类：
- 用户驾驶行为评分：使用用户在较长时间内的行程数据进行驾驶行为分析的结果。
- 明细数据：包括用户列表，行程列表，用户的基本统计信息等数据。
我们支持定期将数据导出到 阿里云 OSS，接入方需要提供如下信息供 UBI SDK 平台将数据写入目标存储：
- 数据类型：目前仅支持导出用户驾驶行为评分数据
- 文件格式：UBI SDK 平台支持导出 Parquet, ORC 或 JSON Lines 格式的数据
- OSS endpoint
- RAM Access Key & Access Secret
- 导出路径
接入方可以复用用于保存行程原始数据的 OSS 存储，仅需指定导出路径与文件格式即可：
定期导出的数据会被写到 导出路径/日期/ 路径下，例如 /path/to/exported_data/20220105/。一份数据由多个分片文件 (part-*) 组成，分片文件的格式为用户申请定期导出时指定的文件格式。
全部数据导出完成后，UBI SDK 平台会创建路径为 导出路径/日期/_SUCCESS 的空文件以标识该份数据已被成功导出。
数据格式说明
用户驾驶行为评分
| 字段名 | 字段类型 | 描述 |
|---|---|---|
| user_id | long | UBI 用户唯一标识 |
| org_user_id | string | 接入方的用户账户体系下的用户唯一标识 |
| app_id | string | APP ID |
| start_time | timestamp | 统计周期开始时间 |
| end_time | timestamp | 统计周期结束时间 |
| safety_score | double | 驾驶安全分 (0 ~ 100)，评分越高驾驶习惯越好 |
| trip_count | int | 用户在统计周期内的行程数目 |
| distracted_driving | double | 分心驾驶(打电话，玩手机)占比 |
| evening_rush_hour | double | 晚高峰(17点到20点)驾驶时长占比 |
| acclong_abs1 | double | 驾驶过程中，纵向加速度的绝对值>1m/s的占比 |
| weekday_driving | double | 工作日(周一到周五)驾驶时长占比 |
| low_speed | double | 低速驾驶(0-20km/h)占比 |
| ctime | timestamp | 统计记录生成时间 |
注意
- 数据导出机制仅支持导出 T-1 的数据，不包含发起导出当天的数据。
- 行程的处理完成时间比行程的开始时间更晚，例如跨天的行程，或因网络连通性原因自动结束的行程在若干天后才上传到服务端。用户驾驶行为统计以行程的开始时间为准。
明细数据
导出数据明细 API 参考: Export API
导出任务状态查询参考: Status View
注意：数据导出仅支持导出 T-1 的数据
用户信息
| 字段名 | 字段类型 | 描述 |
|---|---|---|
| uid | long | UBI 用户唯一标识 |
| org_user_id | string | 接入方的用户账户体系下的用户唯一标识 |
| app_id | string | APP ID |
| status | string | 用户状态(正常;注销) |
行程数据
| 字段名 | 字段类型 | 描述 |
|---|---|---|
| uid | long | UBI 用户唯一标识 |
| trip_id | string | 行程唯一标识 |
| status | string | 行程状态(行程正常;摘要异常) |
| start_time | datetime | 行程开始时间 |
| end_time | datetime | 行程结束时间 |
| start_poi | string | 行程开始地理位置 |
| end_poi | string | 行程结束地理位置 |
| auto_start | string | 是否是自动开始(是;否) |
| auto_end | string | 是否是自动结束(是;否) |
| not_driver | string | 是否自己驾驶(是;不是) |
| is_normal | string | 行程是否正常(正常;异常) |
| abnormal_code | string | 异常编码(正常;速度异常;距离不足;非自己驾驶) |
| app_version | string | 版本号 |
| start_point | string | 行程起点经纬度 |
| end_point | string | 行程终点经纬度 |
| route_oss_key | string | 行程轨迹oss_key |
| digest_oss_key | string | 行为摘要文件oss_key |
| event_count | string | 安全隐患统计 |
| valid_duration | string | 定位精度高的时长（秒） |
| driving_mileage | string | 定位精度高且是开车状态的里程（米） |
| coordinates | string | gps坐标系类型 |
| max_speed_in_kilometers_per_hour | string | 最高速度（单位km/h） |
| avg_speed_in_kilometers_per_hour | string | 平均速度（单位km/h） |
| valid_mileage | string | 定位精度高的里程（米） |
| duration_in_seconds | string | 驾驶时长（单位秒） |
| driving_duration | string | 定位精度高且是开车状态的时长（秒） |
行程统计数据
| 字段名 | 字段类型 | 描述 |
|---|---|---|
| uid | long | UBI 用户唯一标识 |
| total_mileage_in_meters | BIGINT | 行驶总里程（单位米） |
| display_mileage | string | 前端显示里程（千米） |
危险行为数据
| 字段名 | 字段类型 | 描述 |
|---|---|---|
| uid | long | UBI 用户唯一标识 |
| app_id | string | APP ID |
| org_user_id | string | 接入方的用户账户体系下的用户唯一标识 |
| trip_id | string | 行程唯一标识 |
| start_time | datetime | 行程开始时间 |
| end_time | datetime | 行程结束时间 |
| total_mileage_in_meters | BIGINT | 行驶总里程（单位米） |
| duration_in_seconds | string | 驾驶时长（单位秒） |
| left_turn_num | bigint | 急左转次数 |
| right_turn_num | bigint | 急右转次数 |
| throttle_num | bigint | 急加速次数 |
| brake_num | bigint | 急刹车次数 |
| phone_call_num | bigint | 打电话次数 |
| speeding_num | bigint | 超速次数 |
| night_driving_num | bigint | 夜间行车次数 |
| tired_driving_num | bigint | 疲劳驾驶次数 |
| phone_play_num | bigint | 玩手机次数 |
| phone_call_duration | bigint | 打电话持续时长(秒) |
| speeding_duration | bigint | 超速持续时长(秒) |
| night_driving_duration | bigint | 夜间行车持续时长(秒) |
| tired_driving_duration | bigint | 疲劳驾驶持续时长(秒) |
| phone_play_duration | bigint | 玩手机持续时长(秒) |
安全驾驶分数据
| 字段名 | 字段类型 | 描述 |
|---|---|---|
| uid | long | UBI 用户唯一标识 |
| org_user_id | string | 接入方的用户账户体系下的用户唯一标识 |
| safety_score | double | 驾驶分, 0-100 |
| interval | int | 计算的周期范围(单位: 天) |