

# Konfigurieren der Position von LoRaWAN-Gateways
<a name="lorawan-location-gateways"></a>

Wenn Sie Ihr Gateway zu AWS IoT Core für 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-Managementkonsole, der AWS IoT Wireless-API oder von AWS CLI konfigurieren. 

## Konfigurieren der Position Ihres Gateways mithilfe der Konsole
<a name="lorawan-location-gateways-console"></a>

Um die Position Ihrer Gateway-Ressourcen mithilfe von AWS-Managementkonsole zu konfigurieren, melden Sie sich zuerst an der Konsole an und rufen Sie dann die [https://console.aws.amazon.com/iot/home#/wireless/gateways](https://console.aws.amazon.com/iot/home#/wireless/gateways) 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.

1. 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](lorawan-onboard-gateway-add.md#lorawan-onboard-gateway-console).

1. 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 für 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](https://aws.amazon.com/iot-core/pricing/).

Die Karte `iotwireless.map` dient als Quelle für Kartendaten, auf die mithilfe von `Get` API-Operationen, wie z. B. [https://docs.aws.amazon.com/location-maps/latest/APIReference/API_GetMapTile.html](https://docs.aws.amazon.com/location-maps/latest/APIReference/API_GetMapTile.html), zugegriffen wird. Informationen zu `Get` APIs, die mit Karten verwendet werden, finden Sie in der [Amazon Location Service API-Referenz](https://docs.aws.amazon.com/location-maps/latest/APIReference/Welcome.html).

Um weitere Informationen zu dieser Karte zu erhalten, gehen Sie zur Amazon Location Service-Konsole, wählen Sie **Maps** und dann [iotwireless.map](https://console.aws.amazon.com/location/maps/home#/describe/iotwireless.map). Weitere Informationen finden Sie unter [Maps](https://docs.aws.amazon.com/location/latest/developerguide/map-concepts.html) 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
<a name="lorawan-location-gateways-api"></a>

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](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdatePosition.html), [GetPosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetPosition.html), [PutPositionConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_PutPositionConfiguration.html), [GetPositionConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetPositionConfiguration.html) und [ListPositionConfigurations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListPositionConfigurations.html) werden nicht mehr unterstützt. Aufrufe zum Aktualisieren und Abrufen der Positionsinformationen sollten stattdessen die API-Operationen [GetResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourcePosition.html) und [UpdateResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourcePosition.html) verwenden.

### Hinzufügen von Positionsinformationen
<a name="lorawan-location-gateways-api-add"></a>

Um die statischen Positionsinformationen für ein bestimmtes drahtloses Gateway hinzuzufügen, geben Sie die Koordinaten mit dem API-Vorgang [UpdateResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourcePosition.html) oder dem CLI-Befehl [update-resource-position](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-resource-position.html) an. Geben Sie `WirelessGateway` als `ResourceType`, die ID des drahtlosen Gateways, das aktualisiert werden soll`ResourceIdentifier`, 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
<a name="lorawan-location-devices-api-get"></a>

Um die Positionsinformationen für ein bestimmtes drahtloses Gateway abzurufen, verwenden Sie den API-Vorgang [GetResourcePosition](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourcePosition.html) oder den CLI-Befehl [get-resource-position](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-position.html). 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"
         }
    }
}
```