Skip to main content
v1 (Current)v2 (Platform v2)
v1 (Current)v2 (Platform v2)
Terms & Abbreviations

Per-device Cell tower Plus

Prerequisites​

Understanding Cell tower Plus Modes​

Terminology

Basic and Plus are the two solver modes for Cell Tower Location. Basic is free. Plus is a paid upgrade (requires Device Location Credits) offering higher accuracy for 3G/4G/LTE-M.

The DEFAULT and CUSTOM configurations described below apply only to the Plus solver mode.

The ADVANCED_CELL_TOWER_LOCATION setting can be in one of the following states:

  • DEFAULT — Cell tower Plus applies uniformly to all devices — cell tower location data is resolved no more frequently than once an hour. This is the initial mode when the feature is first enabled.
  • CUSTOM — You control which devices have their network events processed with the Plus solver, and how frequently (60–1440 minutes). The frequency determines the minimum interval at which network events from a device are picked up for location resolution. All other devices fall back to basic resolution.
Organization modeDevices with frequency setOther devices
DEFAULTAll devices: Plus resolution once per hourAll devices: Plus resolution once per hour
CUSTOMPlus resolution at configured frequencyBasic resolution only (once per hour)
Disabled (no purchased credits)Basic resolution only (once per hour)Basic resolution only (once per hour)
warning

Switching to CUSTOM mode is required before enabling or disabling Cell tower Plus on individual devices. Attempting per-device operations without CUSTOM mode active results in a 403 Forbidden response.

Workflow​

Step 1 – Switch to CUSTOM Mode​

Patch the ADVANCED_CELL_TOWER_LOCATION setting with {"mode": "CUSTOM"} to enable per-device configuration.

Endpoint: PATCH /v1/settings/1nceos/ADVANCED_CELL_TOWER_LOCATION/details

API example

Step 2 – Enable Cell tower Plus for Devices​

Enable Plus resolution for selected devices by providing their ICCIDs and a frequency value.

Endpoint: POST /v1/locate/devices/settings

API example

Step 3 – Query Per-Device Settings​

Retrieve which devices have per-device Cell tower Plus enabled.

Endpoint: GET /v1/inspect/devices/settings/DEVICE_ADL

API example

Step 4 – Disable Cell tower Plus for Devices​

Disable Plus resolution for selected devices.

Endpoint: DELETE /v1/locate/devices/settings

API example

Additional Behavior​

  • New SIMs — When a new SIM is activated in CUSTOM mode, it defaults to basic resolution. You must explicitly enable it via the POST endpoint.
  • Credits exhausted — The system falls back to the Basic resolver. Mode and per-device configurations remain intact, and Plus resolution resumes automatically when credits are replenished.
  • Credit debt — Deducted from the next batch of purchased credits.
  • Switching back to DEFAULT — Not available via the API. Open a support ticket with 1NCE Support. When the switch is performed, all per-device frequency configurations are permanently removed.