Erstellen Sie eine iOS-Anwendung

Navigieren Sie in der AWS Konsole zum Amazon Cognito-Service und wählen Sie dann im Menü auf der linken Seite Identitätspools und dann Identitätspool erstellen aus.

Vergewissern Sie sich, dass Gastzugriff aktiviert ist, und klicken Sie auf Weiter, um fortzufahren.

Erstellen Sie als Nächstes eine neue IAM-Rolle oder Verwenden Sie eine vorhandene IAM-Rolle.

Geben Sie einen Namen für den Identitätspool ein und stellen Sie sicher, dass Identity Pool Zugriff auf (geo) Amazon-Standortressourcen für die Karte und den Tracker hat, die Sie im nächsten Verfahren erstellen werden.

Navigieren Sie in der Amazon Location-Konsole zum Abschnitt Maps und wählen Sie Create Map aus, um eine Vorschau der verfügbaren Kartenstile anzuzeigen.

Geben Sie der neuen Kartenressource einen Namen und eine Beschreibung. Notieren Sie sich den Namen, den Sie der Kartenressource zuweisen, so wie er später im Tutorial verwendet wird.

Berücksichtigen Sie bei der Auswahl eines Kartenstils den Kartendatenanbieter. Weitere Informationen finden Sie in Abschnitt 82 der AWS Servicebedingungen.

Akzeptieren Sie die Allgemeinen Geschäftsbedingungen für Amazon-Standorte und wählen Sie dann Karte erstellen aus. Nachdem die Karte erstellt wurde, können Sie mit der Karte interagieren, indem Sie sie vergrößern, verkleinern oder in eine beliebige Richtung schwenken.

Öffnen Sie die Amazon Location Service Service-Konsole.

Wählen Sie im linken Navigationsbereich Trackers aus.

Wählen Sie Tracker erstellen.

Füllen Sie alle erforderlichen Felder aus.

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 unter Trackers in diesem Handbuch und PositionFiltering in der Amazon Location Service Trackers API-Referenz.

Wählen Sie „Tracker erstellen“, um den Vorgang abzuschließen.

Öffnen Sie die Amazon Location Service Service-Konsole unter https://console.aws.amazon.com/location/.

Wählen Sie im linken Navigationsbereich Geofence Collections aus.

Wählen Sie Geofence-Sammlung erstellen.

Geben Sie einen Namen und eine Beschreibung für die Sammlung an.

Unter EventBridge CloudWatch Regel mit Ziel können Sie eine optionale EventBridge Regel erstellen, mit der Sie sofort auf Geofence-Ereignisse reagieren können. Dadurch kann Amazon Location Ereignisse in Amazon CloudWatch Logs veröffentlichen.

Wählen Sie Geofence-Sammlung erstellen.

Öffnen Sie die Amazon Location-Konsole.

Wählen Sie im linken Navigationsbereich Trackers aus.

Wählen Sie unter Device Trackers den Namenslink des Ziel-Trackers aus.

Wählen Sie unter Verknüpfte Geofence-Sammlungen die Option Geofence-Sammlung verknüpfen aus.

Wählen Sie im Fenster Verknüpfte Geofence-Sammlung eine Geofence-Sammlung aus dem Drop-down-Menü aus.

Wählen Sie Verknüpfen.

Nachdem Sie die Tracker-Ressource verknüpft haben, wird ihr der Status Aktiv zugewiesen.

Öffnen Sie die AWS Lambda Konsole unter. https://console.aws.amazon.com/lambda/

Wählen Sie in der linken Navigationsleiste Funktionen aus.

Wählen Sie „Funktion erstellen“ und stellen Sie sicher, dass „Von Grund auf neu erstellen“ ausgewählt ist.

Füllen Sie die folgenden Felder aus:

Wählen Sie Funktion erstellen.

Wählen Sie die Registerkarte Code, um den Editor zu öffnen.

Überschreiben Sie den Platzhaltercode in index.js mit dem Folgenden:

const AWS = require('aws-sdk')
const iot = new AWS.Iot();
exports.handler =  function(event) {
              console.log("event===>>>", JSON.stringify(event));
              var param = {
                endpointType: "iot:Data-ATS"
              };
              iot.describeEndpoint(param, function(err, data) {
                if (err) {
                  console.log("error===>>>", err, err.stack); // an error occurred
                } else {
                  var endp = data['endpointAddress'];
                  const iotdata = new AWS.IotData({endpoint: endp});    
                  const trackerEvent = event["detail"]["EventType"];
                  const src = event["source"];
                  const time = event["time"];
                  const gfId = event["detail"]["GeofenceId"];
                  const resources = event["resources"][0];  
                  const splitResources = resources.split(".");  
                  const geofenceCollection = splitResources[splitResources.length - 1];
                  const coordinates = event["detail"]["Position"];                               
                  const deviceId = event["detail"]["DeviceId"]; 
                  console.log("deviceId===>>>", deviceId);
                  const msg =  {
                      "trackerEventType" : trackerEvent,
                      "source" : src,
                      "eventTime" : time,
                      "geofenceId" : gfId,
                      "coordinates": coordinates, 
                      "geofenceCollection": geofenceCollection
                    };
                  const params = {
                    topic: `${deviceId}/tracker`,
                    payload: JSON.stringify(msg),
                    qos: 0
                  };
                  iotdata.publish(params, function(err, data) {
                      if (err) {
                        console.log("error===>>>", err, err.stack); // an error occurred
                      } else {
                        console.log("Ladmbda triggered===>>>", trackerEvent);  // successful response 
                      }
                  }); 
                }
              });
            }

