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.
Starten Sie die Nachverfolgung mit Amazon Location
In diesem Abschnitt erfahren Sie, wie Sie eine Tracking-Anwendung erstellen, die Gerätestandorte erfasst.
Themen
Erstellen Sie einen Tracker
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 verwendenAPIs.
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 wird 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 durch viele Umweltfaktoren beeinflusst, darunter GPS Satellitenempfang, Landschaft und die 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
AccuracyBasedFilterung 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.
DistanceBasedBeim Filtern werden Standortaktualisierungen ignoriert, bei denen sich Geräte weniger als 30 m (98,4 ft) bewegt haben. Wenn Sie dieDistanceBasedPositionsfilterung 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
DistanceBasedFilterung 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
TimeBasedFilterung 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 als zwei Auswertungen der Geofence-Erfassung. Wenn Sie Positionsaktualisierungen für Ihre Geräte alle 5 Sekunden melden und zeitbasierte Filterung verwenden, werden Ihnen 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 Tutorial: Einen Tracker mit einer Geofence-Sammlung in Amazon Location verknüpfen.
Sie können Ereignisse für alle gefilterten Positionsaktualisierungen für eine Tracker-Ressource aktivieren. Weitere Informationen finden Sie unter Aktivieren von Aktualisierungsereignissen für einen Tracker.
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 dem von Ihnen 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.
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
Sie können die Beschreibung, die Positionsfilterung und die EventBridge Konfiguration bearbeiten, nachdem der Tracker erstellt wurde, indem Sie Tracker bearbeiten wählen.
Authentifizieren Sie Ihre 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 Zugriff auf Amazon Location Service.
-
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 SDKv3
und dem Amazon-StandortJavaScript Authentifizierungshelfer. 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);
Aktualisieren Sie Ihren 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 unterErstellen Sie einen Tracker.
Weitere Informationen zu Geofence-Ereignissen finden Sie unter. Reagieren auf Amazon Location Service-Ereignisse mit Amazon EventBridge
Verwenden Sie eine der folgenden Methoden, um Geräteaktualisierungen zu senden:
-
Senden Sie MQTT Updates an eine AWS IoT Core-Ressource und verknüpfen Sie sie mit Ihrer Tracker-Ressource.
-
Senden Sie Standortaktualisierungen mit den Amazon Location TrackersAPI, indem Sie den AWS CLI oder den Amazon-Standort APIs verwenden. Sie können das verwenden AWS SDKs, um das APIs von Ihrer iOS- oder Android-Anwendung aus aufzurufen.
Rufen Sie den Standortverlauf eines Geräts von einem Tracker ab
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 verwendetAPIs.
Listen Sie Ihre Gerätepositionen auf
Sie können eine Liste der Gerätepositionen für einen Tracker anzeigen AWS CLI, indem Sie den oder den Amazon-Standort APIs mit dem verwenden ListDevicePositions API. Wenn Sie den aufrufen ListDevicePositions API, wird eine Liste der letzten Positionen für alle Geräte zurückgegeben, die mit einem bestimmten Tracker verknüpft sind. Standardmäßig werden 100 der neuesten Gerätepositionen pro Ergebnisseite für einen bestimmten Tracker API zurückgegeben. 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. Dazu setzen Sie den KmsKeyEnableGeospatialQueries Parameter bei der Erstellung oder Aktualisierung eines Trackers auf true.
