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.
# Amazon Location Service Tracker
![\[Dieses Diagramm zeigt Ihnen, wie Sie Tracker-Ressourcen erstellen und verwenden.\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/images/illustration-trackers.PNG)
**Anmerkung**
Der Tracker-Speicher wird automatisch mit AWS eigenen Schlüsseln verschlüsselt. Sie können mithilfe von KMS-Schlüsseln, die Sie verwalten, eine weitere Verschlüsselungsebene hinzufügen, um sicherzustellen, dass nur Sie auf Ihre Daten zugreifen können. Weitere Informationen finden Sie unter [Datenverschlüsselung im Ruhezustand für Amazon Location Service](encryption-at-rest.md).
Ein Tracker speichert Positionsaktualisierungen für eine Sammlung von Geräten. Der Tracker kann verwendet werden, um den aktuellen Standort oder den Standortverlauf der Geräte abzufragen. Er speichert die Updates, reduziert aber den Speicherplatz und das visuelle Rauschen, indem die Standorte vor dem Speichern gefiltert werden.
Jedes in Ihren Tracker-Ressourcen gespeicherte Positionsupdate kann ein Maß für die Positionsgenauigkeit und bis zu 3 Felder mit Metadaten über die Position oder das Gerät, das Sie speichern möchten, enthalten. Die Metadaten werden als Schlüssel-Wert-Paare gespeichert und können Informationen wie Geschwindigkeit, Richtung, Reifendruck oder Motortemperatur speichern.
Die Positionsfilterung und -abfrage von Trackern sind für sich genommen nützlich, aber Tracker sind besonders nützlich, wenn sie mit Geofences kombiniert werden. Sie können Tracker mit einer oder mehreren Ressourcen für Ihre Geofence-Erfassung verknüpfen. Positionsaktualisierungen werden dann automatisch anhand der Geofences in diesen Sammlungen ausgewertet. Durch den richtigen Einsatz von Filtern können Sie auch die Kosten für Ihre Geofence-Bewertungen erheblich senken.
1. Zunächst erstellen Sie eine Tracker-Ressource in Ihrem AWS Konto.
1. Als Nächstes entscheiden Sie, wie Sie Standortaktualisierungen an Ihre Tracker-Ressourcen senden. Verwenden Sie diese [AWS SDKs](dev-sdks.md)Option, um Tracking-Funktionen in Ihre mobilen Anwendungen zu integrieren. Alternativ können Sie MQTT verwenden, indem Sie den step-by-step Anweisungen zur [Nachverfolgung mit](tracking-using-mqtt.md) MQTT folgen.
1. Sie können jetzt Ihre Tracker-Ressource verwenden, um den Standortverlauf aufzuzeichnen und ihn auf einer Karte zu visualisieren.
1. Sie können Ihre Tracker-Ressource auch mit einer oder mehreren Geofence-Sammlungen verknüpfen, sodass jede an Ihre Tracker-Ressource gesendete Positionsaktualisierung automatisch mit allen Geofence-Daten in allen verknüpften Geofence-Sammlungen verglichen wird. Sie können Ressourcen auf der Seite mit den Tracker-Ressourcendetails der Amazon Location-Konsole oder mithilfe der Amazon Location Trackers API verknüpfen.
1. Anschließend können Sie die Überwachung mithilfe von Diensten wie Amazon CloudWatch und integrieren AWS CloudTrail. Weitere Informationen finden Sie unter [Überwachen Sie mit Amazon CloudWatch](cloudwatch.md) und[Überwachen und protokollieren mit AWS CloudTrail](cloudtrail.md).
## Features
+ **Positionsfilterung** — Tracker können die Positionen, die an sie gesendet werden, automatisch filtern. Es gibt mehrere Gründe, warum Sie möglicherweise einige Aktualisierungen Ihres Gerätestandorts herausfiltern möchten. Wenn Sie über ein System verfügen, das nur etwa jede Minute Berichte sendet, sollten Sie Geräte nach Zeit filtern und Positionen nur alle 30 Sekunden speichern und auswerten. Auch wenn Sie häufiger überwachen, empfiehlt es sich, Positionsaktualisierungen zu filtern, um das mit GPS-Hardware und Positionsberichten verbundene Rauschen zu beseitigen. Ihre Genauigkeit ist nicht zu 100% perfekt, sodass sich selbst ein stationäres Gerät leicht zu bewegen scheint. Bei niedrigen Geschwindigkeiten verursacht dieses *Zittern* ein unübersichtliches Bild und kann zu falschen Ein- und Austrittsereignissen führen, wenn sich das Gerät in der Nähe des Randes eines Geofences befindet.
Die Positionsfilterung funktioniert, wenn Positionsaktualisierungen von einem Tracker empfangen werden. Dadurch wird das visuelle Rauschen auf Ihren Gerätepfaden (Jitter) reduziert, die Anzahl falscher Geofence-Ein- und Austrittsereignisse reduziert und die Kosten gesenkt, indem die Anzahl der gespeicherten Positionsaktualisierungen und der ausgelösten Geofence-Bewertungen reduziert wird.
Tracker bieten drei Optionen zur Positionsfilterung, um die Kosten im Griff zu behalten und das Jitter bei Ihren Standortaktualisierungen zu reduzieren.
+ **Genauigkeitsbasiert — Kann** *mit jedem Gerät verwendet werden, das Genauigkeitsmessungen ermöglicht. Die meisten GPS- und Mobilgeräte liefern diese Informationen.*
Die Genauigkeit jeder Positionsmessung wird durch viele Umweltfaktoren beeinflusst, darunter den GPS-Satellitenempfang, die Landschaft und die Nähe von WiFi 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 wird, wird sie als Null behandelt, und die Messung wird als absolut genau angesehen, und es wird keine Filterung auf die Aktualisierungen angewendet.
**Anmerkung**
Sie können die 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.
Entfernungsbasierte Filterung ist nützlich, wenn Sie zwar filtern möchten, Ihr Gerät aber keine Genauigkeitsmessungen liefert, oder wenn Sie eine größere Anzahl von Aktualisierungen herausfiltern möchten als bei genauigkeitsbasierter Filterung.
+ **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.
Zeitbasierte Filterung ist besonders nützlich, wenn Sie weniger Positionen speichern möchten, aber möchten, dass jede Positionsaktualisierung anhand der zugehörigen Geofence-Sammlungen ausgewertet wird.
**Anmerkung**
Denken Sie bei der Entscheidung über Ihre Filtermethode und die Häufigkeit der 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 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.
## Anwendungsfälle für Amazon Location Service Tracker
Im Folgenden sind einige gängige Verwendungszwecke für Amazon Location Service Tracker aufgeführt.
**Verwenden Sie Tracker mit Geofences**
Tracker bieten zusätzliche Funktionen, wenn sie mit Geofences kombiniert werden. Sie verknüpfen einen Tracker mit einer Geofence-Erfassung, entweder über die Amazon Location Console oder die API, um Tracker-Standorte automatisch auszuwerten. Jedes Mal, wenn der Tracker einen aktualisierten Standort erhält, wird dieser Standort mit jedem Geofence in der Sammlung verglichen, und die entsprechenden `ENTER` `EXIT` Ereignisse werden in Amazon generiert. EventBridge Sie können auch Filter auf den Tracker anwenden und je nach Filterung die Kosten für Geofence-Bewertungen senken, indem Sie nur aussagekräftige Standortaktualisierungen auswerten.
Wenn Sie den Tracker einer Geofence-Sammlung zuordnen, nachdem er bereits einige Positionsaktualisierungen erhalten hat, wird das erste Positionsupdate nach der Zuordnung als erstes Update für die Geofence-Bewertungen behandelt. Wenn es sich innerhalb eines Geofence-Bereichs befindet, erhältst du ein Ereignis. `ENTER` Wenn es sich nicht innerhalb eines Geofences befindet, erhältst du kein `EXIT` Ereignis, unabhängig vom vorherigen Status.
**Verbessern Sie den Außendienstbetrieb**
Behalten Sie mit Echtzeit-Tracking den Überblick über Ihre mobilen Mitarbeiter. Richten Sie Geofences rund um Kundenstandorte und Servicebereiche ein, um Benachrichtigungen zu erhalten, wenn Mitarbeiter an- und abreisen. Verwenden Sie Standortdaten, um die Planung zu optimieren, den nächstgelegenen verfügbaren Techniker zu entsenden und die Reaktionszeiten zu verkürzen. Geben Sie Ihren Außendienstteams (z. B. Ihrem Sanitär- oder HLK-Reparaturunternehmen) die Möglichkeit, effizienter zu arbeiten und gleichzeitig das Kundenerlebnis zu verbessern.
**Überwachen und kontrollieren Sie kritische Anlagen**
Nutzen Sie Amazon Location Service, um den Standort und den Status Ihrer wertvollen Ausrüstung, Ihres Inventars und anderer mobiler Ressourcen in Echtzeit zu verfolgen. Richten Sie Geofences ein, um Benachrichtigungen über unbefugte Bewegungen oder Entfernungen zu erhalten, und erhöhen Sie so die Sicherheit und die Einhaltung von Vorschriften. Nutzen Sie diese Standorttransparenz, um die Anlagenauslastung zu verbessern, Wartungspläne zu optimieren und sicherzustellen, dass Ihre kritischen Ressourcen jederzeit berücksichtigt werden. Überwachen Sie Ihre Schwermaschinen, IT-Hardware oder den Lagerbestand im Einzelhandel stets präzise, reduzieren Sie Verluste und treffen Sie fundiertere betriebliche Entscheidungen.
**Verbessern Sie die Transparenz Ihrer Lieferkette**
Nutzen Sie Amazon Location Service, um Sendungen und Lieferungen in Ihrer gesamten Lieferkette zu verfolgen. Definieren Sie Geofences rund um Vertriebszentren, Geschäfte und andere wichtige Einrichtungen, um die Bewegung von Inventar und Anlagen zu überwachen. Verwenden Sie Standortdaten in Echtzeit, um die Bestandsverwaltung zu verbessern, die Logistikplanung zu optimieren und ein hervorragendes Kundenerlebnis zu bieten. Verschaffen Sie sich einen end-to-end Überblick über Ihre Lieferkettenabläufe, identifizieren Sie Engpässe und treffen Sie datengestützte Entscheidungen, die die Effizienz und Reaktionsfähigkeit steigern.
**Standortbezogenes Marketing**
Nutzen Sie das Potenzial von Standortdaten, um Ihre Geomarketing-Bemühungen zu beschleunigen. Verwenden Sie Amazon Location Service, um virtuelle Grenzen zwischen Standorten, Veranstaltungen und stark frequentierten Bereichen von Wettbewerbern festzulegen. Schalten Sie personalisierte Anzeigen, Angebote und Benachrichtigungen aus, wenn Kunden diese Zonen mit Geofencing betreten. Analysieren Sie die Besucherzahlen, um die Platzierung von Anzeigen zu optimieren und erstklassige Standorte für neue Geschäftsstandorte zu finden. Überwachen Sie die Kundenbewegungen in Ihren eigenen geografisch abgegrenzten Bereichen, um tiefere Einblicke in das Surfverhalten zu erhalten und. path-to-purchase Kombinieren Sie Standortverfolgung in Echtzeit mit präzisem Geofencing, um eine zielgerichtete, kontextbezogene Interaktion zu erzielen, die den Umsatz und die Kundenbindung in der physischen Welt fördert.
# Tracker-Konzepte
In diesem Abschnitt werden gängige Tracker-Konzepte beschrieben.
## Allgemeine Terminologie von Amazon Location Service Trackern
**Tracker-Ressource**
Eine AWS Ressource, die Standortaktualisierungen von Geräten empfängt. Die Tracker-Ressource bietet Unterstützung für Standortabfragen, z. B. für den aktuellen und historischen Gerätestandort. Beim Verknüpfen einer Tracker-Ressource mit einer Geofence-Sammlung werden Standortaktualisierungen automatisch mit allen Geofences in der verknüpften Geofence-Sammlung verglichen.
**Nachverfolgte Positionsdaten**
Eine Tracker-Ressource speichert Informationen über Ihre Geräte im Laufe der Zeit. Die Informationen umfassen eine Reihe von Positionsaktualisierungen, wobei jedes Update Standort, Uhrzeit und optionale Metadaten enthält. Die Metadaten können die Genauigkeit einer Position und bis zu drei Schlüsselwertpaare enthalten, mit deren Hilfe Sie wichtige Informationen zu jeder Position verfolgen können, z. B. Geschwindigkeit, Richtung, Reifendruck, verbleibenden Kraftstoff oder Motortemperatur des Fahrzeugs, das Sie verfolgen. Tracker speichern den Gerätestandortverlauf für 30 Tage.
**Filterung von Positionen**
Mithilfe von Positionsfiltern können Sie die Kosten kontrollieren und die Qualität Ihrer Tracking-Anwendung verbessern, indem Positionsaktualisierungen, die keine wertvollen Informationen liefern, herausgefiltert werden, bevor die Aktualisierungen gespeichert oder anhand von Geofences ausgewertet werden.
Sie können wählen `AccuracyBased``DistanceBased`, oder `TimeBased` filtern. Standardmäßig ist die Positionsfilterung auf eingestellt`TimeBased`.
Sie können die Positionsfilterung konfigurieren, wenn Sie Tracker-Ressourcen erstellen oder aktualisieren.
**Zeitstempelformat nach RFC 3339 **
Amazon Location Service Tracker verwenden das [RFC 3339-Format](https://tools.ietf.org/html/rfc3339), das dem Format [8601 der International Organization for Standardization (ISO)](https://www.iso.org/iso-8601-date-and-time-format.html) für Datum und Uhrzeit folgt.
Das Format ist „YYYY-MM-:mm:ss.sssz\$1 00:00 „: DDThh
+ `YYYY-MM-DD`— Stellt das Datumsformat dar.
+ `T`— Zeigt an, dass die Zeitwerte folgen werden.
+ `hh:mm:ss.sss`— Stellt die Uhrzeit im 24-Stunden-Format dar.
+ `Z`— Gibt an, dass die verwendete Zeitzone UTC ist, worauf Abweichungen von der UTC-Zeitzone folgen können.
+ `+00:00`— Geben Sie optional Abweichungen von der UTC-Zeitzone an. Zum Beispiel bedeutet \$1 01:00 UTC \$1 1 Stunde.
**Beispiel**
Für den 2. Juli 2020 um 12:15:20 Uhr nachmittags, mit einer Anpassung um weitere 1 Stunde an die UTC-Zeitzone.
```
2020-07-02T12:15:20.000Z+01:00
```
# 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
```
------
# So arbeiten Sie mit Amazon Location Service Trackern
Dieser Abschnitt enthält Anweisungen für die Arbeit mit Amazon Location Trackern. Erfahren Sie, wie Sie Gerätepositionen verifizieren, Tracker mit Geofence-Sammlungen verknüpfen und Standorte mithilfe von AWS IoT und MQTT verfolgen können. Darüber hinaus erfahren Sie, wie Sie Ihre Tracker effektiv verwalten können, um Ihre standortbezogenen Anwendungen zu unterstützen und ein genaues Tracking in Echtzeit zu gewährleisten.
**Topics**
+ [Überprüfen Sie die Gerätepositionen](verify-device-positions.md)
+ [Einen Tracker mit einer Geofence-Sammlung verknüpfen](associate-consumer.md)
+ [Nutzung AWS IoT und MQTT mit Amazon Location Service verfolgen](tracking-using-mqtt.md)
+ [Verwalte deinen Amazon Location Service Tracker](managing-trackers.md)
# Überprüfen Sie die Gerätepositionen
Verwenden Sie die [VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)API, um die Integrität einer Geräteposition zu überprüfen. Diese API gibt Informationen über die Integrität der Geräteposition zurück, indem sie Eigenschaften wie das Mobilfunksignal des Geräts, den Wi-Fi-Zugangspunkt, die IPv4-Adresse und die Verwendung eines Proxys auswertet.
## Voraussetzungen
Bevor Sie die aufgelisteten Funktionen APIs zur Geräteverifizierung verwenden können, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllen:
+ Sie haben einen Tracker für das Gerät oder die Geräte erstellt, die Sie überprüfen möchten. Weitere Informationen finden Sie unter [Erste Schritte mit Amazon Location Service Trackern](start-tracking.md).
Das folgende Beispiel zeigt eine Anfrage für die Amazon Location [VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)API.
------
#### [ API ]
**Um Gerätepositionen mithilfe des Amazon-Standorts zu überprüfen APIs**
Verwenden Sie den `[VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)` Vorgang von Amazon Location Tracking aus APIs.
Das folgende Beispiel zeigt eine API-Anfrage zur Bewertung der Integrität der Position eines Geräts. Ersetzen Sie diese Werte durch Ihr eigenes Gerät IDs.
```
POST /tracking/v0/trackers/TrackerName/positions/verify HTTP/1.1
Content-type: application/json
{
"DeviceState": {
"Accuracy": {
"Horizontal": number
},
"CellSignals": {
"LteCellDetails": [
{
"CellId": number,
"LocalId": {
"Earfcn": number,
"Pci": number
},
"Mcc": number,
"Mnc": number,
"NetworkMeasurements": [
{
"CellId": number,
"Earfcn": number,
"Pci": number,
"Rsrp": number,
"Rsrq": number
}
],
"NrCapable": boolean,
"Rsrp": number,
"Rsrq": number,
"Tac": number,
"TimingAdvance": number
}
]
},
"DeviceId": "ExampleDevice",
"Ipv4Address": "string",
"Position": [ number ],
"SampleTime": "string",
"WiFiAccessPoints": [
{
"MacAddress": "string",
"Rss": number
}
]
},
"DistanceUnit": "string"
}
```
------
**Anmerkung**
Das **Integrity SDK** bietet erweiterte Funktionen im Zusammenhang mit der Geräteverifizierung und kann auf Anfrage verwendet werden. Um Zugriff auf das SDK zu erhalten, wenden Sie sich an den [Vertriebssupport](https://aws.amazon.com/contact-us/sales-support/?pg=locationprice&cta=herobtn).
# Einen Tracker mit einer Geofence-Sammlung verknüpfen
Da Sie nun über eine Geofence-Sammlung und einen Tracker verfügen, können Sie sie miteinander verknüpfen, sodass Standortaktualisierungen automatisch anhand all Ihrer Geofences ausgewertet werden. Wenn Sie nicht alle Standortaktualisierungen auswerten möchten oder wenn Sie einige Ihrer Standorte nicht in einer Tracker-Ressource speichern, können Sie bei Bedarf [Gerätepositionen mit Geofences vergleichen](https://docs.aws.amazon.com/location/latest/developerguide/evaluate-geofences.html).
Wenn Gerätepositionen anhand von Geofences bewertet werden, werden Ereignisse generiert. Sie können eine Aktion für diese Ereignisse festlegen. Weitere Informationen zu Aktionen, die Sie für Geofence-Ereignisse festlegen können, finden Sie unter [Reagieren auf Amazon Location Service Service-Ereignisse mit Amazon](https://docs.aws.amazon.com/location/latest/developerguide/location-events.html). EventBridge
Ein Amazon-Standortereignis umfasst die Attribute der Gerätepositions-Aktualisierung, die es generiert, und einige Attribute des Geofence-Bereichs, der eingegeben oder verlassen wird. Weitere Informationen zu den in einem Geofence-Ereignis enthaltenen Daten finden Sie unter. [Beispiele für EventBridge Amazon-Veranstaltungen für Amazon Location Service](location-events.md#example-event)
In den folgenden Beispielen wird eine Tracker-Ressource über die Konsole, den oder den Amazon-Standort mit einer Geofence-Sammlung verknüpft. AWS CLI APIs
------
#### [ Console ]
**So verknüpfen Sie mithilfe der Amazon Location Service Service-Konsole eine Tracker-Ressource mit einer Geofence-Sammlung**
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 unter **Geräte-Tracker** den Namenslink des Ziel-Trackers aus.
1. Wählen Sie unter **Verknüpfte Geofence-Sammlungen** die Option Geofence-Sammlung **verknüpfen** aus.
1. Wählen Sie im Fenster **Verknüpfte Geofence-Sammlung eine Geofence-Sammlung** aus dem Drop-down-Menü aus.
1. Wählen Sie **Verknüpfen**.
**Nachdem Sie die Tracker-Ressource verknüpft haben, wird ihr der Status Aktiv zugewiesen.**
------
#### [ API ]
**Um eine Tracker-Ressource mithilfe des Amazon-Standorts mit einer Geofence-Sammlung zu verknüpfen APIs**
Verwenden Sie den `[AsssociateTrackerConsumer](https://docs.aws.amazon.com/location-trackers/latest/APIReference/API_AssociateTrackerConsumer.html)` Vorgang von Amazon Location Trackers APIs aus.
Im folgenden Beispiel wird eine API-Anfrage verwendet, die mithilfe ihres [Amazon-Ressourcennamens](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) (ARN) *ExampleTracker* mit einer Geofence-Sammlung verknüpft wird.
```
POST /tracking/v0/trackers/ExampleTracker/consumers
Content-type: application/json
{
"ConsumerArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection"
}
```
------
#### [ AWS CLI ]
**Um eine Tracker-Ressource mithilfe von Befehlen mit einer Geofence-Sammlung zu verknüpfen AWS CLI **
Verwenden Sie den Befehl `[associate-tracker-consumer](https://docs.aws.amazon.com/cli/latest/reference/location/associate-tracker-consumer.html)`.
Im folgenden Beispiel wird eine AWS CLI zur Erstellung einer Geofence-Sammlung namens verwendet. *ExampleGeofenceCollection*
```
aws location \
associate-tracker-consumer \
--consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection" \
--tracker-name "ExampleTracker"
```
------
# Nutzung AWS IoT und MQTT mit Amazon Location Service verfolgen
[MQTT](http://mqtt.org/) ist ein leichtes und weit verbreitetes Messaging-Protokoll, das für eingeschränkte Geräte entwickelt wurde. AWS IoT Core unterstützt Geräteverbindungen, die das MQTT-Protokoll und das WSS-Protokoll (MQTT over WebSocket Secure) verwenden.
[AWS IoT Core](https://aws.amazon.com/iot-core/)verbindet Geräte mit ihnen AWS und ermöglicht es Ihnen, Nachrichten zwischen ihnen zu senden und zu empfangen. Die AWS IoT Core Regel-Engine speichert Anfragen zu den Nachrichtenthemen Ihrer Geräte und ermöglicht es Ihnen, Aktionen für das Senden von Nachrichten an andere AWS Dienste wie Amazon Location Service zu definieren. Geräte, die ihren Standort als Koordinaten kennen, können ihre Standorte über die Regel-Engine an Amazon Location weiterleiten lassen.
**Anmerkung**
Geräte können ihre eigene Position kennen, zum Beispiel über integriertes GPS. AWS IoT unterstützt auch die Standortverfolgung von Geräten von Drittanbietern. Weitere Informationen finden Sie unter [Standort des AWS IoT Kerngeräts](https://docs.aws.amazon.com/iot/latest/developerguide/device-location.html) im *AWS IoT Core Developer Guide*.
In der folgenden exemplarischen Vorgehensweise wird das Tracking mithilfe von AWS IoT Core Regeln beschrieben. Sie können die Geräteinformationen auch an Ihre eigene AWS Lambda Funktion senden, wenn Sie sie verarbeiten müssen, bevor Sie sie an Amazon Location senden. Weitere Informationen zur Verwendung von Lambda zur Verarbeitung Ihrer Gerätestandorte finden Sie unter[AWS Lambda Mit MQTT verwenden](tracking-using-mqtt-with-lambda.md).
**Topics**
+ [Voraussetzung](#mqtt-prerequisite)
+ [Erstellen Sie eine AWS IoT Core Regel](#mqtt-create-iot-rule)
+ [Testen Sie Ihre AWS IoT Core Regel in der Konsole](#mqtt-test-iot-rule)
+ [AWS Lambda Mit MQTT verwenden](tracking-using-mqtt-with-lambda.md)
## Voraussetzung
Bevor Sie mit dem Tracking beginnen können, müssen Sie die folgenden Voraussetzungen erfüllen:
+ [Erstellen Sie eine Tracker-Ressource](start-create-tracker.md), an die Sie die Standortdaten des Geräts senden möchten.
+ [Erstellen Sie eine IAM-Rolle](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-role.html), um AWS IoT Core Zugriff auf Ihren Tracker zu gewähren.
Wenn Sie diese Schritte ausführen, verwenden Sie die folgende Richtlinie, um Zugriff auf Ihren Tracker zu gewähren:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "WriteDevicePosition",
"Effect": "Allow",
"Action": "geo:BatchUpdateDevicePosition",
"Resource": "arn:aws:geo:*:*:tracker/*"
}
]
}
```
## Erstellen Sie eine AWS IoT Core Regel
Erstellen Sie als Nächstes eine AWS IoT Core Regel, um die Positionstelemetrie Ihrer Geräte an Amazon Location Service weiterzuleiten. *Weitere Informationen zum Erstellen von Regeln finden Sie in den folgenden Themen im AWS IoT Core Entwicklerhandbuch:*
+ [Eine AWS IoT Regel erstellen](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-rule.html) für Informationen zum Erstellen einer neuen Regel.
+ [Standortaktion](https://docs.aws.amazon.com/iot/latest/developerguide/location-rule-action.html) für spezifische Informationen zur Erstellung einer Regel für die Veröffentlichung auf Amazon Location
## Testen Sie Ihre AWS IoT Core Regel in der Konsole
Wenn derzeit keine Geräte Telemetriedaten veröffentlichen, die den Standort enthalten, können Sie Ihre Regel mit der AWS IoT Core Konsole testen. Die Konsole verfügt über einen Testclient, auf dem Sie eine Beispielnachricht veröffentlichen können, um die Ergebnisse der Lösung zu überprüfen.
1. Melden Sie sich bei der AWS IoT Core Konsole an unter [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home).
1. Erweitern Sie in der linken Navigationsleiste **Test** und wählen Sie **MQTT-Testclient** aus.
1. Legen Sie unter In **einem Thema veröffentlichen** den **Themennamen** auf fest *iot/topic* (oder den Namen des Themas, das Sie in Ihrer AWS IoT Core Regel eingerichtet haben, falls anders) und geben Sie Folgendes für die **Nachrichten-Payload** ein. Ersetzen Sie den Zeitstempel *1604940328* durch einen gültigen Zeitstempel innerhalb der letzten 30 Tage (alle Zeitstempel, die älter als 30 Tage sind, werden von Amazon Location Service Trackern ignoriert).
```
{
"payload": {
"deviceid": "thing123",
"timestamp": 1604940328,
"location": { "lat": 49.2819, "long": -123.1187 },
"accuracy": { "Horizontal": 20.5 },
"positionProperties": { "field1": "value1", "field2": "value2" }
}
}
```
1. Wählen Sie Im Thema **veröffentlichen**, um die Testnachricht zu senden.
1. Verwenden Sie den folgenden AWS CLI Befehl, um zu überprüfen, ob die Nachricht von Amazon Location Service empfangen wurde. Wenn Sie ihn während der Einrichtung geändert haben, ersetzen Sie den Tracker-Namen durch den Namen, den Sie verwendet haben.
```
aws location batch-get-device-position --tracker-name MyTracker --device-ids thing123
```
# AWS Lambda Mit MQTT verwenden
AWS Lambda Die Verwendung ist zwar nicht mehr erforderlich, wenn Gerätestandortdaten zur Nachverfolgung an Amazon Location gesendet werden, aber in einigen Fällen möchten Sie Lambda möglicherweise trotzdem verwenden. Zum Beispiel, wenn Sie die Standortdaten Ihres Geräts selbst verarbeiten möchten, bevor Sie sie an Amazon Location senden. In den folgenden Themen wird beschrieben, wie Sie Lambda verwenden, um Nachrichten zu verarbeiten, bevor Sie sie an Ihren Tracker senden. Weitere Informationen zu diesem Muster finden Sie in der [Referenzarchitektur.](https://d1.awsstatic.com/architecture-diagrams/ArchitectureDiagrams/amazon-location-service-ra.pdf)
**Topics**
+ [Voraussetzung](#mqtt-prerequisite-with-lambda)
+ [Erstellen einer Lambda-Funktion](#mqtt-with-lambda-create-lambda)
+ [Erstellen Sie eine AWS IoT Core Regel](#mqtt-create-iot-rule-with-lambda)
+ [Testen Sie Ihre AWS IoT Core Regel in der Konsole](#mqtt-test-iot-rule-with-lambda)
## Voraussetzung
Bevor Sie mit dem Tracking beginnen können, müssen Sie [eine Tracker-Ressource erstellen](start-tracking.md). Um eine Tracker-Ressource zu erstellen, können Sie die Amazon Location-Konsole AWS CLI, den oder den Amazon-Standort verwenden APIs.
Das folgende Beispiel verwendet die Amazon Location Service Service-Konsole, um die Tracker-Ressource 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** aus.
1. Füllen Sie die folgenden Felder aus:
+ **Name** — Geben Sie einen eindeutigen Namen mit maximal 100 Zeichen ein. Gültige Einträge enthalten alphanumerische Zeichen, Bindestriche und Unterstriche. Beispiel, *MyTracker*.
+ **Beschreibung** — Geben Sie eine optionale Beschreibung ein. Beispiel, *Tracker for storing AWS IoT Core device positions*.
+ **Positionsfilterung** — Wählen Sie die Filterung aus, die Sie für Positionsaktualisierungen verwenden möchten. Zum Beispiel **genauigkeitsbasierte Filterung**.
1. **Wählen Sie Tracker erstellen.**
## Erstellen einer Lambda-Funktion
Um eine Verbindung zwischen AWS IoT Core und Amazon Location Service herzustellen, benötigen Sie eine AWS Lambda Funktion zur Verarbeitung von weitergeleiteten Nachrichten AWS IoT Core. Diese Funktion extrahiert alle Positionsdaten, formatiert sie für Amazon Location Service und übermittelt sie über die Amazon Location Tracker-API. Sie können diese Funktion über die AWS Lambda Konsole erstellen, oder Sie können die AWS Command Line Interface (AWS CLI) oder die AWS Lambda APIs verwenden.
So erstellen Sie eine Lambda-Funktion, die mithilfe der Konsole Positionsaktualisierungen für Amazon Location veröffentlicht:
1. Öffnen Sie die AWS Lambda Konsole unter. [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/home)
1. Wählen Sie in der linken Navigationsleiste **Funktionen** aus.
1. Wählen Sie „**Funktion erstellen**“ und stellen Sie sicher, dass „**Von Grund auf neu erstellen**“ ausgewählt ist.
1. Füllen Sie die folgenden Felder aus:
+ **Funktionsname** — Geben Sie einen eindeutigen Namen für Ihre Funktion ein. Gültige Einträge beinhalten alphanumerische Zeichen, Bindestriche und Unterstriche ohne Leerzeichen. Beispiel, *MyLambda*.
+ **Runtime — Wählen Sie.** *Python 3.8*
1. Wählen Sie **Funktion erstellen**.
1. Wählen Sie die Registerkarte **Code**, um den Editor zu öffnen.
1. [Überschreiben Sie den Platzhaltercode `lambda_function.py` mit dem Folgenden und ersetzen Sie den `TRACKER_NAME` zugewiesenen Wert durch den Namen des Trackers, den Sie als Voraussetzung erstellt haben.](#mqtt-prerequisite-with-lambda)
```
from datetime import datetime
import json
import os
import boto3
# Update this to match the name of your Tracker resource
TRACKER_NAME = "MyTracker"
"""
This Lambda function receives a payload from AWS IoT Core and publishes device updates to
Amazon Location Service via the BatchUpdateDevicePosition API.
Parameter 'event' is the payload delivered from AWS IoT Core.
In this sample, we assume that the payload has a single top-level key 'payload' and a nested key
'location' with keys 'lat' and 'long'. We also assume that the name of the device is nested in
the payload as 'deviceid'. Finally, the timestamp of the payload is present as 'timestamp'. For
example:
>>> event
{ 'payload': { 'deviceid': 'thing123', 'timestamp': 1604940328,
'location': { 'lat': 49.2819, 'long': -123.1187 },
'accuracy': {'Horizontal': 20.5 },
'positionProperties': {'field1':'value1','field2':'value2'} }
}
If your data doesn't match this schema, you can either use the AWS IoT Core rules engine to
format the data before delivering it to this Lambda function, or you can modify the code below to
match it.
"""
def lambda_handler(event, context):
update = {
"DeviceId": event["payload"]["deviceid"],
"SampleTime": datetime.fromtimestamp(event["payload"]["timestamp"]).strftime("%Y-%m-%dT%H:%M:%SZ"),
"Position": [
event["payload"]["location"]["long"],
event["payload"]["location"]["lat"]
]
}
if "accuracy" in event["payload"]:
update["Accuracy"] = event["payload"]['accuracy']
if "positionProperties" in event["payload"]:
update["PositionProperties"] = event["payload"]['positionProperties']
client = boto3.client("location")
response = client.batch_update_device_position(TrackerName=TRACKER_NAME, Updates=[update])
return {
"statusCode": 200,
"body": json.dumps(response)
}
```
1. Wählen Sie **Deploy**, um die aktualisierte Funktion zu speichern.
1. Wählen Sie die Registerkarte **Konfiguration** aus.
1. Wählen Sie im Abschnitt **Berechtigungen** den Rollennamen mit dem Hyperlink aus, um Amazon Location Service Service-Berechtigungen für Ihre Lambda-Funktion zu gewähren.
1. Wählen Sie auf der **Übersichtsseite** Ihrer Rolle die Option **Berechtigungen hinzufügen** und dann in der Dropdownliste die Option Inline-Richtlinie **erstellen** aus.
1. Wählen Sie die Registerkarte **JSON** und überschreiben Sie die Richtlinie mit dem folgenden Dokument. Auf diese Weise kann Ihre Lambda-Funktion Gerätepositionen aktualisieren, die von allen Tracker-Ressourcen in allen Regionen verwaltet werden.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "WriteDevicePosition",
"Effect": "Allow",
"Action": "geo:BatchUpdateDevicePosition",
"Resource": "arn:aws:geo:*:*:tracker/*"
}
]
}
```
1. Wählen Sie **Richtlinie prüfen**.
1. Geben Sie den Namen einer Richtlinie ein. Beispiel, *AmazonLocationTrackerWriteOnly*.
1. Wählen Sie **Richtlinie erstellen** aus.
Sie können diesen Funktionscode nach Bedarf ändern, um ihn an Ihr eigenes Gerätenachrichtenschema anzupassen.
## Erstellen Sie eine AWS IoT Core Regel
Erstellen Sie als Nächstes eine AWS IoT Core Regel, um die Positionstelemetrie Ihrer Geräte zur Umwandlung und Veröffentlichung an Amazon Location Service an die AWS Lambda Funktion weiterzuleiten. Die bereitgestellte Beispielregel geht davon aus, dass jede notwendige Transformation von Geräte-Payloads von Ihrer Lambda-Funktion übernommen wird. Sie können diese Regel über die AWS IoT Core Konsole, die AWS Command Line Interface (AWS CLI) oder die erstellen. AWS IoT Core APIs
**Anmerkung**
Die AWS IoT Konsole verarbeitet zwar die Berechtigungen, die AWS IoT Core zum Aufrufen Ihrer Lambda-Funktion erforderlich sind, aber wenn Sie Ihre Regel über das SDK AWS CLI oder das SDK erstellen, müssen Sie [eine Richtlinie konfigurieren, der Sie Berechtigungen erteilen](https://docs.aws.amazon.com/iot/latest/developerguide/lambda-rule-action.html#lambda-rule-action-requirements). AWS IoT
**Um eine zu erstellen und die Konsole zu AWS IoT Core verwenden**
1. Melden Sie sich bei der AWS IoT Core Konsole an unter [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home).
1. Erweitern Sie in der linken Navigationsleiste **Act** und wählen Sie **Regeln** aus.
1. Wählen Sie **Regel erstellen** aus, um den Assistenten für neue Regeln zu starten.
1. Geben Sie für Ihre Regel einen Namen und eine Beschreibung ein.
1. Aktualisieren Sie das `FROM` Attribut für die **Regelabfrage** so, dass es auf ein Thema verweist, in dem mindestens ein Gerät Telemetriedaten veröffentlicht, die den Standort enthalten. Wenn Sie die Lösung testen, sind keine Änderungen erforderlich.
```
SELECT * FROM 'iot/topic'
```
1. Wählen **Sie unter Eine oder mehrere Aktionen festlegen** die Option **Aktion hinzufügen** aus.
1. Wählen Sie **Eine Nachricht an eine Lambda-Funktion** senden aus.
1. Wählen Sie **Configure action**.
1. Suchen Sie Ihre Lambda-Funktion und wählen Sie sie aus der Liste aus.
1. Wählen Sie **Aktion hinzufügen** aus.
1. Wählen Sie **Regel erstellen** aus.
## Testen Sie Ihre AWS IoT Core Regel in der Konsole
Wenn derzeit keine Geräte Telemetriedaten veröffentlichen, die den Standort enthalten, können Sie Ihre Regel und diese Lösung mithilfe der AWS IoT Core Konsole testen. Die Konsole verfügt über einen Testclient, auf dem Sie eine Beispielnachricht veröffentlichen können, um die Ergebnisse der Lösung zu überprüfen.
1. Melden Sie sich bei der AWS IoT Core Konsole an unter [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home).
1. Erweitern Sie in der linken Navigationsleiste den Eintrag **Test** und wählen Sie **MQTT-Testclient** aus.
1. Legen Sie unter In **einem Thema veröffentlichen** den **Themennamen** auf fest *iot/topic* (oder den Namen des Themas, das Sie in Ihrer AWS IoT Core Regel eingerichtet haben, falls anders) und geben Sie Folgendes für die **Nachrichten-Payload** ein. Ersetzen Sie den Zeitstempel *1604940328* durch einen gültigen Zeitstempel innerhalb der letzten 30 Tage (alle Zeitstempel, die älter als 30 Tage sind, werden ignoriert).
```
{
"payload": {
"deviceid": "thing123",
"timestamp": 1604940328,
"location": { "lat": 49.2819, "long": -123.1187 },
"accuracy": { "Horizontal": 20.5 },
"positionProperties": { "field1": "value1", "field2": "value2" }
}
}
```
1. Wählen Sie Im Thema **veröffentlichen**, um die Testnachricht zu senden.
1. Verwenden Sie den folgenden AWS CLI Befehl, um zu überprüfen, ob die Nachricht von Amazon Location Service empfangen wurde. Wenn Sie sie während der Einrichtung geändert haben, ersetzen Sie den Tracker-Namen und die Geräte-ID durch die, die Sie verwendet haben.
```
aws location batch-get-device-position --tracker-name MyTracker --device-ids thing123
```
# Verwalte deinen Amazon Location Service Tracker
Sie können Ihre Tracker über die Amazon Location-Konsole AWS CLI, den oder den Amazon-Standort APIs verwalten.
## Listen Sie Ihre Tracker auf
Sie können Ihre Tracker-Liste über die Amazon Location-Konsole AWS CLI, den oder den Amazon-Standort APIs anzeigen:
------
#### [ Console ]
**Um mit der Amazon Location-Konsole eine Liste vorhandener Tracker anzuzeigen**
1. Öffnen Sie die Amazon Location-Konsole unter [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Wählen Sie in der linken Navigationsleiste **Trackers** aus.
1. Eine Liste deiner Tracker-Ressourcen findest du unter **Meine Tracker**.
------
#### [ API ]
Verwenden Sie den `[ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html)` Vorgang von Amazon Location Trackers APIs aus.
Das folgende Beispiel ist eine API-Anfrage, um eine Liste der Tracker in Ihrem AWS Konto abzurufen.
```
POST /tracking/v0/list-trackers
```
Das Folgende ist ein Beispiel für eine Antwort für`[ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html)`:
```
{
"Entries": [
{
"CreateTime": 2020-10-02T19:09:07.327Z,
"Description": "string",
"TrackerName": "ExampleTracker",
"UpdateTime": 2020-10-02T19:10:07.327Z
}
],
"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 der Tracker in Ihrem AWS Konto abzurufen.
```
aws location list-trackers
```
------
## Einen Tracker von einer Geofence-Sammlung trennen
Sie können einen Tracker über die Amazon Location-Konsole, den oder den Amazon-Standort von einer Geofence-Erfassung trennen: AWS CLI APIs
------
#### [ Console ]
**So trennen Sie mithilfe der Amazon Location Console die Zuordnung eines Trackers zu einer zugehörigen Geofence-Erfassung**
1. Öffnen Sie die Amazon Location-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 unter **Meine Tracker** den Namenslink des Ziel-Trackers aus.
1. **Wählen Sie unter **Verknüpfte Geofence-Sammlungen** eine Geofence-Sammlung mit dem Status Verknüpft aus.**
1. **Wählen Sie Verknüpfung aufheben.**
------
#### [ API ]
Verwenden Sie den `[DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html)` Vorgang von Amazon Location Trackers APIs aus.
Das folgende Beispiel ist eine API-Anfrage, um einen Tracker von einer zugehörigen Geofence-Sammlung zu trennen.
```
DELETE /tracking/v0/trackers/ExampleTracker/consumers/arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleCollection
```
Das Folgende ist ein Beispiel für eine Antwort für: `[DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html)`
```
HTTP/1.1 200
```
------
#### [ CLI ]
Verwenden Sie den Befehl `[disassociate-tracker-consumer](https://docs.aws.amazon.com/cli/latest/reference/location/disassociate-tracker-consumer.html)`.
Das folgende Beispiel ist ein AWS CLI Befehl zum Trennen der Zuordnung eines Trackers zu einer zugehörigen Geofence-Sammlung.
```
aws location disassociate-tracker-consumer \
--consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleCollection" \
--tracker-name "ExampleTracker"
```
------
## Tracker-Details abrufen
Sie können Details zu jedem Tracker in Ihrem AWS Konto abrufen, indem Sie die Amazon Location-Konsole AWS CLI, den oder den Amazon-Standort verwenden APIs.
------
#### [ Console ]
**So zeigen Sie Tracker-Details mithilfe der Amazon Location-Konsole an**
1. Öffnen Sie die Amazon Location-Konsole unter [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Wählen Sie in der linken Navigationsleiste **Trackers** aus.
1. Wählen Sie unter **Meine Tracker** den Namenslink des Ziel-Trackers aus.
1. Sehen Sie sich die Tracker-Details unter **Informationen** an.
------
#### [ API ]
Verwenden Sie den `[DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html)` Vorgang vom Amazon Location Tracker aus APIs.
Das folgende Beispiel ist eine API-Anfrage zum Abrufen der Tracker-Details für*ExampleTracker*.
```
GET /tracking/v0/trackers/ExampleTracker
```
Das Folgende ist ein Beispiel für eine Antwort für`[DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html)`:
```
{
"CreateTime": 2020-10-02T19:09:07.327Z,
"Description": "string",
"EventBridgeEnabled": false,
"KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
"PositionFiltering": "TimeBased",
"Tags": {
"Tag1" : "Value1"
},
"TrackerArn": "arn:aws:geo:us-west-2:123456789012:tracker/ExampleTracker",
"TrackerName": "ExampleTracker",
"UpdateTime": 2020-10-02T19:10:07.327Z
}
```
------
#### [ CLI ]
Verwenden Sie den Befehl `[describe-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/describe-tracker.html)`.
Das folgende Beispiel ist ein AWS CLI Befehl zum Abrufen von Tracker-Details*ExampleTracker*.
```
aws location describe-tracker \
--tracker-name "ExampleTracker"
```
------
## Löschen Sie einen Tracker
Sie können einen Tracker über die Amazon Location-Konsole, den oder den AWS CLI Amazon-Standort aus Ihrem AWS Konto löschen APIs:
------
#### [ Console ]
**Um eine bestehende Kartenressource mit der Amazon Location-Konsole zu löschen**
**Warnung**
Dieser Vorgang löscht die Ressource dauerhaft. Wenn die Tracker-Ressource verwendet wird, kann ein Fehler auftreten. Stellen Sie sicher, dass die Zielressource keine Abhängigkeit von Ihren Anwendungen darstellt.
1. Öffnen Sie die Amazon Location-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 unter **Meine Tracker den** Ziel-Tracker aus.
1. Wähle **Tracker löschen**.
------
#### [ API ]
Verwenden Sie den `[DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html)` Vorgang vom Amazon Location Tracker aus APIs.
Das folgende Beispiel ist eine API-Anfrage zum Löschen des Trackers*ExampleTracker*.
```
DELETE /tracking/v0/trackers/ExampleTracker
```
Das Folgende ist ein Beispiel für eine Antwort für`[DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html)`:
```
HTTP/1.1 200
```
------
#### [ CLI ]
Verwenden Sie den Befehl `[delete-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/delete-tracker.html)`.
Das folgende Beispiel ist ein AWS CLI Befehl zum Löschen des Trackers*ExampleTracker*.
```
aws location delete-tracker \
--tracker-name "ExampleTracker"
```
------
# Kosten und Nutzung verwalten
Wenn Sie sich weiter mit Amazon Location Trackers vertraut machen, ist es wichtig zu verstehen, wie Sie die Servicekapazität verwalten, sicherstellen, dass Sie Nutzungsbeschränkungen einhalten und durch Kontingent- und API-Optimierungen die besten Ergebnisse erzielen. Indem Sie bewährte Methoden für Leistung und Genauigkeit anwenden, können Sie Ihre Anwendung so anpassen, dass sie ortsbezogene Anfragen effizient bearbeitet und Ihre API-Anfragen maximiert.
**Topics**
+ [Preisgestaltung für Tracker](trackers-pricing.md)
+ [Kontingent und Nutzung von Trackern](trackers-quotas.md)
# Preisgestaltung für Tracker
Preisinformationen für Tracking und Geofencing APIs finden Sie auf der [Preisseite von Amazon Location Service](https://aws.amazon.com/location/pricing/).
**Position geschrieben**
Sie können `BatchUpdateDevicePosition` damit Positionsaktualisierungsdaten für ein oder mehrere Geräte in eine Tracker-Ressource hochladen (bis zu zehn Geräte pro Stapel). Der Preis basiert auf der Anzahl der Gerätepositionen in Ihrer API-Anfrage. Der Stückpreis pro Aktualisierung der Geräteposition basiert auf dem gesamten monatlichen Nutzungsvolumen. Weitere Informationen zu Einzelpreisen und Volumenstufen finden Sie auf der [Preisseite von Amazon Location Service](https://aws.amazon.com/location/pricing/).
Sie können Ihre Kosten für Position Written optimieren, indem Sie die Aktualisierungshäufigkeit der Geräteposition (auch bekannt als Ping-Rate) auf Ihren Ortungsgeräten konfigurieren und optional einen lokalen Filter verwenden, um nur relevante Aktualisierungen der Geräteposition auf Amazon Location Service hochzuladen.
**Position gelesen**
Sie können `BatchGetDevicePosition` damit die neuesten Gerätepositionen für angeforderte Geräte auflisten, bis zu 100 Geräte pro Anfrage. Sie können es auch verwenden`GetDevicePosition`, um die aktuelle Position eines Geräts anhand der Probenzeit abzurufen.
Der Preis basiert auf der Anzahl der API-Anfragen.
**Position Löschen**
Sie können `BatchDeleteDevicePositionHistory` damit den Positionsverlauf eines oder mehrerer Geräte aus einer Tracker-Ressource löschen, bis zu 100 Geräte pro Anfrage.
Der Preis basiert auf der Anzahl der Geräte in Ihrer API-Anfrage.
**Bewertung der Integrität der Position**
Sie können sie verwenden`VerifyDevicePosition`, um die Integrität der Geräteposition zu überprüfen, indem Sie feststellen, ob sie hinter einem Proxy gemeldet wurde, und sie mit einer abgeleiteten Position vergleichen, die auf der Grundlage des Gerätestatus geschätzt wird.
Der Preis basiert auf der Anzahl der API-Anfragen.
# Kontingent und Nutzung von Trackern
Dieses Thema bietet eine Zusammenfassung der Ratenlimits und Kontingente für Amazon Location Service Tracker.
**Anmerkung**
Wenn Sie ein höheres Kontingent benötigen, können Sie die Konsole Service Quotas verwenden, um [Kontingenterhöhungen für anpassbare Kontingente anzufordern](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas). Wenn Sie eine Kontingenterhöhung beantragen, wählen Sie die Region aus, in der Sie die Kontingenterhöhung wünschen, da die AWS meisten Kontingente regionsspezifisch sind. Sie können für jede API bis zum Doppelten des Standardlimits beantragen.
Für Anfragen, die das Doppelte des Standardlimits überschreiten, wird mit Ihrer Anfrage ein Support-Ticket eingereicht. Sie können sich auch mit Ihrem Premium-Supportteam verbinden. Es fallen keine direkten Gebühren für Anfragen zur Erhöhung des Kontingents an, aber eine höhere Nutzung kann aufgrund der zusätzlich verbrauchten Ressourcen zu höheren Servicekosten führen. Weitere Informationen finden Sie unter [Kontingente mit Service Quotas verwalten](manage-quotas.md).
Service Quotas sind die maximale Anzahl von Ressourcen, die Sie pro AWS Konto und AWS Region haben können. Amazon Location Service lehnt zusätzliche Anfragen ab, die das Servicekontingent überschreiten.
## Ressourcen
| API-Name | Standard | Maximal einstellbares Limit |
| --- | --- | --- |
| Tracker-Ressourcen pro Konto | 500 | 1000 Wenn Sie mehr benötigen, [fordern Sie eine Erhöhung des Kontingents](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) an oder wenden Sie sich an das Support-Team. |
| Tracker-Verbraucher pro Tracker | 5 | Das maximal einstellbare Limit ist nicht anwendbar. Wenden Sie sich an das Support-Team. |
## CRUD API
**Anmerkung**
Wenn Sie für eines dieser Programme ein höheres Limit benötigen APIs, [fordern Sie eine Erhöhung des Kontingents](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) an oder wenden Sie sich an das Support-Team.
| API-Name | Standard | Maximal einstellbares Limit |
| --- | --- | --- |
| [AssociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_AssociateTrackerConsumer.html) | 10 | 20 |
| [CreateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html) | 10 | 20 |
| [DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html) | 10 | 20 |
| [DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html) | 10 | 20 |
| [DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html) | 10 | 20 |
| [ListTrackerConsumers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackerConsumers.html) | 10 | 20 |
| [ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html) | 10 | 20 |
| [UpdateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_UpdateTracker.html) | 10 | 20 |
## Daten-API
**Anmerkung**
Wenn Sie für eines dieser Ziele ein höheres Limit benötigen APIs, [fordern Sie eine Erhöhung des Kontingents](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) an oder wenden Sie sich an das Support-Team.
| API-Name | Standard | Maximal einstellbares Limit |
| --- | --- | --- |
| [BatchGetDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchGetDevicePosition.html) | 50 | 100 |
| [BatchUpdateDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchUpdateDevicePosition.html) | 50 | 100 |
| [GetDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePosition.html) | 50 | 100 |
| [GetDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePositionHistory.html) | 50 | 100 |
| [BatchDeleteDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchDeleteDevicePositionHistory.html) | 50 | 100 |
| [ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html) | 50 | 100 |
## Andere Nutzungsbeschränkungen