Konfigurieren der Position von LoRaWAN-Gateways - AWS IoT Wireless

Konfigurieren der Position von LoRaWAN-Gateways

Wenn Sie Ihr Gateway zu AWS IoT Core for LoRaWAN hinzufügen, können Sie die statischen Positionsdaten angeben. Wenn Sie Amazon Location Service-Karten aktiviert haben, werden die Positionsdaten auf einer Amazon-Standortkarte angezeigt.

Anmerkung

Die Solver von Drittanbietern können nicht mit LoRaWAN-Gateways verwendet werden. Für Gateways können Sie weiterhin die statischen Positionskoordinaten angeben. Wenn zur Berechnung der Position keine Solver verwendet werden, wie dies bei Gateways der Fall ist, werden die Genauigkeitsinformationen als 0.0 gemeldet.

Sie können die Gateway-Position mithilfe von AWS Management Console, der AWS IoT Wireless-API oder von AWS CLI konfigurieren.

Konfigurieren der Position Ihres Gateways mithilfe der Konsole

Um die Position Ihrer Gateway-Ressourcen mithilfe von AWS Management Console zu konfigurieren, melden Sie sich zuerst an der Konsole an und rufen Sie dann die Gateways-Hub-Seite der AWS IoT-Konsole auf.

Hinzufügen von Positionsinformationen

So fügen Sie eine Positionskonfiguration für Ihr Gateway hinzu

  1. Wählen Sie auf der Gateways-Hub-Seite die Option Gateway hinzufügen aus.

  2. Geben Sie die EUI, das Frequenzband (RFRegion) und alle zusätzlichen Gateway-Details und LoRaWAN-Konfigurationsinformationen ein. Weitere Informationen finden Sie unter Hinzufügen eines Gateway mit der Konsole.

  3. Gehen Sie zum Abschnitt Positionsinformationen - Optional und geben Sie die Positionsinformationen für Ihr Gateway unter Verwendung der Breiten- und Längenkoordinaten sowie einer optionalen Höhenkoordinate ein. Die Positionsinformationen basieren auf dem WGS84-Koordinatensystem.

Anzeigen der Position des Gateways

Nachdem Sie die Position Ihres Gateways konfiguriert haben, erstellt AWS IoT Core for LoRaWAN eine Amazon-Standortkarte mit dem Namen iotwireless.map. Sie können diese Karte auf der Detailseite Ihres Gateways auf der Registerkarte Position sehen. Basierend auf den von Ihnen angegebenen Positionskoordinaten wird die Position Ihres Gateways als Markierung auf der Karte angezeigt. Sie können die Ansicht vergrößern oder verkleinern, um die Position Ihres Gateways auf der Karte deutlich zu sehen. Auf der Registerkarte Position sehen Sie auch die Genauigkeitsinformationen und den Zeitstempel, zu dem die Position Ihres Gateways bestimmt wurde.

Anmerkung

Wenn Sie keine Amazon Location Service-Karten installiert haben, wird eine Meldung angezeigt, dass Sie Amazon Location Service verwenden müssen, um auf die Karte zugreifen und die Gateway-Position anzeigen zu können. Durch die Verwendung von Amazon Location Service-Karten können zusätzliche Gebühren für Ihr AWS-Konto anfallen. Weitere Informationen finden Sie unter AWS IoT Core Preise.

Die Karte iotwireless.map dient als Quelle für Kartendaten, auf die mithilfe von Get API-Operationen, wie z. B. GetMapTile, zugegriffen wird. Informationen zu Get APIs, die mit Karten verwendet werden, finden Sie in der Amazon Location Service API-Referenz.

Um weitere Informationen zu dieser Karte zu erhalten, gehen Sie zur Amazon Location Service-Konsole, wählen Sie Maps und dann iotwireless.map. Weitere Informationen finden Sie unter Maps im Entwicklerhandbuch für Amazon Location Service.

Aktualisiere der Positionskonfiguration des Gateways

Um die Positionskonfiguration des Gateways zu ändern, wählen Sie auf der Seite mit den Gateway-Details die Option Bearbeiten aus und aktualisieren Sie dann die Positionsinformationen und das Ziel.

Anmerkung

Informationen zu historischen Positionsdaten sind nicht verfügbar. Wenn Sie die Positionskoordinaten des Gateways aktualisieren, werden die zuvor gemeldeten Positionsdaten überschrieben. Nachdem Sie die Position aktualisiert haben, sehen Sie auf der Registerkarte Position der Gateway-Details die neuen Positionsinformationen. Die Änderung des Zeitstempels gibt an, dass er der letzten bekannten Position des Gateways entspricht.

Konfigurieren der Position Ihres Gateways mithilfe der API

Sie können die Positionsinformationen angeben und die Gateway-Position mithilfe der AWS IoT Wireless-API oder von AWS CLI konfigurieren.

Wichtig

Die API-Aktionen UpdatePosition, GetPosition, PutPositionConfiguration, GetPositionConfiguration und ListPositionConfigurations werden nicht mehr unterstützt. Aufrufe zum Aktualisieren und Abrufen der Positionsinformationen sollten stattdessen die API-Operationen GetResourcePosition und UpdateResourcePosition verwenden.

Hinzufügen von Positionsinformationen

Um die statischen Positionsinformationen für ein bestimmtes drahtloses Gateway hinzuzufügen, geben Sie die Koordinaten mit dem API-Vorgang UpdateResourcePosition oder dem CLI-Befehl update-resource-position an. Geben Sie WirelessGateway als ResourceType, die ID des drahtlosen Gateways, das aktualisiert werden sollResourceIdentifier, und die Positionsinformationen als GeoJSON-Nutzlast an.

aws iotwireless update-resource-position \ --resource-type WirelessGateway \ --resource-id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \ --cli-input-json file://gatewayposition.json

Im Folgenden werden die Inhalte der gatewayposition.json-Datei angezeigt.

Inhalt von gatewayposition.json

{ "type": "Point", "coordinates": [33.3318, -22.2155, 13.123], "properties": { "timestamp": "2018-11-30T18:35:24Z" } }

Dieser Befehl liefert keine Ausgabe. Verwenden Sie den GetResourcePosition API-Vorgang, um die von Ihnen angegebenen Positionsinformationen anzuzeigen.

Abrufen von Positionsinformationen

Um die Positionsinformationen für ein bestimmtes drahtloses Gateway abzurufen, verwenden Sie den API-Vorgang GetResourcePosition oder den CLI-Befehl get-resource-position. Geben Sie WirelessGateway als resourceType an und geben Sie die ID des drahtlosen Gateways als resourceIdentifier an.

aws iotwireless get-resource-position \ --resource-type WirelessGateway \ --resource-id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"

Wenn Sie diesen Befehl ausführen, werden die Positionsinformationen Ihres drahtlosen Gateways als GeoJSON-Payload angezeigt. Sie erhalten Informationen über die Positionskoordinaten, die Art der Positionsinformationen und zusätzliche Eigenschaften, wie z. B. den Zeitstempel, der der letzten bekannten Position des Gateways entspricht.

{ { "type": "Point", "coordinates": [33.3318,-22.2155,13.123], "properties": { "timestamp": "2018-11-30T18:35:24Z" } } }