AWS iot: Add multi-frame GNSS measurement type to Device Location docs
Summary
Documents the new multi-frame GNSS measurement type and solver, notes GNSS and multi-frame GNSS are mutually exclusive in a single request, and updates the measurement data list.
Security assessment
The change only adds a new location measurement type and clarifies mutual exclusivity of GNSS request types; it has no authentication, encryption, or exposure implications.
Evidence
+Multi-frame GNSS scan data (multiple NAV messages from the same device) | Multi-frame GNSS solver | General IoT devices
Diff
diff --git a/iot/latest/developerguide/device-location.md b/iot/latest/developerguide/device-location.md index ac8652921..a8580a93a 100644 --- a//iot/latest/developerguide/device-location.md +++ b//iot/latest/developerguide/device-location.md @@ -43 +43 @@ AWS IoT Core Device Location partners with third-party vendors to resolve the me -General IoT devices and Sidewalk devices can use the device location MQTT topics to obtain the location information. For Wi-Fi, Cellular, and IP address measurement types, if the devices publish the measurement data to the [reserved topics](./device-location-reserved-topics.html) in the defined GeoJSON format, AWS IoT Core Device Location can resolve the location of the device. For GNSS measurement type, the device must have the LR11xx chip to scan the measurement data for obtaining the resolved location information using the GNSS solver. For information about obtaining location information for LoRaWAN devices, see [Configuring position for LoRaWAN resources](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/lorawan-configure-location.html) in the _AWS IoT Wireless documentation_. +General IoT devices and Sidewalk devices can use the device location MQTT topics to obtain the location information. For Wi-Fi, Cellular, and IP address measurement types, if the devices publish the measurement data to the [reserved topics](./device-location-reserved-topics.html) in the defined GeoJSON format, AWS IoT Core Device Location can resolve the location of the device. For GNSS and multi-frame GNSS measurement types, the device must have the LR11xx chip to scan the measurement data for obtaining the resolved location information using the GNSS or multi-frame GNSS solver. For information about obtaining location information for LoRaWAN devices, see [Configuring position for LoRaWAN resources](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/lorawan-configure-location.html) in the _AWS IoT Wireless documentation_. @@ -50,0 +51 @@ GNSS scan data (NAV messages) | GNSS solver | General IoT devices, LoRaWAN, and +Multi-frame GNSS scan data (multiple NAV messages from the same device) | Multi-frame GNSS solver | General IoT devices @@ -52,0 +54,4 @@ Bluetooth Low Energy (BLE) | BLE based solver | Amazon Sidewalk devices +###### Note + +The GNSS and multi-frame GNSS measurement types are mutually exclusive. A single request can use the `Gnss` measurement type to resolve the location from a single NAV message capture, or the `GnssMultiFrame` measurement type to resolve the location from multiple NAV message captures from the same device, but it can't contain both in the same request. + @@ -69 +74 @@ The raw measurement data related to your device location is first sent from the -The measurement data is processed, and AWS IoT Core Device Location chooses the measurement data to be used, which can be Wi-Fi, cellular, GNSS scan, or IP address information. +The measurement data is processed, and AWS IoT Core Device Location chooses the measurement data to be used, which can be Wi-Fi, cellular, GNSS scan, multi-frame GNSS scan, or IP address information.