Overview

This API allows clients to retrieve or verify the area where a certain user device is localized.

Device location retrieval

Clients are able to gather the device's location and the timestamp of the last location update for the given device.

The requester could optionally ask for a freshness of the localization information by modifying the maxAge attribute of the request ("I want a location not older than 600 seconds")

Device location verification

Clients are able to verify whether the location of certain user device is within the area specified. Currently the only area supported as input is a circle determined by the a set of coordinates (latitude and longitude) and some expected accuracy (radius).

Result of a verification request:

• TRUE: when the network locates the device within the requested area,
• FALSE: when the requested area does not match the area where the network locates the device,
• UNKNOWN: when the network cannot locate the device,
• PARTIAL: when the requested area partially match the area where the network locates the device. A match_rate could be included in the response.