The get_location call is used retrieve the location of the mobile phone currently using the specified MSISDN.

URL: https://tms.flashmedia.co.za/api/lbs/get_location

HTTP Method: GET

Input Parameters

msisdn

The MSISDN of the mobile subscriber to locate.

locator_msisdn

The MSISDN of the person doing the location lookup. Optional if the caller's LBS service account is configured to allow anonymous lookups.

Data Returned

transaction_id

The ID generated for this lookup transaction.

msisdn

The MSISDN that was located.

latitude

Latitude of the location, in decimal degrees.

longitude

Longitude of the location, in decimal degrees.

distance

The accuracy distance from the latitude/longitude coordinates.

time

The location's date & time in ISO 8601 format (YY-MM-DDTHH:MM:SS).

network_id

The TMS network ID of the located MSISDN's mobile network.

Example API call using cURL

JSON

curl -X GET https://tms.flashmedia.co.za/api/lbs/get_location \
-u 'username:password' -H 'Accept: application/json' \
-d 'msisdn=27820000001' -d 'item_id=1234'

Example Successful Response

{
  "msisdn" : "27821234789",
  "transaction_id" : "78920110722143042336",
  "latitude" : -25.73134,
  "longitude" : 28.21837,
  "distance" : 50,
  "time" : "11-07-22T14:30:31"
  "network_id": 1,
}