NRnrfcloud
GNSS

RecordGnssCoordinates

<div class="nrf-note"> <p><b>Cloud-to-cloud — authorize with an Organization Auth Token.</b><br><code>https://api.location.nrfcloud.com/v1/organizations/{organizationSlug}/projects/{projectSlug}/location/gnss</code></p> <p><b>Device-to-cloud — authorize with a JSON Web Token.</b><br><code>https://api.location.nrfcloud.com/v1/location/gnss</code></p> </div>

Report device coordinates, commonly obtained from the device's GNSS modem.

Basic Request:

curl --location --request POST "$API_HOST/v1/location/gnss" \
--header "Authorization: Bearer $JWT" \
--header "Content-Type: application/json" \
--data-raw "{\"lat\":$LAT, \"lon\":$LON, \"spd\":$SPD, \"acc\":$ACC, \"alt\":$ALT, \"hdg\":$HDG}"
post/location/gnss

Request

Headers

x-custom-device-idstring

User-defined device ID, used to identify requests when using a cloud-to-cloud integration. Ignored if using a device token.

Example:my-device-12345

Request body

OR
string required

NMEA 0183 GNSS sentence. See <a href="https://www.nmea.org/nmea-0183.html" target="_blank">this page</a> for more details.

Example request

{
  "lat": 45.524098,
  "lon": -122.688408,
  "acc": 15,
  "alt": 159,
  "spd": 1,
  "hdg": 90
}

Changes

No recorded changes to this operation across all 7 revisions of this API.