nRF Cloud Location Services¶
Cell Location Service¶
You can enable the cell geolocation lookup for single cells and neighboring cell reports for the application using nRF Cloud’s Cell Location Service API in your deployment.
To use the API, set the enableNrfCloudCellLocationService
parameter to true
and set the nrfCloudTeamId
parameter to your team ID when deploying the solution.
az deployment group create \ --resource-group ${RESOURCE_GROUP:-nrfassettracker} \ --mode Complete \ --name enable-unwiredlabs \ --template-file azuredeploy.json \ --parameters \ appName=${APP_NAME:-nrfassettracker} \ storageAccountName=${STORAGE_ACCOUNT_NAME:-nrfassettracker} \ appRegistrationClientId=$APP_REG_CLIENT_ID \ b2cTenant=${B2C_TENANT:-nrfassettrackerusers} \ keyVaultName=${APP_NAME:-nrfassettracker} \ enableNrfCloudCellLocationService=true \ nrfCloudTeamId=*your team ID*
This command enables the geolocateCellFromNrfCloud
function to resolve cells.
Otherwise, this function returns a 402
status on the API route cellgeolocation/nrfcloud
.
Store the service key into the key vault as follows:
# Grant the current user set permission to the key vault secrets USER_OBJECT_ID=`az ad signed-in-user show --query objectId -o tsv` az keyvault set-policy --name ${keyVaultName} --object-id ${USER_OBJECT_ID} --secret-permissions set # Store the API key az keyvault secret set --vault-name ${APP_NAME:-nrfassettracker} \ --name nrfCloudCellLocationServiceKey \ --file location of your Cell Location Service Key file
Assisted GPS Location Service¶
You can enable your devices to request assisted GPS (A-GPS) data using nRF Cloud’s Assisted GPS Location Service API in your deployment.
To use the API, set the enableNrfCloudAGPSLocationService
parameter to true
and set the nrfCloudTeamId
parameter to your team ID when deploying the solution.
az deployment group create \ --resource-group ${RESOURCE_GROUP:-nrfassettracker} \ --mode Complete \ --name enable-unwiredlabs \ --template-file azuredeploy.json \ --parameters \ appName=${APP_NAME:-nrfassettracker} \ storageAccountName=${STORAGE_ACCOUNT_NAME:-nrfassettracker} \ appRegistrationClientId=$APP_REG_CLIENT_ID \ b2cTenant=${B2C_TENANT:-nrfassettrackerusers} \ keyVaultName=${APP_NAME:-nrfassettracker} \ enableNrfCloudAGPSLocationService=true \ nrfCloudTeamId=*your team ID*
This command enables the agpsQueuedDeviceRequestsHandler
function to resolve A-GPS requests from devices using the nRF Cloud Assisted GPS Location Service API.
Store the service key into the key vault as follows:
# Grant the current user set permission to the key vault secrets USER_OBJECT_ID=`az ad signed-in-user show --query objectId -o tsv` az keyvault set-policy --name ${keyVaultName} --object-id ${USER_OBJECT_ID} --secret-permissions set # Store the API key az keyvault secret set --vault-name ${APP_NAME:-nrfassettracker} \ --name nrfCloudAGPSLocationServiceKey \ --file location of your Assisted GPS Location Service Key file
Predicted GPS Location Service¶
You can enable your devices to request predicted GPS (P-GPS) data using nRF Cloud’s Predicted GPS Location Service API in your deployment.
To use the API, set the enableNrfCloudPGPSLocationService
parameter to true
and set the nrfCloudTeamId
parameter to your team ID when deploying the solution.
az deployment group create \ --resource-group ${RESOURCE_GROUP:-nrfassettracker} \ --mode Complete \ --name enable-unwiredlabs \ --template-file azuredeploy.json \ --parameters \ appName=${APP_NAME:-nrfassettracker} \ storageAccountName=${STORAGE_ACCOUNT_NAME:-nrfassettracker} \ appRegistrationClientId=$APP_REG_CLIENT_ID \ b2cTenant=${B2C_TENANT:-nrfassettrackerusers} \ keyVaultName=${APP_NAME:-nrfassettracker} \ enableNrfCloudPGPSLocationService=true \ nrfCloudTeamId=*your team ID*
This command enables the pgpsQueuedDeviceRequestsHandler
function to resolve P-GPS requests from devices using the nRF Cloud Predicted GPS Location Service API.
Store the service key into the key vault as follows:
# Grant the current user set permission to the key vault secrets USER_OBJECT_ID=`az ad signed-in-user show --query objectId -o tsv` az keyvault set-policy --name ${keyVaultName} --object-id ${USER_OBJECT_ID} --secret-permissions set # Store the API key az keyvault secret set --vault-name ${APP_NAME:-nrfassettracker} \ --name nrfCloudPGPSLocationServiceKey \ --file location of your Predicted GPS Location Service Key file