Erstellen einer Android-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 aus.

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 aus.

Ö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 Endpunktwert.

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.

Navigieren Sie zu Amazon Cognito und öffnen Sie Ihren Identitätspool. Fahren Sie dann mit dem Benutzerzugriff fort und wählen Sie die Gastrolle aus.

Klicken Sie auf Berechtigungsrichtlinien, um die Bearbeitung zu aktivieren.

{
    'Version': '2012-10-17		 	 	 ',
    'Statement': [
        {
            'Action': [
                'geo:GetMap*',
                'geo:BatchUpdateDevicePosition',
                'geo:BatchEvaluateGeofences',
                'iot:Subscribe',
                'iot:Publish',
                'iot:Connect',
                'iot:Receive',
                'iot:AttachPrincipalPolicy',
                'iot:AttachPolicy',
                'iot:DetachPrincipalPolicy',
                'iot:DetachPolicy'
            ],
            'Resource': [
                'arn:aws:geo:us-east-1:{USER_ID}:map/{MAP_NAME}',
                'arn:aws:geo:us-east-1:{USER_ID}:tracker/{TRACKER_NAME}',
                'arn:aws:geo:us-east-1:{USER_ID}:geofence-collection/{GEOFENCE_COLLECTION_NAME}',
                'arn:aws:iot:us-east-1:{USER_ID}:client/${cognito-identity.amazonaws.com:sub}',
                'arn:aws:iot:us-east-1:{USER_ID}:topic/${cognito-identity.amazonaws.com:sub}',
                'arn:aws:iot:us-east-1:{USER_ID}:topicfilter/${cognito-identity.amazonaws.com:sub}/*',
                'arn:aws:iot:us-east-1:{USER_ID}:topic/${cognito-identity.amazonaws.com:sub}/tracker'
            ],
            'Effect': 'Allow'
        },
        {
            'Condition': {
                'StringEquals': {
                    'cognito-identity.amazonaws.com:sub': '${cognito-identity.amazonaws.com:sub}'
                }
            },
            'Action': [
                'iot:AttachPolicy',
                'iot:DetachPolicy',
                'iot:AttachPrincipalPolicy',
                'iot:DetachPrincipalPolicy'
            ],
            'Resource': [
                '*'
            ],
            'Effect': 'Allow'
        }
    ]
}

Mit den oben genannten Richtlinienänderungen sind nun alle erforderlichen AWS Ressourcen für die Anwendung entsprechend konfiguriert.

Öffnen Sie Android Studio und wählen Sie in der Versionskontrolle Neu und dann Projekt aus.

Navigieren Sie zum Menü Datei in der oberen linken Ecke von Android Studio.

Wählen Sie im Drop-down-Menü „Neu“ aus.

Wählen Sie „Projekt aus der Versionskontrolle“.

Geben Sie die Repository-URL ein. Suchen Sie im daraufhin angezeigten Dialogfeld nach dem Feld mit der Bezeichnung „URL“.

Kopieren Sie die folgende URL für die Beispiel-App und fügen Sie sie in dieses Feld ein: https://github.com/aws-geospatial/amazon-location-samples-android.git

Entscheiden Sie sich für das Verzeichnis, in das Sie das Repository klonen möchten. Verwenden Sie entweder das Standardverzeichnis oder entscheiden Sie sich für einen benutzerdefinierten Speicherort.

Nachdem Sie die Repository-URL und die Verzeichniseinstellungen festgelegt haben, klicken Sie auf die Schaltfläche „Klonen“. Android Studio klont das Repository weiter an den angegebenen Speicherort.

Sie haben die Anwendung jetzt auf Ihren Computer geklont und können sie verwenden.