com.zendrive.sdk

Enum ZendriveVehicleTaggingOperationResult

java.lang.Object

java.lang.Enum<ZendriveVehicleTaggingOperationResult>

com.zendrive.sdk.ZendriveVehicleTaggingOperationResult

All Implemented Interfaces:

Serializable, Comparable<ZendriveVehicleTaggingOperationResult>

public enum ZendriveVehicleTaggingOperationResult
extends Enum<ZendriveVehicleTaggingOperationResult>

The result of a ZendriveVehicleTagging operation.

Enum Constant Summary

Enum Constants

Enum Constant and Description
ASSOCIATED_VEHICLE_CONFLICT The associateVehicle operation failed because the vehicleId or the bluetoothAddress of the ZendriveVehicleInfo provided conflicts with the information of a currently associated vehicle.
ASSOCIATED_VEHICLES_LIMIT_EXCEEDED The associateVehicle operation failed because it tried to associate more than two distinct vehicles.
BEACON_SCAN_ALREADY_IN_PROGRESS The ZendriveVehicleTagging.getNearbyBeacons(android.content.Context, java.util.UUID, java.lang.Integer, java.lang.Integer, com.zendrive.sdk.ZendriveBeaconScanCallback) operation fails with the following error when there is another ZendriveVehicleTagging.getNearbyBeacons(android.content.Context, java.util.UUID, java.lang.Integer, java.lang.Integer, com.zendrive.sdk.ZendriveBeaconScanCallback) scan already in progress.
BLE_SCAN_INTERNAL_ERROR The ZendriveVehicleTagging.getNearbyBeacons(android.content.Context, java.util.UUID, java.lang.Integer, java.lang.Integer, com.zendrive.sdk.ZendriveBeaconScanCallback) operation fails with the following error when BLE scan fails to start due to an internal error.
BLE_SCAN_NOT_SUPPORTED The getNearbyBeacons operation fails with the following error when BLE scanning is not supported by the device hardware.
BLUETOOTH_NOT_AVAILABLE The ZendriveVehicleTagging.getNearbyBeacons(android.content.Context, java.util.UUID, java.lang.Integer, java.lang.Integer, com.zendrive.sdk.ZendriveBeaconScanCallback) operation fails with the following error when the bluetoothAdapter is not enabled or the bluetoothLeScanner is unavailable.
BLUETOOTH_PERMISSION_REVOKED The associateVehicle operation failed because the necessary bluetooth permission is denied.
INVALID_VEHICLE_ID The vehicleId provided to dissociateVehicle call is either invalid or longer than 64 characters.
INVALID_ZENDRIVE_VEHICLE_INFO The ZendriveVehicleInfo provided to associateVehicle call is invalid.
LOCATION_ERROR The ZendriveVehicleTagging.getNearbyBeacons(android.content.Context, java.util.UUID, java.lang.Integer, java.lang.Integer, com.zendrive.sdk.ZendriveBeaconScanCallback) operation fails with the following error if the Manifest.permission.ACCESS_FINE_LOCATION is not provided.
SDK_NOT_SETUP The operation failed because the SDK is not setup.
SUCCESS The operation was successful.
VEHICLE_NOT_ASSOCIATED The dissociateVehicle operation failed because it tried to dissociate a vehicle which is not associated.

Method Summary

Modifier and Type	Method and Description
String	getMessage() Get the message for the vehicle tagging operation.
static ZendriveVehicleTaggingOperationResult	valueOf(String name) Returns the enum constant of this type with the specified name.
static ZendriveVehicleTaggingOperationResult[]	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

SUCCESS

public static final ZendriveVehicleTaggingOperationResult SUCCESS

The operation was successful.

SDK_NOT_SETUP

public static final ZendriveVehicleTaggingOperationResult SDK_NOT_SETUP

The operation failed because the SDK is not setup.

BLUETOOTH_PERMISSION_REVOKED

public static final ZendriveVehicleTaggingOperationResult BLUETOOTH_PERMISSION_REVOKED

The associateVehicle operation failed because the necessary bluetooth permission is denied. 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.

INVALID_ZENDRIVE_VEHICLE_INFO

public static final ZendriveVehicleTaggingOperationResult INVALID_ZENDRIVE_VEHICLE_INFO

The ZendriveVehicleInfo provided to associateVehicle call is invalid.
A ZendriveVehicleInfo is invalid if:

