CAS - Coarse Location Support

There are no additional configuration steps required to make the CAS device fall back to reporting coarse location in the absence of GPS/GNSS coverage.

Location Reporting via API

The API request to retrieve the device sensor values (current or history) for a specific sensor “fieldname” is given below.

POST /devices/fields/{fieldname}/actions/history

The above API and its request/response formats are detailed in the page referenced by the following link:

In the retrieve sensor history POST API call listed above, to obtain device location, the “{fieldname}” is replaced with “location” as written below:

POST /devices/fields/location/actions/history


Location Reporting API Example Request Body

Retrieve the most recent location value

POST /api/cc/v1/devices/fields/location/actions/history HTTP/1.1

curl -X POST \ \
-H 'Accept: */*' \
-H 'Accept-Encoding: gzip, deflate' \
-H 'Authorization: Bearer 5ab8627992ad3058f2e625b612f7389b' \
-H 'Cache-Control: no-cache' \
-H 'Connection: keep-alive' \
-H 'Content-Length: 136' \
-H 'Content-Type: application/json' \
-H 'Host:' \
-H 'Postman-Token: 28cb7365-34cc-421c-b17b-0317b2e40f22,2dad15cd-d16d-4f18-bbd4-1a851e017cb2' \
-H 'User-Agent: PostmanRuntime/7.16.3' \
-H 'VZ-M2M-Token: 92995d93-e97a-4955-816d-694edeb3d7a4' \
-H 'cache-control: no-cache' \
-d '{
"accountidentifier": {"billingaccountid": "0642080214-00001"},
"resourceidentifier": {"imei": 864508030155920},
"$limitnumber": 1

Location Reporting API Example Success Responses ##

The Location reporting API can have two types of success responses as listed below, with examples to follow.

  • API response containing precise location based on GPS/GNSS
  • API response containing coarse location based on CellId

Precise Location Response to API based on GPS/GNSS


Coarse Location Response to API based on CellId