Auflösen des Gerätestandorts mithilfe der MQTT-Themen zu AWS IoT Core  Device Location

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 angebenWirelessDeviceId, z. B. für LoRa WAN- und Sidewalk-Geräte, undthingName, 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 (+) 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	Beschreibung
$aws/device_location/ customer_device_id /get_position_estimate	Veröffentlichen	Ein Gerät veröffentlicht zu diesem Thema, um die gescannten Rohmessdaten nach AWS IoT Core Gerätestandort aufzulösen.
$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 Der Gerätestandort 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 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:region:account:topic/$aws/device_location/customer_device_id/get_position_estimate"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "iot:Receive"
      ],
      "Resource": [
        "arn:aws:iot:region:account:topic/$aws/device_location/customer_device_id/get_position_estimate/accepted",
        "arn:aws:iot:region:account:topic/$aws/device_location/customer_device_id/get_position_estimate/rejected"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "iot:Subscribe"
      ],
      "Resource": [
        "arn:aws:iot:region:account:topicfilter/$aws/device_location/customer_device_id/get_position_estimate/accepted",
        "arn:aws:iot:region:account:topicfilter/$aws/device_location/customer_device_id/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.

/get_position_estimate

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_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.

Nachrichtennutzlast

Das Format für die Nachrichtennutzlast folgt einer ähnlichen Struktur wie der Hauptteil der API-Operationsanforderung AWS IoT Wireless . 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:

  • WiFiAccessPoint

  • CellTowers

  • IpAddress

  • Gnss

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:region:account:topic/$aws/device_location/customer_device_id/get_position_estimate"
      ]
    }
  ]
}

/get_position_estimate/accepted

AWS IoT Core Device Location veröffentlicht eine Antwort zu diesem Thema, wenn Sie die aufgelösten Standortinformationen für Ihr Gerät zurücksenden. 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.

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:region:account:topicfilter/$aws/device_location/customer_device_id/get_position_estimate/accepted"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "iot:Receive"
      ],
      "Resource": [
        "arn:aws:iot:region:account:topic/$aws/device_location/customer_device_id/get_position_estimate/accepted"
      ]
    }
  ]
}

/get_position_estimate/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.

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:region:account:topicfilter/$aws/device_location/customer_device_id/get_position_estimate/rejected"
      ]
    },
    {
      "Action": [
        "iot:Receive"
      ],
      "Resource": [
        "arn:aws:iot:region:account:topic/$aws/device_location/customer_device_id/get_position_estimate/rejected"
      ]
    }
  ]
}