GeolocationRequest

Cells

Cell tower objects, supported radio types and the parameters accepted for each.

Each cells object contains information about a single Cell Tower.

  • If you choose to include cells in your request, you can send 1 to 7 cell ID objects. If your device supports scanning for more than 7 cell objects, reach out to us and we'll increase this limit on your account. If more than the allowed limit are sent, only the first 7 cells will be considered.
  • The first cell object has to be that of the serving cell, i.e. the tower the device is connected to. The others are neighbouring cell objects that are visible to the device.
  • cid should be included on every cell object - without it, that cell is dropped from the request. Always include radio too - cid and lac are interpreted differently per radio type, so an omitted or incorrect radio can lead to a misread cell, especially for newer radio types like LTE and NR whose cid ranges overlap with others. All other parameters mentioned below are optional or recommended, as noted in the tables below.
  • Parameters vary depending on the radio type. Supported radio types and their corresponding parameters are:

GSM - GSM, EDGE, GPRS, 2G

ParameterDescriptionTypeAcceptedRequired
lacthe Location Area Code of your operator's network.integer0 - 65533no
cidCell IDinteger0 - 65535yes
radioRadio type of the devicestringgsmrecommended
mccMobile Country Code of your operator's network.integer0 - 999yes
mncMobile Network Code of your operator's network.integer0 - 999yes
signalSignal Strength (RSSI)integer-113 - -51recommended
asuArbitrary Strength Unitinteger0 - 31no
taTiming Advanceinteger0 - 63no
timestampThe time this Cell data was scanned, measured in milliseconds since the UNIX epochintegerno

CDMA - 1xRTT, CDMA, eHRPD, EVDO_0, EVDO_A, EVDO_B, IS95A, IS95B

ParameterDescriptionTypeAcceptedRequired
lacNetwork ID (NID).integer0 - 65534no
cidBase ID / Station IDinteger0 - 65535yes
radioRadio type of the devicestringcdmarecommended
mccMobile Country Code of your operator's networkinteger0 - 999yes
mncSystem ID (SID)integer1 - 32767yes
signalSignal Strength of the radio, measured in dBminteger-100 - -75recommended
asuArbitrary Strength Unit measured by the mobile phoneinteger1 - 16no
timestampThe time this Cell data was scanned, measured in milliseconds since the UNIX epochintegerno

UMTS - UMTS, HSPA, HSDPA, HSPA+, HSUPA, WCDMA, 3G

ParameterDescriptionTypeAcceptedRequired
lacLocation Area Code of your operator's network.integer0 - 65533no
cidCell IDinteger0 - 268435455yes
radioRadio type of the devicestringumtsrecommended
mccMobile Country Code of your operator's network.integer0 - 999yes
mncMobile Network Code of your operator's network.integer0 - 999yes
signalSignal Strength (RSCP) of your operator's network.integer-121 - -25recommended
pscPrimary Scrambling Codeinteger0 - 511recommended
asuArbitrary Strength Unit measured by the mobile phoneinteger-5 - 91no
timestampThe time this Cell data was scanned, measured in milliseconds since the UNIX epochintegerno

LTE - LTE, 4G, CAT-M

ParameterDescriptionTypeAcceptedRequired
lacTracking Area Code of your operator's network.integer0 - 65533no
cidCell IDinteger0 - 268435455yes
radioRadio type of the devicestringlterecommended
mccMobile Country Code of your operator's network.integer0 - 999yes
mncMobile Network Code of your operator's network.integer0 - 999yes
signalSignal Strength (RSRP) of the radio, measured in dBminteger-137 - -45recommended
pscPhysical Cell ID on LTEinteger0 - 503recommended
asuArbitrary Strength Unit measured by the mobile phoneinteger0 - 97no
taTiming Advanceinteger0 - 63no
timestampThe time this Cell data was scanned, measured in milliseconds since the UNIX epochintegerno

NB-IoT (Private Beta)

ParameterDescriptionTypeAcceptedRequired
lacTracking Area Code of your operator's network.integer0 - 65533no
cidCell IDinteger0 - 268435455yes
radioRadio type of the devicestringnbiotrecommended
mccMobile Country Code of your operator's network.integer0 - 999yes
mncMobile Network Code of your operator's network.integer0 - 999yes
signalSignal Strength (RSRP) of the radio, measured in dBm. Currently not considered at the moment.integer-137 - -45no
pscEquivalent to PCI in LTE. Some devices may report this as NCID or NB-IoT local Cell ID.integer0 - 503recommended
timestampThe time this Cell data was scanned, measured in milliseconds since the UNIX epochintegerno

New Radio - NR, 5G (Public BETA)

ParameterDescriptionTypeAcceptedRequired
lacTracking Area Code or TAC of your operator's network.integer0 - 16777215no
cidCell IDinteger0 - 68719476735yes
radioRadio type of the devicestringnrrecommended
mccMobile Country Code of your operator's network.integer0 - 999yes
mncMobile Network Code of your operator's network.integer0 - 999yes
signalSignal Strength (RSRP) of the radio, measured in dBm.integer-140 - -44no
pscPhysical Cell ID or PCI.integer0 - 1007recommended
asuArbitrary Strength Unit measured by the mobile phoneinteger0 - 97no
timestampThe time this Cell data was scanned, measured in milliseconds since the UNIX epochintegerno