Wählen Sie Deploy, um die aktualisierte Funktion zu speichern.

Wählen Sie die Registerkarte Konfiguration aus.

Klicken Sie im Bereich Trigger auf Auslöser hinzufügen.

Wählen Sie im Feld Quelle EventBridge (CloudWatch Ereignisse) aus.

Wählen Sie das Optionsfeld `Existierende Regeln`.

Geben Sie den Regelnamen wie folgt ein: `-GEOFENCECOLLECTION_NAME`. AmazonLocationMonitor

Klicken Sie auf die Schaltfläche Hinzufügen.

Dadurch werden auch `Ressourcenbasierte Richtlinienerklärungen` auf der Registerkarte „Berechtigungen“ angehängt

Öffnen Sie die https://console.aws.amazon.com/iot/.

Wählen Sie im linken Navigationsbereich MQTT-Testclient aus.

Sie sehen einen Abschnitt mit dem Titel MQTT-Testclient, in dem Sie Ihre MQTT-Verbindung konfigurieren können.

Nachdem Sie die erforderlichen Einstellungen konfiguriert haben, klicken Sie auf die Schaltfläche Connect, um mithilfe der bereitgestellten Parameter eine Verbindung zum MQTT-Broker herzustellen.

Notieren Sie sich den Endpoint-Wert.

Erweitern Sie im Menü auf der linken Seite unter Verwalten die Option Sicherheit und klicken Sie auf Richtlinien.

Klicken Sie auf die Schaltfläche Richtlinie erstellen.

Geben Sie den Namen einer Richtlinie ein.

Wählen Sie im Richtliniendokument die Registerkarte JSON aus.

Kopieren Sie die unten gezeigte Richtlinie und fügen Sie sie ein. Achten Sie jedoch darauf, alle Elemente mit Ihrem REGION und zu aktualisierenACCOUNT_ID:

{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
                {
                  "Action": [
                    "iot:Connect",
                    "iot:Publish",
                    "iot:Subscribe",
                    "iot:Receive"
                  ],
                  "Resource": [
                    "arn:aws:iot:REGION:ACCOUNT_ID:client/${cognito-identity.amazonaws.com:sub}",
                    "arn:aws:iot:REGION:ACCOUNT_ID:topic/${cognito-identity.amazonaws.com:sub}",
                    "arn:aws:iot:REGION:ACCOUNT_ID:topicfilter/${cognito-identity.amazonaws.com:sub}/",
                    "arn:aws:iot:REGION:ACCOUNT_ID:topic/${cognito-identity.amazonaws.com:sub}/tracker"
                   ],
                   "Effect": "Allow"
                 }
               ]
}        

Wählen Sie die Schaltfläche Erstellen, um den Vorgang abzuschließen.

Klonen Sie das Git-Repository von dieser URL: https://github.com/aws-geospatial/amazon-location-samples-ios/tree/main/tracking- with-geofence-notifications.

Öffnen Sie die Projektdatei AWSLocationSampleApp.xcodeproj.

Warte auf den Prozess zur Paketauflösung.

Optional: Benennen Sie im Projektnavigationsmenü in die folgenden Werte ConfigTemplate.xcconfig um Config.xcconfig und geben Sie sie ein:

IDENTITY_POOL_ID = `YOUR_IDENTITY_POOL_ID`
MAP_NAME = `YOUR_MAP_NAME`
TRACKER_NAME = `YOUR_TRACKER_NAME`
WEBSOCKET_URL = `YOUR_MQTT_TEST_CLIENT_ENDPOINT`
GEOFENCE_ARN = `YOUR_GEOFENCE_COLLECTION_NAME`   

Erstellen Sie die App und führen Sie sie aus.

Die App fragt Sie nach Standort- und Benachrichtigungsberechtigungen. Sie müssen sie zulassen.

Tippen Sie auf die Schaltfläche `Cognito-Konfiguration`.

Wenn Sie die Werte in der Datei `Config.xcConfig` nicht ausgefüllt haben, müssen Sie das Feld mit den Ressourcenwerten ausfüllen, die Sie zuvor im Konfigurationsbildschirm erstellt haben.

IDENTITY_POOL_ID = `YOUR_IDENTITY_POOL_ID`
MAP_NAME = `YOUR_MAP_NAME`
TRACKER_NAME = `YOUR_TRACKER_NAME`
WEBSOCKET_URL = `YOUR_MQTT_TEST_CLIENT_ENDPOINT`
GEOFENCE_ARN = `YOUR_GEOFENCE_COLLECTION_NAME`          

Speichern Sie die Konfiguration

Sie können jetzt die Filteroptionen für Zeit, Entfernung und Genauigkeit sehen. Verwenden Sie sie nach Ihren Bedürfnissen.

Gehen Sie in der App zum Tab `Tracking` und Sie werden die Karte und die Schaltfläche `Tracking starten` sehen.

Wenn Sie die App auf einem Simulator installiert haben, möchten Sie möglicherweise Standortänderungen simulieren. Dies kann über die Menüoption Funktionen -> Standort erfolgen. Wählen Sie zum Beispiel Funktionen -> Standort -> Freeway Drive.

Tippen Sie auf die Schaltfläche `Tracking starten`. Sie sollten die Tracking-Punkte auf der Karte sehen.

Die App verfolgt auch die Standorte im Hintergrund. Wenn Sie die App also im Hintergrund bewegen, werden Sie um Erlaubnis gebeten, die Verfolgung im Hintergrundmodus fortzusetzen.

Sie können das Tracking beenden, indem Sie auf die Schaltfläche `Stop Tracking` tippen.