MQTT-Themen zum Format des Gerätestandorts Richtlinie für MQTT-Themen zum Gerätestandort Themen zum Gerätestandort und Nutzlast

Auflösen des Gerätestandorts mit AWS IoT Core MQTT-Themen zum Standort des Geräts

Sie können reservierte MQTT-Themen verwenden, um mit der Funktion AWS IoT Core Gerätestandort die neuesten Standortinformationen für Ihre Geräte abzurufen.

MQTT-Themen zum Format des Gerätestandorts

Reservierte Themen für den AWS IoT Core Gerätestandort verwenden das folgende Präfix:

$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 angebenWirelessDeviceId, z. B. für LoRa WAN- und Sidewalk-GerätethingName, und wenn 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 (+) 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 sind die reservierten Themen aufgeführt, die für die Interaktion mit dem AWS IoT Core Gerätestandort verwendet werden.

MQTT-Themen zum Gerätestandort
Thema	Zulässige Operationen	Description
$aws/device_location/`customer_device_id`/get_position_estimate	Veröffentlichen	Ein Gerät veröffentlicht zu diesem Thema, um die gescannten Rohmessdaten abzurufen, die nach Gerätestandort aufgelöst werden sollen. AWS IoT Core
$aws/device_location/`customer_device_id`/get_position_estimate/accepted	Abonnieren	AWS IoT Core Der Gerätestandort veröffentlicht die Standortinformationen zu diesem Thema, wenn der Gerätestandort erfolgreich ermittelt wurde.
$aws/device_location/`customer_device_id`/get_position_estimate/rejected	Abonnieren	AWS IoT Core Device Location veröffentlicht die Fehlerinformationen zu diesem Thema, wenn der Gerätestandort nicht aufgelöst werden kann.

Richtlinie für MQTT-Themen zum Gerätestandort

Um Nachrichten zu Themen zum Gerätestandort zu erhalten, muss Ihr Gerät eine Richtlinie verwenden, die es ihm ermöglicht, eine Verbindung zum AWS IoT Geräte-Gateway 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 dargestellt.

/get_position_estimate

Veröffentlichen Sie eine Nachricht zu diesem Thema, um die Rohmessdaten des Geräts abzurufen, die nach AWS IoT Core Gerätestandort aufgelöst werden sollen.


$aws/device_location/customer_device_id/get_position_estimate

AWS IoT Core Der Gerätestandort reagiert mit der Veröffentlichung auf entweder /get_position_estimate/accepted oder/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.

Das Nachrichtennutzlastformat folgt einer ähnlichen Struktur wie der Anforderungstext für die AWS IoT Wireless-API-Operation, GetPositionEstimate. 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:

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
    }
}

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_position_estimate/accepted

AWS IoT Core Device Location veröffentlicht eine Antwort auf dieses Thema, wenn die aufgelösten Standortinformationen für Ihr Gerät zurückgegeben werden. Die Standortinformationen werden im GeoJSON-Format 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.

Im Folgenden sehen Sie ein Beispiel für die Nachrichtennutzlast im GeoJSON-Format. Wenn Sie MessageId in Ihren Rohmessdaten eine angegeben haben und der AWS IoT Core Gerätestandort die Standortinformationen erfolgreich aufgelöst hat, gibt die Nachrichten-Payload 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"
    }
}

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_position_estimate/rejected

AWS IoT Core Der Gerätestandort veröffentlicht eine Fehlerantwort 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.

Im Folgenden finden Sie ein Beispiel für die Nachrichtennutzlast, 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 eine 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"
}

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"
      ]
    }
  ]
}

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Auflösen des Standorts von IoT-Geräten

Location Solver und Geräte-Payload