• it is null.
• vehicleId is either invalid (Validated using Zendrive.isValidInputParameter(java.lang.String)) or longer than 64 characters.
• bluetoothAddress is invalid (Validated using BluetoothAdapter.checkBluetoothAddress(String)).

ASSOCIATED_VEHICLE_CONFLICT

public static final ZendriveVehicleTaggingOperationResult ASSOCIATED_VEHICLE_CONFLICT

The associateVehicle operation failed because the vehicleId or the bluetoothAddress of the ZendriveVehicleInfo provided conflicts with the information of a currently associated vehicle.

ASSOCIATED_VEHICLES_LIMIT_EXCEEDED

public static final ZendriveVehicleTaggingOperationResult ASSOCIATED_VEHICLES_LIMIT_EXCEEDED

The associateVehicle operation failed because it tried to associate more than two distinct vehicles.
For a given vehicle, both bluetooth stereo and beacon can be used to associate with it. However, the total number of distinct vehicles associated with the SDK cannot exceed two.

INVALID_VEHICLE_ID

public static final ZendriveVehicleTaggingOperationResult INVALID_VEHICLE_ID

The vehicleId provided to dissociateVehicle call is either invalid or longer than 64 characters.

VEHICLE_NOT_ASSOCIATED

public static final ZendriveVehicleTaggingOperationResult VEHICLE_NOT_ASSOCIATED

The dissociateVehicle operation failed because it tried to dissociate a vehicle which is not associated.

BLE_SCAN_NOT_SUPPORTED

public static final ZendriveVehicleTaggingOperationResult BLE_SCAN_NOT_SUPPORTED

The getNearbyBeacons operation fails with the following error when BLE scanning is not supported by the device hardware.

BEACON_SCAN_ALREADY_IN_PROGRESS

public static final ZendriveVehicleTaggingOperationResult BEACON_SCAN_ALREADY_IN_PROGRESS

The ZendriveVehicleTagging.getNearbyBeacons(android.content.Context, java.util.UUID, java.lang.Integer, java.lang.Integer, com.zendrive.sdk.ZendriveBeaconScanCallback) operation fails with the following error when there is another ZendriveVehicleTagging.getNearbyBeacons(android.content.Context, java.util.UUID, java.lang.Integer, java.lang.Integer, com.zendrive.sdk.ZendriveBeaconScanCallback) scan already in progress.

BLUETOOTH_NOT_AVAILABLE

public static final ZendriveVehicleTaggingOperationResult BLUETOOTH_NOT_AVAILABLE

The ZendriveVehicleTagging.getNearbyBeacons(android.content.Context, java.util.UUID, java.lang.Integer, java.lang.Integer, com.zendrive.sdk.ZendriveBeaconScanCallback) operation fails with the following error when the bluetoothAdapter is not enabled or the bluetoothLeScanner is unavailable. On SDK version 8.0, this error might also be received if the Nearby Devices permission is forcefully denied on devices running on Android 12 or above.

BLE_SCAN_INTERNAL_ERROR

public static final ZendriveVehicleTaggingOperationResult BLE_SCAN_INTERNAL_ERROR

The ZendriveVehicleTagging.getNearbyBeacons(android.content.Context, java.util.UUID, java.lang.Integer, java.lang.Integer, com.zendrive.sdk.ZendriveBeaconScanCallback) operation fails with the following error when BLE scan fails to start due to an internal error. In order to resolve it, please try switching OFF the Bluetooth and turning it ON again, and retry scanning. Please contact "support@zendrive.com" if the error continues to occur.

LOCATION_ERROR

public static final ZendriveVehicleTaggingOperationResult LOCATION_ERROR

The ZendriveVehicleTagging.getNearbyBeacons(android.content.Context, java.util.UUID, java.lang.Integer, java.lang.Integer, com.zendrive.sdk.ZendriveBeaconScanCallback) operation fails with the following error if the Manifest.permission.ACCESS_FINE_LOCATION is not provided.

Method Detail

values

public static ZendriveVehicleTaggingOperationResult[] 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 (ZendriveVehicleTaggingOperationResult c : ZendriveVehicleTaggingOperationResult.values())
    System.out.println(c);

Returns:

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

valueOf

public static ZendriveVehicleTaggingOperationResult 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

getMessage

public String getMessage()

Get the message for the vehicle tagging operation.

Returns:

Returns the message for the vehicle tagging operation.