Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

VerifyDevicePosition

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.

Note

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.

Request Syntax


POST /tracking/v0/trackers/TrackerName/positions/verify HTTP/1.1
Content-type: application/json

{
   "DeviceState": { 
      "Accuracy": { 
         "Horizontal": number
      },
      "CellSignals": { 
         "LteCellDetails": [ 
            { 
               "CellId": number,
               "LocalId": { 
                  "Earfcn": number,
                  "Pci": number
               },
               "Mcc": number,
               "Mnc": number,
               "NetworkMeasurements": [ 
                  { 
                     "CellId": number,
                     "Earfcn": number,
                     "Pci": number,
                     "Rsrp": number,
                     "Rsrq": number
                  }
               ],
               "NrCapable": boolean,
               "Rsrp": number,
               "Rsrq": number,
               "Tac": number,
               "TimingAdvance": number
            }
         ]
      },
      "DeviceId": "string",
      "Ipv4Address": "string",
      "Position": [ number ],
      "SampleTime": "string",
      "WiFiAccessPoints": [ 
         { 
            "MacAddress": "string",
            "Rss": number
         }
      ]
   },
   "DistanceUnit": "string"
}

URI Request Parameters

The request uses the following URI parameters.

TrackerName

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

Length Constraints: Minimum length of 1. Maximum length of 100.

Pattern: [-._\w]+

Required: Yes

Request Body

The request accepts the following data in JSON format.

DeviceState

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

Type: DeviceState object

Required: Yes

DistanceUnit

The distance unit for the verification request.

Default Value: Kilometers

Type: String

Valid Values: Kilometers | Miles

Required: No

Response Syntax


HTTP/1.1 200
Content-type: application/json

{
   "DeviceId": "string",
   "DistanceUnit": "string",
   "InferredState": { 
      "Accuracy": { 
         "Horizontal": number
      },
      "DeviationDistance": number,
      "Position": [ number ],
      "ProxyDetected": boolean
   },
   "ReceivedTime": "string",
   "SampleTime": "string"
}