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. # Erste Schritte mit Amazon Location Service Trackern Dieser Abschnitt enthält eine umfassende Anleitung zur Erstellung und Verwendung von Trackern mit Amazon Location. Mit Trackern können Sie Gerätepositionen speichern, verarbeiten und auswerten und gleichzeitig Standortaktualisierungen filtern, um Lärm zu reduzieren und die Kosten im Griff zu behalten. Mit fortschrittlichen Positionsfilteroptionen, Unterstützung für verknüpfte Geofence-Sammlungen und Integration mit AWS Diensten wie IoT Core ermöglichen Tracker genaue Tracking EventBridge - und Geofencing-Anwendungen in Echtzeit, die auf Ihre spezifischen Bedürfnisse zugeschnitten sind. **Topics** + [Einen Tracker erstellen](start-create-tracker.md) + [Authentifizierung Ihrer Anfragen](tracking-identity-pool.md) + [Aktualisiere deinen Tracker mit einer Geräteposition](send-location-updates.md) + [Den Standortverlauf eines Geräts von einem Tracker abrufen](get-location-history.md) + [Ihre Gerätepositionen auflisten](list-device-positions.md) # Einen Tracker erstellen Erstellen Sie eine Tracker-Ressource, um Positionsaktualisierungen von Ihren Geräten zu speichern und zu verarbeiten. Sie können die Amazon Location Service Service-Konsole AWS CLI, den oder den Amazon-Standort verwenden APIs. Jede in Ihren Tracker-Ressourcen gespeicherte Positionsaktualisierung kann ein Maß für die Positionsgenauigkeit und bis zu drei Felder mit Metadaten über die Position oder das Gerät enthalten, die Sie speichern möchten. Die Metadaten werden als Schlüssel-Wert-Paare gespeichert und können Informationen wie Geschwindigkeit, Richtung, Reifendruck oder Motortemperatur speichern. Tracker filtern Positionsaktualisierungen, sobald sie empfangen werden. Dadurch wird das visuelle Rauschen in Ihren Gerätepfaden reduziert (als *Jitter* bezeichnet) und die Anzahl falscher Geofence-Eingangs- und Austrittsereignisse reduziert. Dies trägt auch zur Kostenkontrolle bei, da die Anzahl der eingeleiteten Geofence-Evaluierungen reduziert wird. Tracker bieten drei Optionen zur Positionsfilterung, um die Kosten im Griff zu behalten und Störungen bei Ihren Standortaktualisierungen zu reduzieren. + **Genauigkeitsbasiert — Kann** *mit jedem Gerät verwendet werden, das Genauigkeitsmessungen ermöglicht. Die meisten Mobilgeräte stellen diese Informationen bereit.* Die Genauigkeit jeder Positionsmessung wird von vielen Umweltfaktoren beeinflusst, darunter dem GPS-Satellitenempfang, der Landschaft und der Nähe von WLAN- und Bluetooth-Geräten. Die meisten Geräte, einschließlich der meisten Mobilgeräte, können zusammen mit der Messung eine Schätzung der Genauigkeit der Messung liefern. Bei der `AccuracyBased` Filterung ignoriert Amazon Location Standortaktualisierungen, wenn sich das Gerät weniger als die gemessene Genauigkeit bewegt hat. Wenn beispielsweise zwei aufeinanderfolgende Updates von einem Gerät einen Genauigkeitsbereich von 5 m und 10 m haben, ignoriert Amazon Location das zweite Update, wenn sich das Gerät weniger als 15 m bewegt hat. Amazon Location wertet ignorierte Updates weder anhand von Geofences aus, noch speichert sie. Wenn keine Genauigkeit angegeben ist, wird sie als Null behandelt, und die Messung wird als absolut genau angesehen. **Anmerkung** Sie können auch genauigkeitsbasierte Filterung verwenden, um alle Filter zu entfernen. Wenn Sie die genauigkeitsbasierte Filterung auswählen, aber alle Genauigkeitsdaten auf Null überschreiben oder die Genauigkeit ganz weglassen, filtert Amazon Location keine Aktualisierungen heraus. + **Entfernungsbasiert** — *Verwenden Sie diese Option, wenn Ihre Geräte keine Genauigkeitsmessung bieten, Sie aber dennoch die Vorteile der Filterung nutzen möchten, um Jitter zu reduzieren und die Kosten zu senken*. `DistanceBased`Beim Filtern werden Standortaktualisierungen ignoriert, bei denen sich Geräte weniger als 30 m (98,4 ft) bewegt haben. Wenn Sie die `DistanceBased` Positionsfilterung verwenden, wertet Amazon Location diese ignorierten Aktualisierungen weder anhand von Geofences aus, noch speichert Amazon Location die Aktualisierungen. Die Genauigkeit der meisten Mobilgeräte, einschließlich der durchschnittlichen Genauigkeit von iOS- und Android-Geräten, liegt innerhalb von 15 m. In den meisten Anwendungen können durch `DistanceBased` Filterung die Auswirkungen von Standortungenauigkeiten bei der Anzeige der Geräteflugbahn auf einer Karte sowie die Abprallwirkung mehrerer aufeinanderfolgender Ein- und Austrittsereignisse verringert werden, wenn sich Geräte in der Nähe der Grenze eines Geofences befinden. Es kann auch dazu beitragen, die Kosten Ihrer Anwendung zu senken, da weniger Aufrufe zur Auswertung verknüpfter Geofences oder zum Abrufen von Gerätepositionen getätigt werden. + **Zeitbasiert** — (Standard) *Verwenden Sie diese Option, wenn Ihre Geräte sehr häufig Positionsaktualisierungen senden (mehr als einmal alle 30 Sekunden) und Sie Geofence-Auswertungen nahezu in Echtzeit durchführen möchten,* ohne jedes Update zu speichern.Bei der `TimeBased` Filterung wird jede Standortaktualisierung anhand verknüpfter Geofence-Sammlungen bewertet, aber nicht jede Standortaktualisierung wird gespeichert. Wenn Ihre Aktualisierungs-Häufigkeit häufiger als 30 Sekunden beträgt, wird nur ein Update pro 30 Sekunden für jede eindeutige Geräte-ID gespeichert. **Anmerkung** Denken Sie bei der Auswahl Ihrer Filtermethode und der Häufigkeit von Positionsaktualisierungen an die Kosten Ihrer Tracking-Anwendung. Ihnen wird jede Standortaktualisierung und einmal die Auswertung der Positionsaktualisierung anhand jeder verknüpften Geofence-Erfassung in Rechnung gestellt. Wenn Sie beispielsweise zeitbasierte Filterung verwenden und Ihr Tracker mit zwei Geofence-Sammlungen verknüpft ist, zählt jede Positionsaktualisierung als eine Anfrage zur Standortaktualisierung und zwei Bewertungen der Geofence-Erfassung. Wenn du Positionsaktualisierungen für deine Geräte alle 5 Sekunden meldest und zeitbasierte Filterung verwendest, werden dir 720 Standortaktualisierungen und 1.440 Geofence-Bewertungen pro Stunde für jedes Gerät in Rechnung gestellt. Ihre Rechnung wird nicht von der Anzahl der Geofences in jeder Sammlung beeinflusst. Da jede Geofence-Sammlung bis zu 50.000 Geofences enthalten kann, sollten Sie Ihre Geofences nach Möglichkeit in weniger Sammlungen zusammenfassen, um die Kosten für Geofence-Bewertungen zu senken. Standardmäßig erhalten Sie jedes Mal EventBridge Ereignisse, wenn ein getracktes Gerät einen verknüpften Geofence betritt oder verlässt. Weitere Informationen finden Sie unter [Einen Tracker mit einer Geofence-Sammlung verknüpfen](associate-consumer.md). Sie können Ereignisse für alle gefilterten Positionsaktualisierungen für eine Tracker-Ressource aktivieren. Weitere Informationen finden Sie unter [Aktivieren Sie Aktualisierungsereignisse für einen Tracker](location-events.md#enable-update-events). **Anmerkung** Wenn Sie Ihre Daten mit Ihrem eigenen, vom AWS KMS Kunden verwalteten Schlüssel verschlüsseln möchten, ist die Funktion Bounding Polygon Queries standardmäßig deaktiviert. Dies liegt daran, dass durch die Verwendung dieser Funktion für Bounding Polygon Queries eine Darstellung Ihrer Gerätepositionen nicht mit Ihrem verwalteten Schlüssel verschlüsselt wird. AWS KMS Die genaue Geräteposition wird jedoch weiterhin mit Ihrem verwalteten Schlüssel verschlüsselt. Sie können sich für die Funktion Bounding Polygon Queries entscheiden, indem Sie den `KmsKeyEnableGeospatialQueries` Parameter bei der Erstellung oder Aktualisierung eines Trackers auf true setzen. ------ #### [ Console ] **Um einen Tracker mit der Amazon Location-Konsole zu erstellen** 1. Öffnen Sie die Amazon Location Service Service-Konsole unter [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. Wählen Sie im linken Navigationsbereich **Trackers** aus. 1. Wählen Sie **Tracker erstellen**. 1. Füllen Sie die folgenden Felder aus: + ****Name**** — Geben Sie einen eindeutigen Namen ein. Beispiel, *ExampleTracker*. Maximal 100 Zeichen. Gültige Einträge umfassen alphanumerische Zeichen, Bindestriche, Punkte und Unterstriche. + ****Beschreibung**** — Geben Sie eine optionale Beschreibung ein. 1. Wählen Sie unter **Positionsfilterung** die Option aus, die am besten zu Ihrer geplanten Nutzung Ihrer Tracker-Ressource passt. Wenn Sie die **Positionsfilterung** nicht einrichten, ist die Standardeinstellung`TimeBased`. Weitere Informationen finden Sie [Amazon Location Service Tracker](trackers.md) in diesem Handbuch und `[PositionFiltering](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html#location-WaypointTracking_CreateTracker-request-PositionFiltering)` in der Amazon Location Service Trackers API-Referenz. 1. (Optional) Geben Sie unter **Markierungen** einen Tag **Key (Schlüssel)** und einen **Value (Wert) ** ein. Dadurch wird Ihrer neuen Geofence-Sammlung ein Tag hinzugefügt. Weitere Informationen finden Sie unter [Wie benutzt man Tags](manage-resources.md#manage-resources_how-to). 1. (Optional) Unter Vom **Kunden verwaltete Schlüsselverschlüsselung** können Sie wählen, ob Sie **einen vom Kunden verwalteten Schlüssel hinzufügen** möchten. Dadurch wird ein symmetrischer, vom Kunden verwalteter Schlüssel hinzugefügt, den Sie erstellen, besitzen und verwalten, statt der standardmäßigen AWS Verschlüsselung. Weitere Informationen finden Sie unter [Daten im Ruhezustand verschlüsseln](encryption-at-rest.md). 1. (Optional) Unter können Sie wählen **KmsKeyEnableGeospatialQueries**, ob **Geodatenabfragen** aktiviert werden sollen. Auf diese Weise können Sie die Funktion Bounding Polygon Queries verwenden und gleichzeitig Ihre Daten mit einem vom Kunden AWS verwalteten KMS-Schlüssel verschlüsseln. **Anmerkung** Wenn Sie die Funktion Bounding Polygon Queries verwenden, wird eine Darstellung Ihrer Gerätepositionen nicht mit Ihrem verwalteten Schlüssel verschlüsselt. AWS KMS Die genaue Geräteposition wird jedoch weiterhin mit Ihrem verwalteten Schlüssel verschlüsselt. 1. (Optional) Unter **EventBridge Konfiguration** können Sie festlegen, ob EventBridge Ereignisse für gefilterte Positionsaktualisierungen aktiviert werden sollen. Dadurch wird jedes Mal ein Ereignis gesendet, wenn eine Positionsaktualisierung für ein Gerät in diesem Tracker der Bewertung der Positionsfilterung entspricht. 1. Wählen Sie **Tracker erstellen**. ------ #### [ API ] **So erstellen Sie einen Tracker mithilfe des Amazon-Standorts APIs** Verwenden Sie den `[CreateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html)` Vorgang von Amazon Location Trackers APIs aus. Das folgende Beispiel verwendet eine API-Anfrage, um einen Tracker namens *ExampleTracker* zu erstellen. Die Tracker-Ressource ist mit einem vom [Kunden verwalteten AWS KMS Schlüssel zur Verschlüsselung von Kundendaten](encryption-at-rest.md) verknüpft und [ermöglicht keine Positionsaktualisierungen in EventBridge](location-events.md#enable-update-events). ``` POST /tracking/v0/trackers Content-type: application/json { "TrackerName": "ExampleTracker", "Description": "string", "KmsKeyEnableGeospatialQueries": false, "EventBridgeEnabled": false, "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "PositionFiltering": "AccuracyBased", "Tags": { "string" : "string" } } ``` **Erstelle einen Tracker mit aktivierter Option `KmsKeyEnableGeospatialQueries`** Im folgenden Beispiel ist der Parameter auf true `KmsKeyEnableGeospatialQueries` gesetzt. Auf diese Weise können Sie die Funktion Bounding Polygon Queries verwenden und gleichzeitig Ihre Daten mit einem vom Kunden AWS KMS verwalteten Schlüssel verschlüsseln. Informationen zur Verwendung der Funktion Bounding Polygon Queries finden Sie unter [Ihre Gerätepositionen auflisten](list-device-positions.md) **Anmerkung** Wenn Sie die Funktion Bounding Polygon Queries verwenden, wird eine Darstellung Ihrer Gerätepositionen nicht mit Ihrem verwalteten Schlüssel verschlüsselt. AWS KMS Die genaue Geräteposition wird jedoch weiterhin mit Ihrem verwalteten Schlüssel verschlüsselt. ``` POST /tracking/v0/trackers Content-type: application/json { "TrackerName": "ExampleTracker", "Description": "string", "KmsKeyEnableGeospatialQueries": true, "EventBridgeEnabled": false, "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "PositionFiltering": "AccuracyBased", "Tags": { "string" : "string" } } ``` ------ #### [ AWS CLI ] **Um einen Tracker mithilfe von Befehlen zu erstellen AWS CLI ** Verwenden Sie den Befehl `[create-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/create-tracker.html)`. Das folgende Beispiel verwendet AWS CLI , um einen Tracker namens zu erstellen*ExampleTracker*. Die Tracker-Ressource ist mit einem vom [Kunden verwalteten AWS KMS Schlüssel zur Verschlüsselung von Kundendaten](encryption-at-rest.md) verknüpft und [ermöglicht keine Positionsaktualisierungen in EventBridge](location-events.md#enable-update-events). ``` aws location \ create-tracker \ --tracker-name "ExampleTracker" \ --position-filtering "AccuracyBased" \ --event-bridge-enabled false \ --kms-key-enable-geospatial-queries false \ --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab" ``` **Erstelle einen Tracker mit aktivierter Option `KmsKeyEnableGeospatialQueries`** Im folgenden Beispiel ist der Parameter auf true `KmsKeyEnableGeospatialQueries` gesetzt. Auf diese Weise können Sie die Funktion Bounding Polygon Queries verwenden und gleichzeitig Ihre Daten mit einem vom Kunden AWS KMS verwalteten Schlüssel verschlüsseln. Informationen zur Verwendung der Funktion Bounding Polygon Queries finden Sie unter [Ihre Gerätepositionen auflisten](list-device-positions.md) **Anmerkung** Wenn Sie die Funktion Bounding Polygon Queries verwenden, wird eine Darstellung Ihrer Gerätepositionen nicht mit Ihrem verwalteten Schlüssel verschlüsselt. AWS KMS Die genaue Geräteposition wird jedoch weiterhin mit Ihrem verwalteten Schlüssel verschlüsselt. ``` aws location \ create-tracker \ --tracker-name "ExampleTracker" \ --position-filtering "AccuracyBased" \ --event-bridge-enabled false \ --kms-key-enable-geospatial-queries true \ --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab" ``` ------ **Anmerkung** Die Abrechnung hängt von Ihrer Nutzung ab. Für die Nutzung anderer AWS Dienste können Gebühren anfallen. Weitere Informationen finden Sie unter [Amazon Location Service — Preise](https://aws.amazon.com/location/pricing/). Sie können die **Beschreibung**, die **Positionsfilterung** und die **EventBridge Konfiguration** bearbeiten, nachdem der Tracker erstellt wurde, indem Sie **Tracker bearbeiten** wählen. # Authentifizierung Ihrer Anfragen Sobald Sie eine Tracker-Ressource erstellt haben und bereit sind, Gerätepositionen anhand von Geofences zu bewerten, wählen Sie aus, wie Sie Ihre Anfragen authentifizieren möchten: + Informationen darüber, wie Sie auf die Dienste zugreifen können, finden Sie unter. [Authentifizieren Sie sich mit Amazon Location Service](access.md) + Wenn Sie Gerätepositionen mit nicht authentifizierten Anfragen veröffentlichen möchten, sollten Sie Amazon Cognito verwenden. **Beispiel** Das folgende Beispiel zeigt die Verwendung eines Amazon Cognito Cognito-Identitätspools für die Autorisierung mit [AWS JavaScript SDK v3](https://aws.amazon.com/sdk-for-javascript/) und dem Amazon-Standort[Web](how-to-auth-helper.md#loc-sdk-auth-web). ``` import { LocationClient, BatchUpdateDevicePositionCommand } from "@aws-sdk/client-location"; import { withIdentityPoolId } from "@aws/amazon-location-utilities-auth-helper"; // Unauthenticated identity pool you created const identityPoolId = "us-east-1:1234abcd-5678-9012-abcd-sample-id"; // Create an authentication helper instance using credentials from Cognito const authHelper = await withIdentityPoolId(identityPoolId); const client = new LocationClient({ region: "us-east-1", // The region containing both the identity pool and tracker resource ...authHelper.getLocationClientConfig(), // Provides configuration required to make requests to Amazon Location }); const input = { TrackerName: "ExampleTracker", Updates: [ { DeviceId: "ExampleDevice-1", Position: [-123.4567, 45.6789], SampleTime: new Date("2020-10-02T19:09:07.327Z"), }, { DeviceId: "ExampleDevice-2", Position: [-123.123, 45.123], SampleTime: new Date("2020-10-02T19:10:32Z"), }, ], }; const command = new BatchUpdateDevicePositionCommand(input); // Send device position updates const response = await client.send(command); ``` # Aktualisiere deinen Tracker mit einer Geräteposition 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"}}]' ``` ------ # Den Standortverlauf eines Geräts von einem Tracker abrufen Ihre Amazon Location Tracker-Ressource speichert den Standortverlauf all Ihrer verfolgten Geräte für einen Zeitraum von 30 Tagen. Sie können den Standortverlauf Ihres Geräts, einschließlich aller zugehörigen Metadaten, von Ihrer Tracker-Ressource abrufen. In den folgenden Beispielen wird der AWS CLI oder der Amazon-Standort verwendet APIs. ------ #### [ API ] **Um den Gerätestandortverlauf von einem Tracker mithilfe des Amazon-Standorts abzurufen APIs** Verwenden Sie den `[GetDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePositionHistory.html)` Vorgang von Amazon Location Trackers APIs aus. Das folgende Beispiel verwendet eine API-URI-Anforderung, um den Gerätestandortverlauf *ExampleDevice* von einem Tracker abzurufen, *ExampleTracker* der von `19:05:07` (einschließlich) aufgerufen wird und am `19:20:07` (exklusiv) endet. `2020–10–02` ``` POST /tracking/v0/trackers/ExampleTracker/devices/ExampleDevice/list-positions Content-type: application/json { "StartTimeInclusive": "2020-10-02T19:05:07.327Z", "EndTimeExclusive": "2020-10-02T19:20:07.327Z" } ``` ------ #### [ AWS CLI ] **Um den Gerätestandortverlauf mithilfe von AWS CLI Befehlen von einem Tracker abzurufen** Verwenden Sie den Befehl `[get-device-position-history](https://docs.aws.amazon.com/cli/latest/reference/location/get-device-position-history.html)`. Im folgenden Beispiel wird ein verwendet AWS CLI , um den Gerätestandortverlauf *ExampleDevice* von einem Tracker abzurufen, der von `19:05:07` (einschließlich) *ExampleTracker* beginnt und bei `19:20:07` (exklusiv) endet`2020–10–02`. ``` aws location \ get-device-position-history \ --device-id "ExampleDevice" \ --start-time-inclusive "2020-10-02T19:05:07.327Z" \ --end-time-exclusive "2020-10-02T19:20:07.327Z" \ --tracker-name "ExampleTracker" ``` ------ # Ihre Gerätepositionen auflisten Sie können eine Liste der Gerätepositionen für einen Tracker anzeigen AWS CLI, indem Sie die oder den Amazon-Standort APIs mit der ListDevicePositions API verwenden. Wenn Sie die ListDevicePositions API aufrufen, wird eine Liste der letzten Positionen für alle Geräte zurückgegeben, die mit einem bestimmten Tracker verknüpft sind. Standardmäßig gibt diese API 100 der neuesten Gerätepositionen pro Ergebnisseite für einen bestimmten Tracker zurück. Um nur Geräte innerhalb einer bestimmten Region zurückzugeben, verwenden Sie den `FilterGeometry` Parameter, um eine Bounding Polygon Query zu erstellen. Auf diese Weise werden beim Aufrufen nur Geräte ListDevicePositions zurückgegeben, die sich innerhalb des Polygons befinden. **Anmerkung** Wenn Sie Ihre Daten mit Ihrem eigenen, vom AWS KMS Kunden verwalteten Schlüssel verschlüsseln möchten, ist die Funktion Bounding Polygon Queries standardmäßig deaktiviert. Dies liegt daran, dass durch die Verwendung dieser Funktion eine Darstellung Ihrer Gerätepositionen nicht mit Ihrem AWS KMS verwalteten Schlüssel verschlüsselt wird. Die genaue Geräteposition wird jedoch weiterhin mit Ihrem verwalteten Schlüssel verschlüsselt. Sie können sich für die Funktion Bounding Polygon Queries entscheiden. Dies erfolgt, indem der `KmsKeyEnableGeospatialQueries` Parameter beim Erstellen oder Aktualisieren eines Trackers auf true gesetzt wird. ------ #### [ API ] Verwenden Sie den `[ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html)` Vorgang von den Amazon Location Trackers APIs aus. Das folgende Beispiel ist eine API-Anfrage zum Abrufen einer Liste von Gerätepositionen im polygonalen Bereich unter Verwendung des optionalen Parameters. `[FilterGeometry](https://docs.aws.amazon.com/)` Das Beispiel gibt 3 Gerätestandorte zurück, die in dem durch das `Polygon` Array definierten Bereich vorhanden sind. ``` POST /tracking/v0/trackers/TrackerName/list-positions HTTP/1.1 Content-type: application/json { "FilterGeometry": { "Polygon": [ [ [ -123.12003339442259, 49.27425121147397 ], [ -123.1176984148229, 49.277063620879744 ], [ -123.12389509145294, 49.277954183760926 ], [ -123.12755921328647, 49.27554025235713 ], [ -123.12330236586217, 49.27211836076236 ], [ -123.12003339442259, 49.27425121147397 ] ] ] }, "MaxResults": 3, "NextToken": "1234-5678-9012" } ``` Im Folgenden finden Sie eine Beispielantwort für`[ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html)`: ``` { "Entries": [ { "DeviceId": "1", "SampleTime": "2022-10-24T19:09:07.327Z", "Position": [ -123.12245146162303, 49.27521118043802 ], "Accuracy": { "Horizontal": 10 }, "PositionProperties": { "name": "device1" } }, { "DeviceId": "3", "SampleTime": "2022-10-02T19:09:07.327Z", "Position": [ -123.12325592118916, 49.27340530543111 ] }, { "DeviceId": "2", "SampleTime": "2022-10-02T19:09:07.327Z", "Position": [ -123.1230104928471, 49.27752402723152 ] } ], "NextToken": "1234-5678-9012" } ``` ------ #### [ CLI ] Verwenden Sie den Befehl `[list-trackers](https://docs.aws.amazon.com/cli/latest/reference/location/list-trackers.html)`. Das folgende Beispiel dient AWS CLI dazu, eine Liste von Geräten in einem polygonalen Gebiet abzurufen. ``` aws location list-device-positions TODO: add arguments add props for filter geo ``` ------