Skip to content

Verify Device Position

locationservice_verify_device_position R Documentation

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

Description

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.

Usage

locationservice_verify_device_position(TrackerName, DeviceState,
  DistanceUnit)

Arguments

TrackerName

[required] The name of the tracker resource to be associated with verification request.

DeviceState

[required] The device's state, including position, IP address, cell signals and Wi-Fi access points.

DistanceUnit

The distance unit for the verification request.

Default Value: Kilometers

Value

A list with the following syntax:

list(
  InferredState = list(
    Position = list(
      123.0
    ),
    Accuracy = list(
      Horizontal = 123.0
    ),
    DeviationDistance = 123.0,
    ProxyDetected = TRUE|FALSE
  ),
  DeviceId = "string",
  SampleTime = as.POSIXct(
    "2015-01-01"
  ),
  ReceivedTime = as.POSIXct(
    "2015-01-01"
  ),
  DistanceUnit = "Kilometers"|"Miles"
)

Request syntax

svc$verify_device_position(
  TrackerName = "string",
  DeviceState = list(
    DeviceId = "string",
    SampleTime = as.POSIXct(
      "2015-01-01"
    ),
    Position = list(
      123.0
    ),
    Accuracy = list(
      Horizontal = 123.0
    ),
    Ipv4Address = "string",
    WiFiAccessPoints = list(
      list(
        MacAddress = "string",
        Rss = 123
      )
    ),
    CellSignals = list(
      LteCellDetails = list(
        list(
          CellId = 123,
          Mcc = 123,
          Mnc = 123,
          LocalId = list(
            Earfcn = 123,
            Pci = 123
          ),
          NetworkMeasurements = list(
            list(
              Earfcn = 123,
              CellId = 123,
              Pci = 123,
              Rsrp = 123,
              Rsrq = 123.0
            )
          ),
          TimingAdvance = 123,
          NrCapable = TRUE|FALSE,
          Rsrp = 123,
          Rsrq = 123.0,
          Tac = 123
        )
      )
    )
  ),
  DistanceUnit = "Kilometers"|"Miles"
)