ZendriveDelegateProtocol

@protocol ZendriveDelegateProtocol <NSObject>

Delegate for Zendrive.

  • Called on delegate in the main thread when Zendrive SDK detects a potential start of a drive.

    Declaration

    Objective-C

    - (void)processStartOfDrive:(nonnull ZendriveDriveStartInfo *)startInfo;

    Parameters

    startInfo

    Info about drive start. Refer to ZendriveDriveStartInfo for further details.

  • Called on delegate in the main thread when Zendrive SDK resumes a drive after a gap.

    The gap in drive recording may occur due to an application restart by the OS, application kill and restart by a user, an application crash or other reasons. Drives started by calling +[Zendrive startManualDrive:completionHandler:] are always resumed and they will not end until +[Zendrive stopManualDrive:completionHandler:] is called.

    Declaration

    Objective-C

    - (void)processResumeOfDrive:(nonnull ZendriveDriveResumeInfo *)resumeInfo;

    Parameters

    resumeInfo

    Info about drive resume. Refer to ZendriveDriveResumeInfo for further details.

  • Called on the delegate in the main thread when Zendrive SDK detects a drive to have been completed.

    It is possible that Zendrive SDK might decide at a later time that an ongoing trip was a falsely detected trip. In such scenario processEndOfDrive: will be invoked on delegate with ZendriveDriveInfo.driveType set to ZendriveDriveTypeInvalid.

    Every trip with ZendriveDriveInfo.driveType not set to ZendriveDriveTypeInvalid will receive a corresponding -processAnalysisOfDrive: callback containing additional info related to this drive.

    Declaration

    Objective-C

    - (void)processEndOfDrive:
    (nonnull ZendriveEstimatedDriveInfo *)estimatedDriveInfo;

    Parameters

    estimatedDriveInfo

    Best estimate info about the drive. Refer to ZendriveEstimatedDriveInfo for further details.

  • Called on the delegate in the main thread when Zendrive SDK finishes full analysis of all valid drives returned from -processEndOfDrive: callback.

    This will be called for all the -processEndOfDrive: callbacks with the value of ZendriveDriveInfo.driveType not set to ZendriveDriveTypeInvalid.

    This may contain additional or improved data over the ZendriveEstimatedDriveInfo returned from -processEndOfDrive:

    Typically this callback will be fired within a few seconds after -processEndOfDrive: callback but in some rare cases this delay can be really large depending on phone network conditions.

    This callback will be fired in trip occurrence sequence, i.e from oldest trip to the latest trip.

    Declaration

    Objective-C

    - (void)processAnalysisOfDrive:
    (nonnull ZendriveAnalyzedDriveInfo *)analyzedDriveInfo;

    Parameters

    analyzedDriveInfo

    Analyzed insights of the drive.

  • This callback is fired on the main thread when an accident is detected by the SDK during a drive. Any ongoing auto-detected/manual drives will be stopped after this point.

    Declaration

    Objective-C

    - (void)processAccidentDetected:(nonnull ZendriveAccidentInfo *)accidentInfo;

    Parameters

    accidentInfo

    Info about accident.

  • This callback is fired on main thread when location services are denied for the SDK. After this callback, drive detection is paused until location services are re-enabled for the SDK.

    The expected behaviour is that the enclosing application shows an appropriate popup prompting the user to allow location services for the app.

    The callback is triggered once every time location services are denied by the user and can be triggered in background or in foreground, depending on whether the SDK has enough CPU time to execute.

    This callback is not sent if ZendriveConfiguration.managesLocationPermission value was set to NO at setup.

    Declaration

    Objective-C

    - (void)processLocationDenied;

  • This method is called when location permission state is determined for the first time or whenever it changes.

    This callback is not sent if ZendriveConfiguration.managesLocationPermission value was set to NO at setup.

    Declaration

    Objective-C

    - (void)processLocationApproved;