Permalink
Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
98 lines (79 sloc) 2.86 KB

Introduction

The authorized caller is able to query Location of a mobile device.

URL format

https://{serverRoot}/ericsson/oneapi/location/1/queries/location?address={address}&requestedAccuracy={metres}

HTTP request

Parameter Description Mandatory or Optional

address

The MSISDN in tel URI(RFC3966) format of the mobile device to locate. At least one address must be provided. Repeat the address parameter for multiple devices.

"tel:" scheme and "+" identifier must be used for address, and must be URL-escaped.

In the above example, the recipients MSISDN is in tel URI(RFC3966) format. %3A represents ":" and %2B represents "+". Thus tel%3A%2B4605010759 represents tel:+4605010759.

Mandatory

requestedAccuracy

It is the preferred accuracy of the result, in metres. Generally, it takes longer time to retrieve an accurate location than a coarse location

Mandatory

HTTP respnose code

HTTP status code Description Note

200

Successful

500

Internal server error

400

The syntax of the request is not correct.

Example Request GET: http://52.28.33.220/ericsson/oneapi/location/1/queries/location?requestedAccuracy=1000&address=tel%3A%2B16035558278

Respnose: { "terminalLocationList": { "terminalLocation": [ { "address": "tel:+16035558278", "locationRetrievalStatus": "Retrieved", "errorInformation": null, "currentLocation": { "timestamp": "2015-05-26T09:19:43Z", "altitude": 75, "longitude": 2.1833333, "latitude": 41.3833333, "accuracy": 1000 } } ] } }