The set command starts a cloud-based location flow.
Syntax:
%NRFCLOUDLOCATION=<method>,<fetch_result>
The set command parameters and their defined values are the following:
- <method>
- Integer, 1–7. Data collection method.
- <fetch_result>
- Integer, 0–1. Specifies whether the modem reports a location result after sending the collected data to nRF Cloud.
When <fetch_result> is 0, a Unsolicited Result Code (URC) is sent with an acknowledgment, such as the following:
%NRFCLOUDLOCATION: ACK RECEIVED
When <fetch_result> is 1, a URC is sent with the location result:
%NRFCLOUDLOCATION: <lat>,<lon>,<unc>,<fulfilled_method>
The response parameters and their defined values are the following:
- <lat>
- Integer. Latitude.
- <lon>
- Integer. Longitude.
- <unc>
- Integer. Uncertainty in meters.
- <fulfilled_method>
- Integer. Method used by the cloud to determine the location.
Note: During a cloud transaction, unsolicited %COAP result codes can be emitted.
Warning:
Multicell and Wi-Fi positioning do not work if the module is in RRC
Connected mode.
The following command example collects single-cell data without sending it to the cloud:
AT%NRFCLOUDLOCATION=1,0
%COAP: RESPONSE,2.05
%NRFCLOUDLOCATION: ACK RECEIVED
OK
The following command example collects single-cell data and requests a location from the cloud:
AT%NRFCLOUDLOCATION=1,1
%COAP: RESPONSE,2.05
%COAP: DATA,HEX,bf01fb404ebf3c5f2bdf8202fb4037c68853f6f81a03186404655343454c4cff
%NRFCLOUDLOCATION: 61.494029,23.775517,100,1
OK
The following command example allows single-cell and multicell positioning. The cloud fulfills the request with multicell positioning:
AT%NRFCLOUDLOCATION=3,1
%COAP: RESPONSE,2.05
%COAP: DATA,HEX,bf01fb404ebf3c5f2bdf8202fb4037c68853f6f81a03186404654d43454c4cff
%NRFCLOUDLOCATION: 61.494029,23.775517,100,2
OK