location.network.donate

This command is used to assign a location with cellular network parameters to its corresponding latitude/longitude.

TR50 Request


{  
   "cmd":{  
      "command":"location.network.donate",
      "params":{  
      "location":{  
            "latitude":35.081462,
            "longitude":-80.826517
         },
         "cells":[  
            {  
               "mcc":310,
               "mnc":410,
               "lac":9869,
               "cellId":55312
            }
         ]
      }
   }
}

Request Parameters

Table 1.
Name	Type	Required	Description
latitude	Float	Yes	The latitude of the location.
longitude	Float	Yes	The longitude of the location.

Network Parameters


Name	Type	Required	Description
mnc	Integer	Yes	Mobile network code.
mcc	Integer	Yes	Mobile country code.
lac	Integer	See note below.	Location area code.
cellId	Integer		An integer representing the identifier of the Base transceiver station.
rssi	Integer		Received signal strength indicator.
cells	Array		An array of cell objects that contain a lac, cellId, and rssi.
imei	String	Yes	An string representing the unique identifier of the mobile device.
wifi	Array	No	An array of wifi objects.
decodeAddress	Boolean	No	The flag requesting the address. Defaults to false.

Note:

The parameter cells or a combination of lac, cellId, and rssi are required. If cells is used, any lac, cellId or rssi that are not included in the cells parameter are ignored.

TR50 Response

If the command is sent successfully a success message and params list are returned. Otherwise, an error and error message are returned.

{
  "cmd": {
    "success": true
  }
}