Flutter驾驶数据获取插件flutter_drivekit_driver_data的使用

Flutter接口用于获取驾驶数据。

要了解有关DriveKit的更多信息，请访问我们的DriveKit文档。

安装

要使用此插件，在项目中运行以下命令：

flutter pub add drivekit_driver_data

现在，您可以导入'package:flutter_drivekit_driver_data/flutter_drivekit_driver_data.dart'并使用DriveKitDriverData在您的Dart代码中。

使用

要使用此插件，您需要从DriveQuant获取一个Apikey。如果您还没有，请联系我们。 然后，您需要安装flutter_drivekit_core插件，并按照说明指定Apikey和UserId。

现在，您可以根据需要配置DriveKit核心，并开始使用DriveKit驾驶数据插件。

请参阅DriveKit驾驶数据文档以了解我们提供的功能的更多信息。

您还可以查看flutter示例以了解DriveKit SDK的基本用法，以及iOS示例应用或Android示例应用以获得完整的演示。

手动初始化

如果您已禁用了DriveKit的自动初始化：

Android项目

在MainApplication类中调用DriveKitDriverData类的initialize方法。

// MainApplication.kt

// …
override fun onCreate() {
    super.onCreate()

    DriveKit.initialize()
    DriveKitTripAnalysis.initialize(…)
    DriveKitDriverData.initialize()
    (…)
}

iOS项目

在AppDelegate中调用initialize方法。

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    DriveKit.shared.initialize()
    DriveKitTripAnalysis.shared.initialize(appLaunchOptions: launchOptions)
    DriveKitDriverData.shared.initialize()
    (…)
}

API

以下是可用的方法及其返回类型：

getTripsOrderByDateAsc 和 getTripsOrderByDateDesc

这两个方法用于按日期升序或降序获取行程列表。

Future<GetTripsResponse?> getTripsOrderByDateAsc(
    SynchronizationType synchronizationType = SynchronizationType.defaultSync,
    List<TransportationMode> transportationModes = const [
      TransportationMode.unknown,
      TransportationMode.car,
      TransportationMode.moto,
      TransportationMode.truck,
    ],
);

// 或者

Future<GetTripsResponse?> getTripsOrderByDateDesc(
    SynchronizationType synchronizationType = SynchronizationType.defaultSync,
    List<TransportationMode> transportationModes = const [
      TransportationMode.unknown,
      TransportationMode.car,
      TransportationMode.moto,
      TransportationMode.truck,
    ],
);

GetTripsResponse 包含以下字段：

要获取司机的所有行程，可以调用以下方法：

final tripSyncResult = await DriveKitDriverData.instance.getTripsOrderByDateAsc();

或者

final tripSyncResult = await DriveKitDriverData.instance.getTripsOrderByDateDesc();

getTrip

该方法用于获取特定行程。

Future<GetTripResponse?> getTrip(String itinId);

GetTripResponse 包含以下字段：

要获取特定行程，可以调用以下方法：

final result = await DriveKitDriverData.instance.getTrip('TRIP_ID_HERE');

getRoute

该方法用于获取特定行程的路线。

Future<GetRouteResponse?> getRoute(String itinId);

GetRouteResponse 包含以下字段：

要获取特定行程的路线，可以调用以下方法：

final result = await DriveKitDriverData.instance.getRoute('TRIP_ID_HERE');

deleteTrip

该方法用于删除特定行程。

Future<bool> deleteTrip(String itinId);

要删除特定行程，可以调用以下方法：

final result = await DriveKitDriverData.instance.deleteTrip('TRIP_ID_HERE');

示例代码

以下是使用flutter_drivekit_driver_data插件的基本示例代码：

import 'package:flutter/material.dart';

void main() => runApp(const MyApp());

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(home: HomePage());
  }
}

class HomePage extends StatefulWidget {
  const HomePage({super.key});

  [@override](/user/override)
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('DriveKitDriverData Example')),
      body: const Column(
        children: [
          Text('请参阅主flutter示例SDK'),
          Text(
            'https://github.com/DriveQuantPublic/flutter-drivekit/tree/main/example',
          ),
        ],
      ),
    );
  }
}