verifyDevicePosition method

Future<VerifyDevicePositionResponse> verifyDevicePosition({ required DeviceState deviceState, required String trackerName, DistanceUnit? distanceUnit, })

Verifies the integrity of the device's position by determining if it was reported behind a proxy, and by comparing it to an inferred position estimated based on the device's state.

May throw AccessDeniedException. May throw InternalServerException. May throw ResourceNotFoundException. May throw ThrottlingException. May throw ValidationException.

Parameter deviceState : The device's state, including position, IP address, cell signals and Wi-Fi access points.

Parameter trackerName : The name of the tracker resource to be associated with verification request.

Parameter distanceUnit : The distance unit for the verification request.

Default Value: Kilometers

Implementation

Future<VerifyDevicePositionResponse> verifyDevicePosition({
  required DeviceState deviceState,
  required String trackerName,
  DistanceUnit? distanceUnit,
}) async {
  final $payload = <String, dynamic>{
    'DeviceState': deviceState,
    if (distanceUnit != null) 'DistanceUnit': distanceUnit.value,
  };
  final response = await _protocol.send(
    payload: $payload,
    method: 'POST',
    requestUri:
        '/tracking/v0/trackers/${Uri.encodeComponent(trackerName)}/positions/verify',
    hostPrefix: 'tracking.',
    exceptionFnMap: _exceptionFns,
  );
  return VerifyDevicePositionResponse.fromJson(response);
}