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.

# Aktualisiere deinen Tracker mit einer Geräteposition
<a name="send-location-updates"></a>

Um deine Geräte zu verfolgen, kannst du Aktualisierungen der Geräteposition auf deinem Tracker posten. Sie können diese Gerätepositionen oder den Verlauf der Gerätepositionen später von Ihrer Tracker-Ressource abrufen.

Jede Positionsaktualisierung muss die Geräte-ID, einen Zeitstempel und eine Position enthalten. Sie können optional weitere Metadaten hinzufügen, darunter Genauigkeit und bis zu 3 Schlüssel-Wert-Paare für Ihren eigenen Gebrauch.

Wenn Ihr Tracker mit einer oder mehreren Geofence-Sammlungen verknüpft ist, werden Aktualisierungen anhand dieser Geofences bewertet (gemäß den Filterregeln, die Sie für den Tracker angegeben haben). Wenn ein Gerät in einen abgegrenzten Bereich eindringt (indem es sich von innerhalb des Bereichs nach außen bewegt oder umgekehrt), erhalten Sie Ereignisse in. EventBridge Zu diesen `ENTER` `EXIT` Ereignissen gehören Informationen zur Positionsaktualisierung, einschließlich der Geräte-ID, des Zeitstempels und aller zugehörigen Metadaten.

**Anmerkung**  
Weitere Informationen zur Positionsfilterung finden Sie unter[Einen Tracker erstellen](start-create-tracker.md).  
Weitere Informationen zu Geofence-Ereignissen finden Sie unter. [Reagieren Sie mit Amazon auf Amazon Location Service Service-Ereignisse EventBridge](location-events.md)

Verwenden Sie eine der folgenden Methoden, um Geräteaktualisierungen zu senden:
+ [Senden Sie MQTT-Updates](tracking-using-mqtt.md) an eine AWS IoT Core-Ressource und verknüpfen Sie sie mit Ihrer Tracker-Ressource.
+ Senden Sie Standortaktualisierungen über die Amazon Location Trackers API, indem Sie den AWS CLI oder den Amazon-Standort APIs verwenden. Sie können das verwenden [AWS SDKs](dev-sdks.md), um das APIs von Ihrer iOS- oder Android-Anwendung aus aufzurufen.

------
#### [ API ]

**Um eine Positionsaktualisierung über den Amazon-Standort zu senden APIs**

Verwenden Sie den `[BatchUpdateDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchUpdateDevicePosition.html)` Vorgang von den Amazon Location Trackers APIs aus. 

Das folgende Beispiel verwendet eine API-Anfrage, um eine Aktualisierung der Geräteposition für einen Tracker *ExampleDevice* *ExampleTracker* zu posten.

```
POST /tracking/v0/trackers/ExampleTracker/positions
Content-type: application/json
{
 "Updates": [
    {
    "DeviceId": "1",
    "Position": [
   -123.12245146162303, 49.27521118043802
    ],
    "SampleTime": "2022-10-24T19:09:07.327Z",
     "PositionProperties": { 
            "name" : "device1" 
         },
         "Accuracy": { 
            "Horizontal": 10
         }
    },

    {
    "DeviceId": "2",
    "Position": [
   -123.1230104928471, 49.27752402723152
    ],
    "SampleTime": "2022-10-02T19:09:07.327Z"
    },
    {
    "DeviceId": "3",
    "Position": [
    -123.12325592118916, 49.27340530543111
    ],
    "SampleTime": "2022-10-02T19:09:07.327Z"
    },
    {
    "DeviceId": "4",
    "Position": [
    -123.11958813096311, 49.27774641063121
    ],
    "SampleTime": "2022-10-02T19:09:07.327Z"
    },
    {
    "DeviceId": "5",
    "Position": [
    -123.1277418058896, 49.2765989015285
    ],
    "SampleTime": "2022-10-02T19:09:07.327Z"
    },
    {
    "DeviceId": "6",
    "Position": [
   -123.11964267059481, 49.274188155916534
    ],
    "SampleTime": "2022-10-02T19:09:07.327Z"
    }
    ]
}
```

------
#### [ AWS CLI ]

**Um eine Positionsaktualisierung mithilfe von AWS CLI Befehlen zu senden**

Verwenden Sie den Befehl `[batch-update-device-position](https://docs.aws.amazon.com/cli/latest/reference/location/batch-update-device-position.html)`.

Im folgenden Beispiel wird ein verwendet AWS CLI , um eine Aktualisierung der Geräteposition für *ExampleDevice-1* und *ExampleDevice-2* an einen Tracker zu posten*ExampleTracker*. 

```
aws location batch-update-device-position \
--tracker-name ExampleTracker \
--updates '[{"DeviceId":"ExampleDevice-1","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z"},{"DeviceId":"ExampleDevice-2","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z","Accuracy":{"Horizontal":10.30},"PositionProperties":{"field1":"value1","field2":"value2"}}]'
```

------