com.zendrive.sdk

Enum ZendriveIssueType

java.lang.Object

java.lang.Enum<ZendriveIssueType>

com.zendrive.sdk.ZendriveIssueType

All Implemented Interfaces:

Serializable, Comparable<ZendriveIssueType>

public enum ZendriveIssueType
extends Enum<ZendriveIssueType>

The type of a ZendriveSettingError or ZendriveSettingWarning

Enum Constant Summary

Enum Constants

Enum Constant and Description
ACTIVITY_RECOGNITION_PERMISSION_DENIED User has denied activity recognition permission to the application.
AIRPLANE_MODE_ENABLED Airplane mode is enabled on the device and is affecting location accuracy.
BACKGROUND_RESTRICTION_ENABLED User has enabled background restrictions on the application.
BATTERY_OPTIMIZATION_ENABLED Battery optimization is enabled.
BLE_PERMISSION_DENIED This warning is thrown when there are Beacon vehicle tagging feature is enabled but the necessary permissions have been denied.
BLUETOOTH_DISABLED Bluetooth is disabled when there are some vehicles already associated by using associateVehicle or beacon vehicle tagging is enabled.
BLUETOOTH_PERMISSION_DENIED This warning is thrown when there are associated vehicles for bluetooth vehicle tagging but the necessary bluetooth permissions have been denied.
GOOGLE_PLAY_CONNECTION_ERROR Zendrive SDK was unable to connect to Google Play services.
GOOGLE_PLAY_SETTINGS_ERROR There is a settings error from Google play services.
LOCATION_MODE_HIGH_ACCURACY_DENIED This will be returned on devices running on Android versions 4.4 to 8.1 when user has not set location mode as Settings.Secure.
LOCATION_PERMISSION_DENIED User has denied location permission to the application.
LOCATION_SETTINGS_ERROR Deprecated. This issue type is no longer used and will be removed in a future SDK release.
LOCATION_UNAVAILABLE_WHILE_DRIVE_RESUME Specific to the While In Use location permission, resuming the drives from the background is affected due to location unavailability when the request is made from the background.
ONE_PLUS_DEEP_OPTIMIZATION OnePlus OEM specific Deep Optimization battery setting is enabled on device.
OVERLAY_PERMISSION_DENIED Draw over other apps is disabled.
POWER_SAVER_MODE_ENABLED Power saver mode is enabled.
PRECISE_LOCATION_DENIED This will be returned on devices running on Android 12 and above when the user has set the location accuracy for the application as "Approximate" (which provides the location access accuracy corresponding to Manifest.permission.ACCESS_COARSE_LOCATION).
WIFI_SCANNING_DISABLED Deprecated. This issue type is no longer used and will be removed in a future SDK release.

Method Summary

Modifier and Type	Method and Description
static ZendriveIssueType	valueOf(String name) Returns the enum constant of this type with the specified name.
static ZendriveIssueType[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

POWER_SAVER_MODE_ENABLED

public static final ZendriveIssueType POWER_SAVER_MODE_ENABLED

Power saver mode is enabled. This is returned only on devices running OS version Lollipop or higher.

For devices running OS versions prior to Android P, this is returned as a warning. For devices running Android P and above, it is returned as an error if this affects location when device screen is turned off. Otherwise this is returned as a warning.

BACKGROUND_RESTRICTION_ENABLED

public static final ZendriveIssueType BACKGROUND_RESTRICTION_ENABLED

User has enabled background restrictions on the application. This error is returned on devices running Android P and onwards.

LOCATION_PERMISSION_DENIED

public static final ZendriveIssueType LOCATION_PERMISSION_DENIED

User has denied location permission to the application. On Android Q and above, the user needs to grant Manifest.permission.ACCESS_BACKGROUND_LOCATION in addition to Manifest.permission.ACCESS_FINE_LOCATION.

BATTERY_OPTIMIZATION_ENABLED

public static final ZendriveIssueType BATTERY_OPTIMIZATION_ENABLED

Battery optimization is enabled. This can happen when:
1) Device specific Adaptive battery is turned on and the app is not exempted from this setting.
2) User has explicitly turned on Battery Optimization for the app.
This will be shown as an error on Samsung devices only. For more details, see: Optimize for Doze and App Standby

ONE_PLUS_DEEP_OPTIMIZATION

public static final ZendriveIssueType ONE_PLUS_DEEP_OPTIMIZATION

OnePlus OEM specific Deep Optimization battery setting is enabled on device.

This error indicates that trip detection of Zendrive SDK is heavily restricted and drives may not be properly recorded. This is returned on devices running OS version Android P or lower.

The user should cast the ZendriveSettingError to an instance of ZendriveResolvableError. The user should then use the ZendriveResolvableError.navigableIntent to navigate to device specific screen to resolve error.

LOCATION_SETTINGS_ERROR

@Deprecated
public static final ZendriveIssueType LOCATION_SETTINGS_ERROR

Deprecated. This issue type is no longer used and will be removed in a future SDK release.

Device location settings is not set to high accuracy.

WIFI_SCANNING_DISABLED

@Deprecated
public static final ZendriveIssueType WIFI_SCANNING_DISABLED

Deprecated. This issue type is no longer used and will be removed in a future SDK release.

Wifi scanning is disabled on the device and is affecting location accuracy.

On devices running OS versions older than Jelly Bean MR2, this happens when the wifi radio is turned off, either separately or as part of airplane mode.

