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.

The Location Integrity SDK provides enhanced features related to device verification, and it is available for use by request. To get access to the SDK, contact Sales Support.

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"
)