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.
# Indexierung von Standortdaten
Sie können die [AWS IoT Flottenindizierung](https://docs.aws.amazon.com//iot/latest/developerguide/iot-indexing.html) verwenden, um die zuletzt gesendeten Standortdaten Ihrer Geräte zu indizieren und mithilfe von Geoabfragen nach Geräten zu suchen. Diese Funktion löst Anwendungsfälle für die Geräteüberwachung und -verwaltung wie Standortverfolgung und Näherungssuche. [Die Standortindizierung funktioniert ähnlich wie andere Funktionen zur Flottenindizierung, allerObjekts mit zusätzlichen Konfigurationen, die Sie bei der Indexierung Ihres Objekts angeben müssen.](managing-fleet-index.md)
Zu den häufigsten Anwendungsfällen gehören: Suchen und Aggregieren von Geräten, die sich innerhalb der gewünschten geografischen Grenzen befinden, Abrufen von standortspezifischen Erkenntnissen mithilfe von Abfragebegriffen in Bezug auf Gerätemetadaten und Status aus indizierten Datenquellen, Bereitstellung einer detaillierten Ansicht, z. B. das Filtern von Ergebnissen nach einem bestimmten geografischen Gebiet, um Rendering-Verzögerungen innerhalb Ihrer Flottenüberwachungskarten zu reduzieren und den zuletzt gemeldeten Gerätestandort zu verfolgen und Geräte zu identifizieren, die sich außerhalb der gewünschten Grenzwerte befinden, und anhand von [Flottenmetriken](iot-fleet-metrics.md) Alarme zu generieren. Erste Schritte mit der Standortindizierung und Geoabfragen finden Sie unter [Erste Schritte-Tutorial](location-indexing-tutorial.md).
## Unterstützte Datumsformate
AWS IoT Die Flottenindizierung unterstützt die folgenden Standortdatenformate:
1.
**Bekannte Textdarstellung von Koordinatenreferenzsystemen**
Eine Zeichenfolge, die dem Format [Geographische Information — Bekannte Textdarstellung von Koordinatenreferenzsystemen](https://docs.ogc.org/is/12-063r5/12-063r5.html) folgt. Ein Beispiel kann sein`"POINT(long lat)"`.
1.
**Eine Zeichenfolge, die die Koordinaten darstellt**
Eine Zeichenfolge im Format `"latitude, longitude"` oder `"longitude, latitude"`. Wenn Sie `"longitude, latitude"` angeben, müssen Sie auch `order` in `geoLocations` angeben. Ein Beispiel kann sein `"41.12,-71.34"`.
1.
**Ein Objekt mit den Tasten Lat (Breitengrad) und Lon (Längengrad)**
Dieses Format gilt für klassischen Schatten und benannten Schatten. Unterstützte Schlüssel: `lat`, `latitude`, `lon`, `long`, `longitude`. Ein Beispiel kann `{"lat": 41.12, "lon": -71.34}` sein.
1.
**Ein Array, das die Koordinaten darstellt**
Ein Array mit dem Format `[lat,lon]` oder `[lon,lat]`. Wenn Sie das Format `[lon,lat]` verwenden, das den Koordinaten in [GeoJSON](https://geojson.org/) entspricht (gilt für klassischen Schatten und benannten Schatten), müssen Sie auch `order` in `geoLocations` angeben.
Ein Beispiel kann sein:
```
{
"location": {
"coordinates": [
**Longitude**,
**Latitude**
],
"type": "Point",
"properties": {
"country": "United States",
"city": "New York",
"postalCode": "*****",
"horizontalAccuracy": 20,
"horizontalConfidenceLevel": 0.67,
"state": "New York",
"timestamp": "2023-01-04T20:59:13.024Z"
}
}
}
```
## Wie indexiert man Standortdaten
Die folgenden Schritte zeigen, wie Sie die Indexierungskonfiguration für Ihre Standortdaten aktualisieren und Geoabfragen verwenden, um nach Geräten zu suchen.
1.
**Erfahren Sie, wo Ihre Standortdaten gespeichert sind**
Die Flottenindizierung unterstützt derzeit die Indizierung von Standortdaten, die in klassischen Schatten oder benannten Schatten gespeichert sind.
1.
**Verwenden Sie unterstützte Standortdatenformate**
Stellen Sie sicher, dass Ihr Standortdatenformat einem der [unterstützten Datenformate](#location-indexing-format) entspricht.
1.
**Aktualisieren Sie die Indexkonfiguration**
Aktivieren Sie mindestens die Konfiguration für die Indizierung von Objekten (Registrierung). Sie müssen auch die Indizierung für klassische Schatten oder Named Schatten aktivieren, die Ihre Standortdaten enthalten. Wenn Sie Ihre Objekt-Indizierung aktualisieren, sollten Sie Ihre Standortdaten in die Indexierungskonfiguration einbeziehen.
1.
**Erstellen und Ausführen von -Abfragen**
Erstellen Sie je nach Ihren Anwendungsfällen Geoabfragen und führen Sie sie aus, um nach Geräten zu suchen. [Die Geoabfrage, die Sie erstellen, muss der Abfragesyntax entsprechen.](https://docs.aws.amazon.com//iot/latest/developerguide/query-syntax.html) Sie finden einige Beispiele in [Beispiele für Geoqueries](#location-indexing-geoqueries).
## Konfiguration der Objektindizierung.
Um Standortdaten zu indizieren, müssen Sie die Indexkonfiguration aktualisieren und Ihre Standortdaten einbeziehen. Gehen Sie je nachdem, wo Ihre Standortdaten gespeichert sind, wie folgt vor, um Ihre Indexierungskonfiguration zu aktualisieren:
### Standortdaten, die in klassischen Schatten gespeichert werden
Wenn Ihre Standortdaten in einem klassischen Shadow gespeichert sind, müssen Sie `thingIndexingMode` auf `REGISTRY_AND_SHADOW` einstellen und Ihre Standortdaten in den `geoLocations`-Feldern (`name`und`order`) unter [https://docs.aws.amazon.com//iot/latest/apireference/API_IndexingFilter.html](https://docs.aws.amazon.com//iot/latest/apireference/API_IndexingFilter.html) angeben.
Im folgenden Konfigurationsbeispiel für die Indizierung geben Sie den Standortdatenpfad `shadow.reported.coordinates` als `name` und `LonLat` als `order` an.
```
{
"thingIndexingMode": "REGISTRY_AND_SHADOW",
"filter": {
"geoLocations": [
{
"name": "shadow.reported.coordinates",
"order": "LonLat"
}
]
}
}
```
+ `thingIndexingMode`
Der Indizierungsmodus steuert, ob Registry oder Shadow indexiert wird. Wenn `thingIndexingMode` auf `OFF` eingestellt ist, ist die Indizierung von Objekten deaktiviert.
Um Standortdaten zu indizieren, die in einem klassischen Schatten gespeichert sind, müssen Sie `thingIndexingMode` den Wert auf `REGISTRY_AND_SHADOW` einstellen. Weitere Informationen finden Sie unter [Objektindizierungsmodus.](managing-index.md#index-mode).
+ `filter`
Der Indexfilter bietet zusätzliche Auswahlmöglichkeiten für benannte Schatten und Geolokalisierungsdaten. Weitere Informationen finden Sie unter [Indizierungsfilter](managing-index.md#thing-indexing-filter).
+ `geoLocations`
Die Liste der Geolocation-Ziele, die Sie für die Indizierung auswählen. Die Standardanzahl von Geolocation-Zielen für die Indizierung ist `1`. Informationen zum Erhöhen von Limits finden Sie unter [AWS IoT Device Management Kotingente](https://docs.aws.amazon.com//general/latest/gr/iot_device_management.html#fleet-indexing-limits).
+ `name`
Der Name des Geolocation-Zielfelds. Ein Beispielwert von `name` kann der Standortdatenpfad Ihres Schattens sein:`shadow.reported.coordinates`.
+ `order`
Die Reihenfolge des Geolocation-Zielfeldes. Gültige Werte: `LatLon` und `LonLat`. `LatLon` bedeutet Breitengrad und Längengrad. `LonLat` bedeutet Längengrad und Breitengrad. Dies ist ein optionales Feld. Der Standardwert ist `LatLon`.
### Standortdaten, die in benannten Schatten gespeichert sind
Wenn Ihre Standortdaten in einem benannten Schatten gespeichert sind, setzen Sie `namedShadowIndexingMode` auf den Wert `ON`, fügen Sie Ihre (n) benannten Schattennamen zum `namedShadowNames`-Feld in [https://docs.aws.amazon.com//iot/latest/apireference/API_IndexingFilter.html](https://docs.aws.amazon.com//iot/latest/apireference/API_IndexingFilter.html)hinzu und geben Sie Ihren Standortdatenpfad im `geoLocations` Feld in [https://docs.aws.amazon.com//iot/latest/apireference/API_IndexingFilter.html](https://docs.aws.amazon.com//iot/latest/apireference/API_IndexingFilter.html) an.
Im folgenden Konfigurationsbeispiel für die Indizierung geben Sie den Standortdatenpfad `shadow.name.namedShadow1.reported.coordinates` als `name` und `LonLat` als `order` an.
```
{
"thingIndexingMode": "REGISTRY",
"namedShadowIndexingMode": "ON",
"filter": {
"namedShadowNames": [
"namedShadow1"
],
"geoLocations": [
{
"name": "shadow.name.namedShadow1.reported.coordinates",
"order": "LonLat"
}
]
}
}
```
+ `thingIndexingMode`
Der Indizierungsmodus steuert, ob Registry oder Shadow indexiert wird. Wenn `thingIndexingMode` auf `OFF` eingestellt ist, ist die Indizierung von Objekten deaktiviert.
Um Standortdaten, die in einem benannten Schatten gespeichert sind, zu indizieren, müssen Sie `thingIndexingMode` den Wert auf `REGISTRY` (oder `REGISTRY_AND_SHADOW`) setzen. Weitere Informationen finden Sie unter [Objektindizierungsmodus.](managing-index.md#index-mode).
+ `filter`
Der Indexfilter bietet zusätzliche Auswahlmöglichkeiten für benannte Schatten und Geolokalisierungsdaten. Weitere Informationen finden Sie unter [Indizierungsfilter](managing-index.md#thing-indexing-filter).
+ `geoLocations`
Die Liste der Geolocation-Ziele, die Sie für die Indizierung auswählen. Die Standardanzahl von Geolocation-Zielen für die Indizierung ist `1`. Informationen zum Erhöhen von Limits finden Sie unter [AWS IoT Device Management Kotingente](https://docs.aws.amazon.com//general/latest/gr/iot_device_management.html#fleet-indexing-limits).
+ `name`
Der Name des Geolocation-Zielfelds. Ein Beispielwert von `name` kann der Standortdatenpfad Ihres Schattens sein:`shadow.name.namedShadow1.reported.coordinates`.
+ `order`
Die Reihenfolge des Geolocation-Zielfeldes. Gültige Werte: `LatLon` und `LonLat`. `LatLon` bedeutet Breitengrad und Längengrad. `LonLat` bedeutet Längengrad und Breitengrad. Dies ist ein optionales Feld. Der Standardwert ist `LatLon`.
## Beispiele für Geoqueries
Nachdem Sie die Indizierungskonfiguration für Ihre Standortdaten abgeschlossen haben, führen Sie Geoqueries aus, um nach Geräten zu suchen. Sie können Ihre Geoqueries auch mit anderen Abfragezeichenfolgen kombinieren. Weitere Informationen erhalten Sie unter [Abfragesyntax](query-syntax.md) und [Beispiel für Objektabfragen](example-queries.md).
**Beispiel: Abfrage**
In diesem Beispiel wird davon ausgegangen, dass die Standortdaten in einem benannten Schatten `gps-tracker` gespeichert sind. Die Ausgabe dieses Befehls ist die Liste der Geräte, die sich innerhalb einer radialen Entfernung von 15,5 km vom Mittelpunkt befinden, mit Koordinaten (47.6204, -122.3491).
```
aws iot search-index --query-string \
"shadow.name.gps-tracker.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km"
```
**Beispiel: Abfrage**
In diesem Beispiel wird davon ausgegangen, dass die Standortdaten in einem klassischen Schatten gespeichert sind. Die Ausgabe dieses Befehls ist die Liste der Geräte, die sich innerhalb einer radialen Entfernung von 15,5 km vom Mittelpunkt befinden, mit Koordinaten (47.6204, -122.3491).
```
aws iot search-index --query-string \
"shadow.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km"
```
**Beispiel: Abfrage**
In diesem Beispiel wird davon ausgegangen, dass die Standortdaten in einem klassischen Schatten gespeichert sind. Die Ausgabe dieses Befehls ist die Liste der Geräte, die nicht angeschlossen sind und sich außerhalb der radialen Entfernung von 15,5 km vom Mittelpunkt befinden, mit Koordinaten (47.6204, -122.3491).
```
aws iot search-index --query-string \
"connectivity.connected:false AND (NOT shadow.reported.coordinates:geo_distance,47.6204,-122.3491,15.5km)"
```