location.network.decode

The location.network.decode command is used to decode a location by network.

TR50 Request

{
  "cmd": {
    "command": "location.network.decode",
    "params": {
      "mnc": 119,
      "mcc": 310,
      "lac": 48,
      "cellId": 4217,
      "rssi": -80,
      "imei": "357805023984942",
      "decodeAddress": true
    }
  }

{ 
   "cmd":{ 
      "command":"location.network.decode",
      "params":{ 
         "mnc":260,
         "mcc":310,
         "imei":"351579057358754",
         "cells":[ 
            { 
               "cellId":36352,
               "lac":34775,
               "rssi":-94
            },
            { 
               "cellId":44473,
               "lac":51051,
               "rssi":-70
            }
         ],
         "decodeAddress":false
      }
   }
}

Request Parameters

Name

Type

Required

Description

mnc

Integer

Yes

An integer representing the mobile country code.

mcc

Integer

Yes

An integer representing the mobile network code.

lac

Integer

See note below.

An integer representing the code of the location area.

cellId

Integer

An integer representing the identifier of the base transceiver station.

rssi

Integer

An integer representing the received signal strength.

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.

decodeAddress

Boolean

No

I 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,
    "params": {
      "lat": 42.47,
      "lng": -73.24,
      "fixAcc": 10525,
      "fixType": "Coarse",
      "address": {
        "streetNumber": "1145",
        "street": "Buckingham Dr",
        "city": "Tallahassee",
        "state": "FL",
        "zipCode": "32308",
        "country": "US"
      }
    }
  }
}

Response Parameters

Name

Type

Description

lat

Float

The latitude of the location.

lng

Float

The longitude of the location.

fixAcc

Float

The accuracy in meters of the location.

fixType

String

A string describing the source of the location information, for example, gps, gnss, or manual.

address.streetNumber

String

The street number of the address.

address.street

String

The route of the address.

address.city

String

The city name of the address.

address.state

String

The state code of the address.

address.zipCode

String

The zip code of the address.

address.country

String

The country code of the address.