Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # AWS IoT Core Standort des Geräts | | | --- | | Bevor Sie die Funktion „ AWS IoT Core Gerätestandort“ verwenden, lesen Sie sich die Nutzungsbedingungen für diese Funktion durch. Beachten Sie, dass AWS möglicherweise die Parameter Ihrer Geolokalisierungs-Suchanfrage, wie z. B. die für die Durchführung von Suchanfragen verwendeten Standortdaten, und andere Informationen an den von Ihnen ausgewählten Drittanbieter übertragen werden, der möglicherweise nicht dem entspricht AWS-Region , den Sie derzeit verwenden. Der Drittanbieter und der zu verwendende Solver werden auf der Grundlage der empfangenen Eingabe-Payload ausgewählt. Weitere Informationen finden Sie unter [AWS -Servicebedingungen](https://aws.amazon.com/service-terms). | Verwenden Sie AWS IoT Core Device Location, um den Standort Ihrer IoT-Geräte mithilfe von Solvern von Drittanbietern zu testen. *Solver* sind von Drittanbietern bereitgestellte Algorithmen, die Messungsdaten auflösen und den Standort Ihres Geräts schätzen. Indem Sie den Standort Ihrer Geräte ermitteln, können Sie sie vor Ort verfolgen und debuggen, um etwaige Probleme zu beheben. Die aus verschiedenen Quellen gesammelten Messungsdaten werden aufgelöst, und die Geolokalisierungsinformationen werden als [GeoJSON](https://geojson.org/)-Nutzlast gemeldet. Das GeoJSON-Format ist ein Format, das zur Codierung geografischer Datenstrukturen verwendet wird. Die Payload enthält die Breiten- und Längengradkoordinaten Ihres Gerätestandorts, die auf dem [Koordinatensystem des World Geodetic Systems](https://gisgeography.com/wgs84-world-geodetic-system/) () basieren. WGS84 **Topics** + [Messungstypen und Solver](#location-measurement-types) + [So funktioniert der AWS IoT Core Gerätestandort](#location-how-works) + [Wie benutzt man den Gerätestandort AWS IoT Core](#location-how-use) + [Auflösen des Standorts von IoT-Geräten](device-location-resolve-solvers.md) + [Auflösen des Gerätestandorts mithilfe der AWS IoT Core MQTT-Themen zum Gerätestandort](device-location-reserved-topics.md) + [Location Solver und Geräte-Payload](device-location-solvers-payload.md) ## Messungstypen und Solver AWS IoT Core Device Location arbeitet mit Drittanbietern zusammen, um die Messdaten aufzulösen und einen geschätzten Gerätestandort zu ermitteln. In der folgenden Tabelle sind die Messungstypen und die Location Solver von Drittanbietern sowie Informationen zu unterstützten Geräten aufgeführt. Informationen zu LoRa WAN-Geräten und zur Konfiguration des Gerätestandorts für diese Geräte finden Sie unter [Konfiguration der Position von LoRa WAN-Ressourcen](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/lorawan-configure-location.html). **Anmerkung** Allgemeine IoT-Geräte und Sidewalk-Geräte können die MQTT-Themen zum Gerätestandort verwenden, um die Standortinformationen abzurufen. Bei den Messarten WLAN, Mobilfunk und IP-Adresse kann AWS IoT Core Device Location den Standort des Geräts ermitteln, wenn die Geräte die Messdaten zu den [reservierten Themen](device-location-reserved-topics.md) im definierten GeoJSON-Format veröffentlichen. Für den GNSS-Messtyp muss das Gerät über einen LR11xx Chip verfügen, der die Messdaten scannt, um die aufgelösten Ortsinformationen mithilfe des GNSS-Solvers zu erhalten. *Informationen zum Abrufen von Standortinformationen für LoRa WAN-Geräte finden Sie unter [Konfiguration der Position für LoRa WAN-Ressourcen](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/lorawan-configure-location.html) in der AWS IoT Wireless-Dokumentation.* **Messungstypen und Solver** | Messungstyp | Solver von Drittanbietern | Unterstützte Geräte | | --- | --- | --- | | WLAN-Zugangspunkte | WLAN-basierter Solver | Allgemeine IoT-Geräte, LoRa WAN und Amazon Sidewalk-Geräte | | Mobilfunkmasten: GSM-, LTE-, CDMA-, SCDMA-, WCMDA- und TD-SCDMA-Daten | Solver auf Mobilfunkbasis | Allgemeine IoT-Geräte, LoRa WAN und Amazon Sidewalk-Geräte | | IP-Adresse | IP-Reverse-Lookup-Solver | Jedes IoT-Gerät, das eine Verbindung über TCP/IP herstellt | | GNSS-Scandaten (NAV-Nachrichten) | GNSS-Solver | Allgemeine IoT-Geräte, LoRa WAN und Amazon Sidewalk-Geräte | | Bluetooth Low Energy (BLE) | BLE-basierter Solver | Amazon-Sidewalk-Geräte | Weitere Informationen zu den Location Solvern und Beispiele, welche die Gerätenutzlast für die verschiedenen Messungstypen zeigen, finden Sie unter [Location Solver und Geräte-Payload](device-location-solvers-payload.md). ## So funktioniert der AWS IoT Core Gerätestandort Das folgende Diagramm zeigt, wie AWS IoT Core Device Location Messdaten sammelt und die Standortinformationen Ihrer Geräte auflöst. ![\[Das Bild zeigt, wie der AWS IoT Core Gerätestandort Ihre Rohmessdaten verwendet und den Gerätestandort auflöst.\]](http://docs.aws.amazon.com/de_de/iot/latest/developerguide/images/iot-device-location.png) Die folgenden Schritte zeigen, wie der AWS IoT Core Gerätestandort funktioniert. 1. **Empfangen von Messungsdaten** Die Rohmessungsdaten, die sich auf Ihren Gerätestandort beziehen, werden zuerst vom Gerät gesendet. Die Messungsdaten werden als JSON-Nutzlast angegeben. 1. **Prozessmessungsdaten** Die Messdaten werden verarbeitet, und AWS IoT Core Device Location wählt die zu verwendenden Messdaten aus. Dabei kann es sich um WLAN-, Mobilfunk-, GNSS-Scan- oder IP-Adressinformationen handeln. 1. **Auswählen des Solver** Der Solver eines Drittanbieters wird auf der Grundlage der Messungsdaten ausgewählt. Wenn die Messungsdaten beispielsweise WLAN- und IP-Adressinformationen enthalten, werden der WLAN-Solver und der IP-Reverse-Lookup-Solver ausgewählt. 1. **Abrufen des gelösten Standorts** Eine API-Anfrage wird an die Solver-Anbieter gesendet, mit der Bitte, den Standort zu ermitteln. AWS IoT Core Der Gerätestandort ruft dann die geschätzten Geolokalisierungsinformationen von den Solvern ab. 1. **Auswählen des aufgelösten Standort** Die aufgelösten Standortinformationen und ihre Genauigkeit werden verglichen, und der AWS IoT Core Gerätestandort wählt die Geolokalisierungsergebnisse mit der höchsten Genauigkeit aus. 1. **Ausgabe der Standortinformationen** Die Geolokalisierungsinformationen werden Ihnen als GeoJSON-Nutzlast gesendet. Die Payload enthält die WGS84 Geokoordinaten, die Genauigkeitsinformationen, die Konfidenzniveaus und den Zeitstempel, zu dem der aufgelöste Standort ermittelt wurde. ## Wie benutzt man den Gerätestandort AWS IoT Core Die folgenden Schritte zeigen, wie Sie den AWS IoT Core Gerätestandort verwenden. 1. **Bereitstellen von Messungsdaten** Geben Sie die Rohmessungsdaten, die sich auf den Standort Ihres Geräts beziehen, als JSON-Nutzlast an. Um die Nutzlast-Messdaten abzurufen, gehen Sie zu Ihren Geräteprotokollen oder verwenden Sie CloudWatch Protokolle und kopieren Sie die Nutzdateninformationen. Die JSON-Nutzlast muss mindestens eine Art von Messungsdaten enthalten. Beispiele, in denen das Nutzlastformat für verschiedene Solver gezeigt werden, finden Sie unter [Location Solver und Geräte-Payload](device-location-solvers-payload.md). 1. **Auflösen von Standortinformationen** Übergeben Sie mithilfe der Seite „[Gerätestandort](https://console.aws.amazon.com/iot/home#/device-location-test)“ in der AWS IoT Konsole oder im [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API-Vorgang die Payload-Messdaten und ermitteln Sie den Gerätestandort. AWS IoT Core Der Gerätestandort wählt dann den Solver mit der höchsten Genauigkeit aus und meldet den Gerätestandort. Weitere Informationen finden Sie unter [Auflösen des Standorts von IoT-Geräten](device-location-resolve-solvers.md). 1. **Kopieren von Standortinformationen** Überprüfen Sie die Geolokalisierungsinformationen, die durch AWS IoT Core Device Location aufgelöst und als GeoJSON-Payload gemeldet wurden. Sie können die Payload kopieren, um sie mit Ihren Anwendungen und anderen zu verwenden. AWS-Service Beispielsweise können Sie Ihre geografischen Standortdaten mithilfe der [Speicherort](location-rule-action.md) AWS IoT Regelaktion an Amazon Location Service senden. In den folgenden Themen wird die Verwendung von AWS IoT Core Device Location und Beispiele für Payloads zum Gerätestandort beschrieben. + [Auflösen des Standorts von IoT-Geräten](device-location-resolve-solvers.md) + [Location Solver und Geräte-Payload](device-location-solvers-payload.md) # Auflösen des Standorts von IoT-Geräten Verwenden Sie den AWS IoT Core Gerätestandort, um die Messdaten Ihrer Geräte zu dekodieren und den Gerätestandort mithilfe von Solvern von Drittanbietern zu ermitteln. Der aufgelöste Standort wird als GeoJSON-Nutzlast mit Geokoordinaten und Genauigkeitsinformationen generiert. Sie können den Standort Ihres Geräts über die AWS IoT Konsole, die AWS IoT Wireless-API oder ermitteln. AWS CLI **Topics** + [Auflösen des Gerätestandorts (Konsole)](#location-resolve-console) + [Auflösen des Gerätestandorts (API)](#location-resolve-api) + [Fehlerbehebung beim Auflösen des Standorts](#location-resolve-troubleshoot) ## Auflösen des Gerätestandorts (Konsole) So lösen Sie den Gerätestandort auf (Konsole) 1. Rufen Sie in der AWS IoT Konsole die Seite [Gerätestandort](https://console.aws.amazon.com/iot/home#/device-location-test) auf. 1. Rufen Sie die Nutzlast-Messdaten aus Ihren Geräteprotokollen oder aus den CloudWatch Protokollen ab und geben Sie sie im Abschnitt **Position über Payload auflösen** ein. Der folgende Code zeigt ein Beispiel für eine JSON-Nutzlast. Die Nutzlast enthält Mobilfunk- und WLAN-Messungsdaten. Wenn Ihre Nutzlast zusätzliche Arten von Messungsdaten enthält, wird der Solver mit der besten Genauigkeit verwendet. Weitere Informationen und Beispiele zur Nutzlast finden Sie unter [Location Solver und Geräte-Payload](device-location-solvers-payload.md). **Anmerkung** Die JSON-Nutzlast muss mindestens eine Art von Messungsdaten enthalten. ``` { "Timestamp": 1664313161, "Ip":{ "IpAddress": "54.240.198.35" }, "WiFiAccessPoints": [{ "MacAddress": "A0:EC:F9:1E:32:C1", "Rss": -77 }], "CellTowers": { "Gsm": [{ "Mcc": 262, "Mnc": 1, "Lac": 5126, "GeranCid": 16504, "GsmLocalId": { "Bsic": 6, "Bcch": 82 }, "GsmTimingAdvance": 1, "RxLevel": -110, "GsmNmr": [{ "Bsic": 7, "Bcch": 85, "RxLevel": -100, "GlobalIdentity": { "Lac": 1, "GeranCid": 1 } }] }], "Wcdma": [{ "Mcc": 262, "Mnc": 7, "Lac": 65535, "UtranCid": 14674663, "WcdmaNmr": [{ "Uarfcndl": 10786, "UtranCid": 14674663, "Psc": 149 }, { "Uarfcndl": 10762, "UtranCid": 14674663, "Psc": 211 } ] }], "Lte": [{ "Mcc": 262, "Mnc": 2, "EutranCid": 2898945, "Rsrp": -50, "Rsrq": -5, "LteNmr": [{ "Earfcn": 6300, "Pci": 237, "Rsrp": -60, "Rsrq": -6, "EutranCid": 2898945 }, { "Earfcn": 6300, "Pci": 442, "Rsrp": -70, "Rsrq": -7, "EutranCid": 2898945 } ] }] } } ``` 1. Um die Standortinformationen aufzulösen, wählen Sie **Auflösen** aus. Die Standortinformationen sind vom Typ BLOB und werden als Nutzlast zurückgegeben, die das GeoJSON-Format verwendet. Dieses Format wird für die Kodierung geografischer Datenstrukturen verwendet. Die Nutzlast enthält Folgendes: + Die WGS84 Geokoordinaten, die die Breiten- und Längengradinformationen enthalten. Sie kann auch eine Höheninformation enthalten. + Den Typ der gemeldeten Standortinformationen, z. B. **Punkt**. Ein Punktpositionstyp stellt die Position als WGS84 Breitengrad und Längengrad dar, kodiert als [GeoJSON-Punkt](https://geojson.org/geojson-spec.html#point). + Die horizontalen und vertikalen Genauigkeitsinformationen, die den Unterschied in Metern zwischen den von den Solvern geschätzten Standortinformationen und dem tatsächlichen Gerätestandort angeben. + Den Zuverlässigkeitsgrad, der die Unsicherheit in der bereitgestellten Standortschätzung angibt. Der Standardwert ist 0,68, was auf eine Wahrscheinlichkeit von 68 % hinweist, dass der tatsächliche Gerätestandort innerhalb des Unsicherheitsradius des geschätzten Standorts liegt. + Die Stadt, das Bundesland, das Land und die Postleitzahl, in der sich das Gerät befindet. Diese Informationen werden nur gemeldet, wenn der IP-Reverse-Lookup-Solver verwendet wird. + Die Informationen zum Zeitstempel, die dem Datum und der Uhrzeit entspricht, an denen der Standort aufgelöst wurde. Es wird das UNIX-Zeitstempelformat verwendet. Der folgende Code zeigt ein Beispiel für eine GeoJSON-Nutzlast, die bei der Auflösung des Standorts zurückgegeben wurde. **Anmerkung** Wenn AWS IoT Core Device Location beim Versuch, den Standort zu ermitteln, Fehler meldet, können Sie die Fehler beheben und den Standort ermitteln. Weitere Informationen finden Sie unter [Fehlerbehebung beim Auflösen des Standorts](#location-resolve-troubleshoot). ``` { "coordinates": [ 13.376076698303223, 52.51823043823242 ], "type": "Point", "properties": { "verticalAccuracy": 45, "verticalConfidenceLevel": 0.68, "horizontalAccuracy": 303, "horizontalConfidenceLevel": 0.68, "country": "USA", "state": "CA", "city": "Sunnyvalue", "postalCode": "91234", "timestamp": "2022-11-18T12:23:58.189Z" } } ``` 1. Gehen Sie zum Abschnitt **Ressourcenstandort** und überprüfen Sie die vom AWS IoT Core Gerätestandort gemeldeten Geolokalisierungsinformationen. Sie können die Payload kopieren, um sie mit anderen Anwendungen und Apps zu verwenden. AWS-Service Beispielsweise können Sie Ihre geografischen Standortdaten mithilfe der [Speicherort](location-rule-action.md)-Regelaktion an Amazon Location Service senden. ## Auflösen des Gerätestandorts (API) Verwenden Sie den API-Vorgang oder den [get-position-estimate](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-position-estimate.html)CLI-Befehl, um den Gerätestandort mithilfe der AWS IoT [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)Wireless-API aufzulösen. Geben Sie die Nutzlast-Messungsdaten als Eingabe an und führen Sie die API-Operation aus, um den Gerätestandort aufzulösen. **Anmerkung** Die API-Operation `GetPositionEstimate` speichert keine Geräte- oder Statusinformationen und kann nicht zum Abrufen historischer Standortdaten verwendet werden. Er führt eine einmalige Operation durch, bei der die Messungsdaten aufgelöst und der geschätzte Standort erstellt werden. Um die Standortinformationen abzurufen, müssen Sie die Daten zur Nutzlast jedes Mal angeben, wenn Sie diese API-Operation ausführen. Der folgende Befehl zeigt ein Beispiel für die Auflösung des Standorts mithilfe dieser API-Operation. **Anmerkung** Wenn Sie den CLI-Befehl `get-position-estimate` ausführen, müssen Sie die JSON-Ausgabedatei als erste Eingabe angeben. Diese JSON-Datei speichert die geschätzten Standortinformationen, die als Antwort von der CLI erhalten wurden, im GeoJSON-Format. Der folgende Befehl speichert beispielsweise die Standortinformationen in der *locationout.json* Datei. ``` aws iotwireless get-position-estimate locationout.json \ --ip IpAddress=""54.240.198.35"" \ --wi-fi-access-points \ MacAddress="A0:EC:F9:1E:32:C1",Rss=-75 \ MacAddress="A0:EC:F9:15:72:5E",Rss=-67 ``` Dieses Beispiel umfasst sowohl Wi-Fi-Zugangspunkte als auch IP-Adressen als Messtypen. AWS IoT Core Der Gerätestandort wählt zwischen dem Wi-Fi-Solver und dem IP-Reverse-Lookup-Solver und wählt den Solver mit der höheren Genauigkeit aus. Der aufgelöste Standort wird als Nutzlast zurückgegeben, die das GeoJSON-Format verwendet. Dieses Format wird für die Kodierung geografischer Datenstrukturen verwendet. Es wird dann in der Datei gespeichert. *locationout.json* Die Payload enthält die WGS84 Breiten- und Längengradkoordinaten, Informationen zur Genauigkeit und zum Konfidenzniveau, den Ortsdatentyp und den Zeitstempel, zu dem der Standort ermittelt wurde. ``` { "coordinates": [ 13.37704086303711, 52.51865005493164 ], "type": "Point", "properties": { "verticalAccuracy": 707, "verticalConfidenceLevel": 0.68, "horizontalAccuracy": 389, "horizontalConfidenceLevel": 0.68, "country": "USA", "state": "CA", "city": "Sunnyvalue", "postalCode": "91234", "timestamp": "2022-11-18T14:03:57.391Z" } } ``` ## Fehlerbehebung beim Auflösen des Standorts Wenn Sie versuchen, den Standort zu ermitteln, wird möglicherweise einer der folgenden Fehlercodes angezeigt. AWS IoT Core Der Gerätestandort generiert möglicherweise einen Fehler, wenn Sie den `GetPositionEstimate` API-Vorgang verwenden, oder es wird auf die Zeilennummer verwiesen, die dem Fehler in der AWS IoT Konsole entspricht. + **400-Fehler** Dieser Fehler weist darauf hin, dass das Format der Geräte-Payload-JSON nicht anhand des AWS IoT Core Gerätestandorts überprüft werden kann. Der Fehler kann aus folgenden Gründen auftreten: + Die JSON-Messungsdaten sind falsch formatiert. + Die Nutzlast enthält nur die Informationen zum Zeitstempel. + Die Messungsdatenparameter, wie z. B. die IP-Adresse, sind ungültig. Um diesen Fehler zu beheben, überprüfen Sie, ob Ihre JSON-Datei korrekt formatiert ist und Daten von mindestens einem Messungstyp als Eingabe enthält. Wenn die IP-Adresse ungültig ist, finden Sie Informationen darüber, wie Sie eine gültige IP-Adresse zur Behebung des Fehlers angeben können, unter [IP-Reverse-Lookup-Solver](device-location-solvers-payload.md#location-solvers-ip). + **403-Fehler** Dieser Fehler weist darauf hin, dass Sie nicht über die erforderlichen Berechtigungen verfügen, um den API-Vorgang auszuführen oder die AWS IoT Konsole zum Abrufen des Gerätestandorts zu verwenden. Um diesen Fehler zu beheben, stellen Sie sicher, dass Sie über die erforderlichen Berechtigungen verfügen, um diese Aktion auszuführen. Dieser Fehler kann auftreten, wenn Ihre AWS-Managementkonsole Sitzung oder Ihr AWS CLI Sitzungstoken abgelaufen sind. Um diesen Fehler zu beheben, aktualisieren Sie das Sitzungstoken, um das zu verwenden AWS CLI, oder melden Sie sich ab AWS-Managementkonsole und melden Sie sich dann mit Ihren Anmeldeinformationen an. + **404-Fehler** Dieser Fehler weist darauf hin, dass keine Standortinformationen gefunden oder anhand AWS IoT Core des Gerätestandorts behoben wurden. Der Fehler kann beispielsweise aufgrund unzureichender Daten in der Eingabe von Messungsdaten auftreten. Beispiel: + Die Informationen zur MAC-Adresse oder zum Mobilfunkmast reichen nicht aus. + Die IP-Adresse ist nicht verfügbar, um den Standort zu suchen und abzurufen. + Die GNSS-Nutzlast ist nicht ausreichend. Um den Fehler in solchen Fällen zu beheben, überprüfen Sie, ob Ihre Messungsdaten ausreichende Informationen enthalten, um den Gerätestandort zu ermitteln. + **500-Fehler** Dieser Fehler weist darauf hin, dass eine interne Serverausnahme aufgetreten ist, als AWS IoT Core  Device Location versucht hat, den Standort aufzulösen. Um diesen Fehler zu beheben, aktualisieren Sie die Sitzung und versuchen Sie erneut, die zu lösenden Messungsdaten zu senden. # Auflösen des Gerätestandorts mithilfe der AWS IoT Core MQTT-Themen zum Gerätestandort Sie können reservierte MQTT-Themen verwenden, um mit der AWS IoT Core Gerätestandortfunktion die neuesten Standortinformationen für Ihre Geräte abzurufen. ## MQTT-Themen zum Format des Gerätestandorts Für reservierte Themen für den AWS IoT Core Gerätestandort wird das folgende Präfix verwendet: `$aws/device_location/{customer_device_id}/` Um ein vollständiges Thema zu erstellen, ersetzen Sie zunächst `customer_device_id` durch Ihre eindeutige ID, mit der Sie Ihr Gerät identifizieren. Wir empfehlen, dass Sie das angeben`WirelessDeviceId`, z. B. für LoRa WAN- und Sidewalk-Geräte, und`thingName`, ob Ihr Gerät als AWS IoT Ding registriert ist. Anschließend fügen Sie das Thema mit dem Themenbereich hinzu, z. B. `get_position_estimate` oder `get_position_estimate/accepted`, wie im folgenden Abschnitt gezeigt. **Anmerkung** `{customer_device_id}` darf nur Buchstaben, Zahlen und Bindestriche enthalten. Wenn Sie Themen zum Gerätestandort abonnieren, können Sie nur das Pluszeichen (\$1) als Platzhalterzeichen verwenden. Sie können beispielsweise den Platzhalter `+` für `{customer_device_id}` verwenden, um die Standortinformationen für Ihre Geräte abzurufen. Wenn Sie das Thema `$aws/device_location/+/get_position_estimate/accepted` abonnieren, wird eine Nachricht mit den Standortinformationen für Geräte veröffentlicht, die mit einer beliebigen Geräte-ID übereinstimmen, sofern das Problem erfolgreich gelöst wurde. Im Folgenden finden Sie die reservierten Themen, die für die Interaktion mit AWS IoT Core Device Location verwendet werden. **MQTT-Themen zum Gerätestandort** | Thema | Zulässige Operationen | Description | | --- | --- | --- | | \$1aws/device\$1location/ /get\$1position\$1estimate *customer\$1device\$1id* | Veröffentlichen | Ein Gerät veröffentlicht zu diesem Thema, um die gescannten Rohmessdaten nach Gerätestandort aufzulösen. AWS IoT Core | | \$1aws/device\$1location/ /get\$1position\$1estimate/accepted *customer\$1device\$1id* | Abonnieren | AWS IoT Core Der Gerätestandort veröffentlicht die Standortinformationen zu diesem Thema, wenn der Gerätestandort erfolgreich ermittelt wurde. | | \$1aws/device\$1location/ /get\$1position\$1estimate/rejected *customer\$1device\$1id* | Abonnieren | AWS IoT Core Device Location veröffentlicht die Fehlerinformationen zu diesem Thema, wenn der Gerätestandort nicht behoben werden kann. | ## Richtlinie für MQTT-Themen zum Gerätestandort Um Nachrichten zu Themen rund um den Gerätestandort zu empfangen, muss Ihr Gerät eine Richtlinie verwenden, die es ihm ermöglicht, eine Verbindung zum AWS IoT Gerätegateway herzustellen und die MQTT-Themen zu abonnieren. Im Folgenden finden Sie ein Beispiel für die Richtlinie, die für den Empfang von Nachrichten zu verschiedenen Themen erforderlich ist. **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:Publish" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:topic/$aws/device_location/device-123/get_position_estimate" ] }, { "Effect": "Allow", "Action": [ "iot:Receive" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:topic/$aws/device_location/device-123/get_position_estimate/accepted", "arn:aws:iot:us-east-1:123456789012:topic/$aws/device_location/device-123/get_position_estimate/rejected" ] }, { "Effect": "Allow", "Action": [ "iot:Subscribe" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/device_location/device-123/get_position_estimate/accepted", "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/device_location/device-123/get_position_estimate/rejected" ] } ] } ``` ## Themen zum Gerätestandort und Nutzlast Im Folgenden werden die Themen AWS IoT Core zum Gerätestandort, das Format ihrer Nachrichtennutzdaten und eine Beispielrichtlinie für jedes Thema beschrieben. **Topics** + [/get\$1position\$1estimate](#get-position-estimate) + [/get\$1position\$1estimate/accepted](#get-position-estimate-accepted) + [/get\$1position\$1estimate/rejected](#get-position-estimate-rejected) ### /get\$1position\$1estimate Veröffentlichen Sie eine Nachricht zu diesem Thema, um die Rohmessdaten des Geräts abzurufen und nach AWS IoT Core Gerätestandort aufzulösen. ``` $aws/device_location/customer_device_id/get_position_estimate ``` AWS IoT Core Device Location antwortet mit der Veröffentlichung entweder auf [/get\$1position\$1estimate/accepted](#get-position-estimate-accepted) oder[/get\$1position\$1estimate/rejected](#get-position-estimate-rejected). **Anmerkung** Bei der zu diesem Thema veröffentlichten Nachricht muss es sich um eine gültige JSON-Nutzlast handeln. Wenn die Eingabenachricht kein gültiges JSON-Format hat, erhalten Sie keine Antwort. Weitere Informationen finden Sie unter [Nachrichtennutzlast](#get-position-estimate-payload). #### Nachrichten-Payload Das Format der Nachrichtennutzdaten folgt einer ähnlichen Struktur wie der Anforderungstext für den AWS IoT Wireless-API-Vorgang, [https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html). Sie enthält Folgendes: + Eine optionale `Timestamp`-Zeichenfolge, die dem Datum und der Uhrzeit entspricht, an denen der Standort aufgelöst wurde. Die `Timestamp`-Zeichenfolge kann eine Mindestlänge von 1 und eine Maximallänge von 10 haben. + Eine optionale `MessageId`-Zeichenfolge, die verwendet werden kann, um die Anforderung der Antwort zuzuordnen. Wenn Sie diese Zeichenfolge angeben, enthält die Nachricht, die in den Themen `get_position_estimate/accepted` oder `get_position_estimate/rejected` veröffentlicht wird, diese `MessageId`. Die `MessageID`-Zeichenfolge kann eine Mindestlänge von 1 und eine Maximallänge von 256 haben. + Die Messungsdaten des Geräts, das mindestens einen der folgenden Messungstypen enthält: + [https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_WiFiAccessPoint.html](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_WiFiAccessPoint.html) + [https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_CellTowers.html](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_CellTowers.html) + [https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_Ip.html](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_Ip.html) + [https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_Gnss.html](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_Gnss.html) Im Folgenden finden Sie ein Beispiel für eine Nachrichtennutzlast. ``` { "Timestamp": "1664313161", "MessageId": "ABCD1", "WiFiAccessPoints": [ { "MacAddress": "A0:EC:F9:1E:32:C1", "Rss": -66 } ], "Ip":{ "IpAddress": "54.192.168.0" }, "Gnss":{ "Payload":"8295A614A2029517F4F77C0A7823B161A6FC57E25183D96535E3689783F6CA48", "CaptureTime":1354393948 } } ``` #### Beispielrichtline Im Folgenden finden Sie ein Beispiel für die erforderliche Richtlinie: **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:Publish" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:topic/$aws/device_location/device-123/get_position_estimate" ] } ] } ``` ### /get\$1position\$1estimate/accepted AWS IoT Core Device Location veröffentlicht eine Antwort zu diesem Thema, wenn die aufgelösten Standortinformationen für Ihr Gerät zurückgesendet werden. Die Standortinformationen werden im [GeoJSON-Format](https://geojson.org/) zurückgegeben. ``` $aws/device_location/customer_device_id/get_position_estimate/accepted ``` Im Folgenden werden die Nachrichtennutzlast und ein Beispiel für eine Richtlinie dargestellt. #### Nachrichtennutzlast Im Folgenden sehen Sie ein Beispiel für die Nachrichtennutzlast im GeoJSON-Format. Wenn Sie `MessageId` in Ihren Rohmessdaten ein angegeben haben und der AWS IoT Core Gerätestandort die Standortinformationen erfolgreich aufgelöst hat, gibt die Nachrichtennutzlast dieselben `MessageId` Informationen zurück. ``` { "coordinates": [ 13.37704086303711, 52.51865005493164 ], "type": "Point", "properties": { "verticalAccuracy": 707, "verticalConfidenceLevel": 0.68, "horizontalAccuracy": 389, "horizontalConfidenceLevel": 0.68, "country": "USA", "state": "CA", "city": "Sunnyvalue", "postalCode": "91234", "timestamp": "2022-11-18T14:03:57.391Z", "messageId": "ABCD1" } } ``` #### Beispielrichtline Im Folgenden finden Sie ein Beispiel für die erforderliche Richtlinie: **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:Subscribe" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/device_location/device-123/get_position_estimate/accepted" ] }, { "Effect": "Allow", "Action": [ "iot:Receive" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:topic/$aws/device_location/device-123/get_position_estimate/accepted" ] } ] } ``` ### /get\$1position\$1estimate/rejected AWS IoT Core Device Location veröffentlicht eine Fehlermeldung zu diesem Thema, wenn der Gerätestandort nicht aufgelöst werden kann. ``` $aws/device_location/customer_device_id/get_position_estimate/rejected ``` Im Folgenden sehen Sie die Nachrichtennutzlast und ein Beispiel für die Richtlinie. Weitere Informationen zu den Fehlern finden Sie unter [Fehlerbehebung beim Auflösen des Standorts](device-location-resolve-solvers.md#location-resolve-troubleshoot). #### Nachrichtennutzlast Im Folgenden finden Sie ein Beispiel für die Nachrichten-Payload, die den Fehlercode und die Meldung enthält, aus der hervorgeht, warum AWS IoT Core Device Location die Standortinformationen nicht auflösen konnte. Wenn Sie `MessageId` bei der Bereitstellung Ihrer Rohmessdaten ein angegeben haben und der AWS IoT Core Gerätestandort die Standortinformationen nicht auflösen konnte, werden dieselben `MessageId` Informationen in der Nachrichtennutzlast zurückgegeben. ``` { "errorCode": 500, "errorMessage":"Internal server error", "messageId": "ABCD1" } ``` #### Beispielrichtline Im Folgenden finden Sie ein Beispiel für die erforderliche Richtlinie: **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:Subscribe" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/device_location/device-123/get_position_estimate/rejected" ] }, { "Effect": "Allow", "Action": [ "iot:Receive" ], "Resource": [ "arn:aws:iot:us-east-1:123456789012:topic/$aws/device_location/device-123/get_position_estimate/rejected" ] } ] } ``` # Location Solver und Geräte-Payload Location Solver sind Algorithmen, mit denen der Standort Ihrer IoT-Geräte ermittelt werden kann. AWS IoT Core Device Location unterstützt die folgenden Location Solver. Sie sehen Beispiele für das Format der JSON-Nutzlast für diese Messungstypen, die vom Solver unterstützten Geräte und die Art und Weise, wie der Standort aufgelöst wird. Um den Gerätestandort zu ermitteln, geben Sie mindestens einen dieser Messungsdatentypen an. Für alle Messungsdaten zusammen wird ein einziger, aufgelöster Standort zurückgegeben. **Topics** + [WLAN-basierter Solver](#location-solvers-wifi) + [Solver auf Mobilfunkbasis](#location-solvers-cellular) + [IP-Reverse-Lookup-Solver](#location-solvers-ip) + [GNSS-Solver](#location-solvers-gnss) + [BLE-Solver für Amazon Sidewalk-fähige Geräte](#location-solvers-ble) ## WLAN-basierter Solver Verwenden Sie den WLAN-basierten Solver, um den Standort anhand der Scaninformationen von WLAN-Zugangspunkten zu ermitteln. Der Solver unterstützt die WLAN-Technologie und kann zur Berechnung des Gerätestandorts für allgemeine IoT-Geräte verwendet werden, die eine Verbindung über TCP/IP herstellen, LoRa WAN-Wireless-Geräte und Amazon Sidewalk-fähige Geräte. Die LoRa WAN-Geräte müssen über den LoRa Edge-Chipsatz verfügen, der die eingehenden Wi-Fi-Scaninformationen dekodieren kann. LoRa Edge ist eine Plattform mit extrem geringem Stromverbrauch, die einen LoRa Transceiver mit großer Reichweite, einen GNSS-Scanner mit mehreren Konstellationen und einen passiven Wi-Fi-MAC-Scanner für Geolokalisierungsanwendungen integriert. Wenn eine Uplink-Nachricht vom Gerät empfangen wird, werden die Wi-Fi-Scandaten an den Gerätestandort gesendet, und der Standort wird auf der AWS IoT Core Grundlage der Wi-Fi-Scanergebnisse geschätzt. Die dekodierten Informationen werden dann an den WLAN-basierten Solver weitergeleitet, um die Standortinformationen abzurufen. Weitere Informationen zur Auflösung von Standortdaten für Amazon Sidewalk-fähige Geräte finden Sie im [AWS IoT Core für Amazon Sidewalk Entwicklerhandbuch](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/iot-sidewalk.html). ### Beispiel für die Nutzlast eines WLAN-basierten Solvers Der folgende Code zeigt ein Beispiel für die JSON-Nutzlast des Geräts, das die Messungsdaten enthält. Wenn AWS IoT Core Device Location diese Daten als Eingabe empfängt, sendet es eine HTTP-Anfrage an den Solver-Anbieter, um die Standortinformationen aufzulösen. Geben Sie zum Abrufen der Informationen Werte für die MAC-Adresse und RSS (Received Signal Strength) an. Stellen Sie dazu entweder die JSON-Nutzlast in diesem Format bereit oder verwenden Sie den [WiFiAccessPointsObjektparameter](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_WiFiAccessPoint.html) des [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API-Vorgangs. ``` { "Timestamp": 1664313161, // optional "WiFiAccessPoints": [ { "MacAddress": "A0:EC:F9:1E:32:C1", // required "Rss": -75 // required } ] } ``` ## Solver auf Mobilfunkbasis Sie können den Solver auf Mobilfunkbasis verwenden, um den Standort anhand von Messungsdaten von Mobilfunkmasten aufzulösen. Der Solver unterstützt die folgenden Technologien. Es wird eine einzige aufgelöste Standortinformation abgerufen, auch wenn Sie Messungsdaten aus einer oder allen dieser Technologien einbeziehen. + GSM + CDMA + WCDMA + TD-SCDMA + LTE ### Beispiele für Solver-Nutzlasten auf Mobilfunkbasis Der folgende Code zeigt Beispiele für die JSON-Nutzlast des Geräts, das die Messungsdaten auf Mobilfunkbasis enthält. Wenn AWS IoT Core Device Location diese Daten als Eingabe empfängt, sendet es eine HTTP-Anfrage an den Solver-Anbieter, um die Standortinformationen aufzulösen. Um die Informationen abzurufen, geben Sie entweder die JSON-Nutzlast in diesem Format in der Konsole an oder geben Werte für den [CellTowers](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html#iotwireless-GetPositionEstimate-request-CellTowers)Parameter des [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API-Vorgangs an. Sie können die Messungsdaten bereitstellen, indem Sie Werte für Parameter angeben, die eine oder alle dieser Mobilfunktechnologien verwenden. #### LTE (Long-term Evolution) Wenn Sie diese Messungsdaten verwenden, müssen Sie Informationen wie das Netzwerk und die Landesvorwahl des Mobilfunknetzes sowie optionale zusätzliche Parameter, einschließlich Informationen zur lokalen ID, angeben. Der nachfolgende Code zeigt ein Beispiel für das Nutzlastformat. Weitere Informationen zu diesen Parametern finden Sie unter [LTE-Objekt](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_LteObj.html). ``` { "Timestamp": 1664313161, // optional "CellTowers": { "Lte": [ { "Mcc": int, // required "Mnc": int, // required "EutranCid": int, // required. Make sure that you use int for EutranCid. "Tac": int, // optional "LteLocalId": { // optional "Pci": int, // required "Earfcn": int, // required }, "LteTimingAdvance": int, // optional "Rsrp": int, // optional "Rsrq": float, // optional "NrCapable": boolean, // optional "LteNmr": [ // optional { "Pci": int, // required "Earfcn": int, // required "EutranCid": int, // required "Rsrp": int, // optional "Rsrq": float // optional } ] } ] } } ``` #### GSM (Global System for Mobile Communications) Wenn Sie diese Messungsdaten verwenden, müssen Sie Informationen wie das Netzwerk und die Landesvorwahl des Mobilfunknetzes, Informationen zur Basisstation und optionale weitere Parameter angeben. Der nachfolgende Code zeigt ein Beispiel für das Nutzlastformat. Weitere Informationen zu diesen Parametern finden Sie unter [GSM-Objekt](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GsmObj.html). ``` { "Timestamp": 1664313161, // optional "CellTowers": { "Gsm": [ { "Mcc": int, // required "Mnc": int, // required "Lac": int, // required "GeranCid": int, // required "GsmLocalId": { // optional "Bsic": int, // required "Bcch": int, // required }, "GsmTimingAdvance": int, // optional "RxLevel": int, // optional "GsmNmr": [ // optional { "Bsic": int, // required "Bcch": int, // required "RxLevel": int, // optional "GlobalIdentity": { "Lac": int, // required "GeranCid": int // required } } ] } ] } ``` #### CDMA (Code-Division Multiple Access) Wenn Sie diese Messungsdaten verwenden, müssen Sie Informationen wie die Signalleistung und Identifikationsinformationen, Informationen zur Basisstation und optionale weitere Parameter angeben. Der nachfolgende Code zeigt ein Beispiel für das Nutzlastformat. Weitere Informationen zu diesen Parametern finden Sie unter [CDMA-Objekt](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_CdmaObj.html). ``` { "Timestamp": 1664313161, // optional "CellTowers": { "Cdma": [ { "SystemId": int, // required "NetworkId": int, // required "BaseStationId": int, // required "RegistrationZone": int, // optional "CdmaLocalId": { // optional "PnOffset": int, // required "CdmaChannel": int, // required }, "PilotPower": int, // optional "BaseLat": float, // optional "BaseLng": float, // optional "CdmaNmr": [ // optional { "PnOffset": int, // required "CdmaChannel": int, // required "PilotPower": int, // optional "BaseStationId": int // optional } ] } ] } } ``` #### WCDMA (Wideband Code-Division Multiple Access) Wenn Sie diese Messungsdaten verwenden, müssen Sie Informationen wie das Netzwerk und die Landesvorwahl, die Signalleistung und Identifikationsinformationen, Informationen zur Basisstation und optionale weitere Parameter angeben. Der nachfolgende Code zeigt ein Beispiel für das Nutzlastformat. Weitere Informationen zu diesen Parametern finden Sie unter [CDMA-Objekt](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_CdmaObj.html). ``` { "Timestamp": 1664313161, // optional "CellTowers": { "Wcdma": [ { "Mcc": int, // required "Mnc": int, // required "UtranCid": int, // required "Lac": int, // optional "WcdmaLocalId": { // optional "Uarfcndl": int, // required "Psc": int, // required }, "Rscp": int, // optional "Pathloss": int, // optional "WcdmaNmr": [ // optional { "Uarfcndl": int, // required "Psc": int, // required "UtranCid": int, // required "Rscp": int, // optional "Pathloss": int, // optional } ] } ] } } ``` #### TD-SCDMA (Time Division Synchronous Code-Division Multiple Access) Wenn Sie diese Messungsdaten verwenden, müssen Sie Informationen wie das Netzwerk und die Landesvorwahl, die Signalleistung und Identifikationsinformationen, Informationen zur Basisstation und optionale weitere Parameter angeben. Der nachfolgende Code zeigt ein Beispiel für das Nutzlastformat. Weitere Informationen zu diesen Parametern finden Sie unter [CDMA-Objekt](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_CdmaObj.html). ``` { "Timestamp": 1664313161, // optional "CellTowers": { "Tdscdma": [ { "Mcc": int, // required "Mnc": int, // required "UtranCid": int, // required "Lac": int, // optional "TdscdmaLocalId": { // optional "Uarfcn": int, // required "CellParams": int, // required }, "TdscdmaTimingAdvance": int, // optional "Rscp": int, // optional "Pathloss": int, // optional "TdscdmaNmr": [ // optional { "Uarfcn": int, // required "CellParams": int, // required "UtranCid": int, // optional "Rscp": int, // optional "Pathloss": int, // optional } ] } ] } } ``` ## IP-Reverse-Lookup-Solver Sie können den IP-Reverse-Lookup-Solver verwenden, um den Standort mithilfe der IP-Adresse als Eingabe aufzulösen. Der Solver kann die Standortinformationen von Geräten abrufen, die mit ausgestattet wurden. AWS IoT Geben Sie die IP-Adressinformationen in einem Format an, das entweder dem IPv6 Standardmuster IPv4 oder dem IPv6 Hex-komprimierten Muster entspricht. Anschließend erhalten Sie die aufgelöste Standortschätzung, einschließlich zusätzlicher Informationen wie Stadt und Land, in denen sich das Gerät befindet. **Anmerkung** Durch die Verwendung des IP-Reverse-Lookup-Solvers erklären Sie sich damit einverstanden, diesen nicht zum Zweck der Identifizierung oder Ortung eines bestimmten Haushalts oder einer Straßenadresse zu verwenden. ### Beispiel für eine Nutzlast des IP-Reverse-Lookup-Solvers Der folgende Code zeigt ein Beispiel für die JSON-Nutzlast des Geräts, das die Messungsdaten enthält. Wenn AWS IoT Core Device Location die in den Messdaten enthaltenen IP-Adressinformationen empfängt, sucht es nach diesen Informationen in der Datenbank des Solver-Anbieters, die dann zur Auflösung der Standortinformationen verwendet wird. Um die Informationen abzurufen, geben Sie entweder die JSON-Payload in diesem Format an oder geben Sie Werte für den [IP-Parameter](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html#iotwireless-GetPositionEstimate-request-Ip) des [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html)API-Vorgangs an. **Anmerkung** Wenn dieser Solver verwendet wird, werden zusätzlich zu den Koordinaten auch die Stadt, das Bundesland, das Land und die Postleitzahl gemeldet, in denen sich das Gerät befindet. Ein Beispiel finden Sie unter [Auflösen des Gerätestandorts (Konsole)](device-location-resolve-solvers.md#location-resolve-console). ``` { "Timestamp": 1664313161, "Ip":{ "IpAddress":"54.240.198.35" } } ``` ## GNSS-Solver Verwenden Sie den GNSS-Solver (Global Navigation Satellite System), um den Gerätestandort anhand der in den GNSS-Scanergebnisnachrichten oder NAV-Nachrichten enthaltenen Informationen abzurufen. Sie können optional zusätzliche GNSS-Unterstützungsinformationen angeben, wodurch die Anzahl der Variablen reduziert wird, die der Solver für die Suche nach Signalen verwenden muss. Durch die Bereitstellung dieser unterstützenden Informationen, zu denen Position, Höhe, Erfassungszeit und Genauigkeitsinformationen gehören, kann der Solver die Satelliten im Sichtfeld leicht identifizieren und den Gerätestandort berechnen. Dieser Solver kann mit LoRa WAN-Geräten und Amazon Sidewalk-fähigen Geräten sowie mit anderen Geräten verwendet werden, die mit AWS IoT-Geräten ausgestattet wurden, mit denen ausgestattet wurde. AWS IoT Bei allgemeinen IoT-Geräten gilt Folgendes: Wenn die Geräte die Standortschätzung mithilfe von GNSS unterstützen, lösen die Transceiver die Standortinformationen auf, wenn die GNSS-Scaninformationen vom Gerät empfangen werden. Bei LoRa WAN-Geräten müssen die Geräte über den Edge-Chipsatz verfügen. LoRa Wenn eine Uplink-Nachricht vom Gerät empfangen wird, werden die GNSS-Scandaten AWS IoT für LoRa WAN oder AWS IoT Amazon Sidewalk gesendet, und der Standort wird auf der Grundlage der Scanergebnisse der Transceiver geschätzt. ### Beispiel für die Nutzlast eines GNSS-Solvers Der folgende Code zeigt ein Beispiel für die JSON-Nutzlast des Geräts, das die Messungsdaten enthält. Wenn AWS IoT Core Device Location die GNSS-Scaninformationen empfängt, die die Nutzlast in den Messdaten enthalten, verwendet es die Transceiver und alle zusätzlichen enthaltenen Hilfsinformationen, um nach Signalen zu suchen und die Standortinformationen aufzulösen. Um die Informationen abzurufen, geben Sie entweder die JSON-Nutzdaten in diesem Format an oder geben Sie Werte für den [GNSS-Parameter der API-Operation](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html#iotwireless-GetPositionEstimate-request-Gnss) an. [GetPositionEstimate](https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetPositionEstimate.html) **Anmerkung** Bevor AWS IoT Core Device Location den Gerätestandort auflösen kann, müssen Sie das Zielbyte aus der Payload entfernen. ``` { "Timestamp": 1664313161, // optional "Gnss": { "AssistAltitude": number, // optional "AssistPosition": [ number ], // optional "CaptureTime": number, // optional "CaptureTimeAccuracy": number, // optional "Payload": "string", // required "Use2DSolver": boolean // optional } } ``` ## BLE-Solver für Amazon Sidewalk-fähige Geräte **Anmerkung** Gibt für den Standort mit Bluetooth Low Energy die Standortkoordinaten AWS IoT zurück, die auf dem ungefähren Standort von Sidewalk Gateways in der Nähe basieren, die mit Amazon Sidewalk verbunden sind und für die die Community Finding-Funktion aktiviert ist. Gateway-Standortdaten sind AWS Inhalte und werden Ihnen ausschließlich zu dem Zweck zur Verfügung gestellt, Sie beim Auffinden Ihrer mit Amazon Sidewalk verbundenen Geräte zu unterstützen, und Sie dürfen die Daten nur für diesen Zweck verwenden. Sie dürfen Standortdaten nur über die Schnittstelle und die Funktionen, die wir Ihnen allgemein zur Verfügung stellen, verwenden und darauf zugreifen, und Sie dürfen nicht versuchen, Gateway-Standortdaten, die wir Ihnen zur Verfügung gestellt haben, neu zu identifizieren, zurückzuentwickeln oder neu zuzuordnen. Amazon Sidewalk-Endgeräte, die eine Verbindung herstellen, AWS IoT Core für Amazon Sidewalk können ihre Standortdaten mithilfe von BLE-, Wi-Fi- oder GNSS-Uplink-Nachrichten auflösen, die vom Amazon Sidewalk-Endgerät veröffentlicht werden. [Weitere Informationen finden Sie im Entwicklerhandbuch.AWS IoT Core für Amazon Sidewalk](https://docs.aws.amazon.com/iot-wireless/latest/developerguide/sidewalk-getting-started.html)