On devices running OS versions Jelly Bean MR2 and up, this happens if wifi scanning isn't set to "always on" and the wifi radio is turned off, either separately or as part of airplane mode.

GOOGLE_PLAY_CONNECTION_ERROR

public static final ZendriveIssueType GOOGLE_PLAY_CONNECTION_ERROR

Zendrive SDK was unable to connect to Google Play services.

The user should cast the ZendriveSettingError to an instance of GooglePlayConnectionError. The user should then use the GooglePlayConnectionError.connectionResult to diagnose and resolve the issue.

GOOGLE_PLAY_SETTINGS_ERROR

public static final ZendriveIssueType GOOGLE_PLAY_SETTINGS_ERROR

There is a settings error from Google play services.

The user should cast the ZendriveSettingError to an instance of GooglePlaySettingsError. The user should then use the GooglePlaySettingsError.googlePlaySettingsResult to diagnose and resolve the issue.

ACTIVITY_RECOGNITION_PERMISSION_DENIED

public static final ZendriveIssueType ACTIVITY_RECOGNITION_PERMISSION_DENIED

User has denied activity recognition permission to the application. This is returned on devices running:
1. Android Q and above. In this case the user needs to grant Manifest.permission.ACTIVITY_RECOGNITION.
2. Huawei devices running Android P with EMUI >= 9.1.1. In this case the developer needs to request "com.huawei.hms.permission.ACTIVITY_RECOGNITION".

OVERLAY_PERMISSION_DENIED

public static final ZendriveIssueType OVERLAY_PERMISSION_DENIED

Draw over other apps is disabled. This is returned only on devices running OS version Marshmallow or higher.

AIRPLANE_MODE_ENABLED

public static final ZendriveIssueType AIRPLANE_MODE_ENABLED

Airplane mode is enabled on the device and is affecting location accuracy.

BLUETOOTH_DISABLED

public static final ZendriveIssueType BLUETOOTH_DISABLED

Bluetooth is disabled when there are some vehicles already associated by using associateVehicle or beacon vehicle tagging is enabled.

LOCATION_UNAVAILABLE_WHILE_DRIVE_RESUME

public static final ZendriveIssueType LOCATION_UNAVAILABLE_WHILE_DRIVE_RESUME

Specific to the While In Use location permission, resuming the drives from the background is affected due to location unavailability when the request is made from the background. The user needs to either get the application in the foreground or grant Manifest.permission.ACCESS_BACKGROUND_LOCATION in addition to Manifest.permission.ACCESS_FINE_LOCATION.

PRECISE_LOCATION_DENIED

public static final ZendriveIssueType PRECISE_LOCATION_DENIED

This will be returned on devices running on Android 12 and above when the user has set the location accuracy for the application as "Approximate" (which provides the location access accuracy corresponding to Manifest.permission.ACCESS_COARSE_LOCATION).

Zendrive SDK needs the location access accuracy for the application to be set as "Precise" (which provides the location accuracy corresponding to Manifest.permission.ACCESS_FINE_LOCATION) to operate. Hence, it is recommended to not manually downgrade the location access accuracy.

LOCATION_MODE_HIGH_ACCURACY_DENIED

public static final ZendriveIssueType LOCATION_MODE_HIGH_ACCURACY_DENIED

This will be returned on devices running on Android versions 4.4 to 8.1 when user has not set location mode as Settings.Secure.

In android versions 4.4 to Android 8.1, a user can choose location mode based on accuracy, speed, and battery use.

1. Settings.Secure: Use GPS, Wi-Fi, mobile networks, and sensors to get the most accurate location. Use Google Location Services to help estimate your phone's location faster and more accurately.

2. Settings.Secure: Use sources that use less battery, like Wi-Fi and mobile networks. Use Google Location Services to help estimate your phone's location faster and more accurately.

3. Settings.Secure: Use only GPS. Do not use Google Location Services to provide location information. This can estimate your phone's location more slowly and use more battery.

Settings.Secure is the best among above three modes for trip detection.

BLUETOOTH_PERMISSION_DENIED

public static final ZendriveIssueType BLUETOOTH_PERMISSION_DENIED

This warning is thrown when there are associated vehicles for bluetooth vehicle tagging but the necessary bluetooth permissions have been denied. So vehicle tagging using bluetooth will not work properly. Please check the cases below which can lead to this error:

1. Near by device permission has been denied by the user at run time.
2. For devices running on and above Android 12, BLUETOOTH_CONNECT permission is not present in the AndroidManifest.xml file.
3. For devices running on Android version below Android 12, BLUETOOTH permission is not present in the AndroidManifest.xml file.

BLE_PERMISSION_DENIED

public static final ZendriveIssueType BLE_PERMISSION_DENIED

This warning is thrown when there are Beacon vehicle tagging feature is enabled but the necessary permissions have been denied. So vehicle tagging using beacons will not work properly. Please check the cases below which can lead to this error:

1. Near by device permission has been denied by the user at run time.
2. For devices running on and above Android 12, BLUETOOTH_SCAN permission is not present in the AndroidManifest.xml file.
3. For devices running on Android version below Android 12, BLUETOOTH_ADMIN permission is not present in the AndroidManifest.xml file.
4. For devices running on and above Android 12, BLUETOOTH_CONNECT permission is not present in the AndroidManifest.xml file.
5. For devices running on Android version below Android 12, BLUETOOTH permission is not present in the AndroidManifest.xml file.

Method Detail

values

public static ZendriveIssueType[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (ZendriveIssueType c : ZendriveIssueType.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static ZendriveIssueType valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null