Création d'une application iOS

Dans la AWS console, accédez au service Amazon Cognito, puis sélectionnez Groupes d'identités dans le menu de gauche, puis sélectionnez Créer un pool d'identités.

Assurez-vous que l'option Accès invité est cochée, puis appuyez sur Suivant pour continuer.

Créez ensuite un nouveau rôle IAM ou utilisez un rôle IAM existant.

Entrez le nom du pool d'identités et assurez-vous que le pool d'identités a accès aux (geo) ressources Amazon Location pour la carte et le tracker que vous allez créer lors de la procédure suivante.

Accédez à la section Cartes de la console Amazon Location et sélectionnez Create Map pour prévisualiser les styles de carte disponibles.

Donnez un nom et une description à la nouvelle ressource cartographique. Enregistrez le nom que vous attribuez à la ressource cartographique, tel qu'il sera utilisé ultérieurement dans le didacticiel.

Lorsque vous choisissez un style de carte, pensez au fournisseur de données cartographiques. Reportez-vous à la section 82 des conditions de AWS service pour plus de détails.

Acceptez les conditions générales d'Amazon Location, puis sélectionnez Create Map. Une fois la carte créée, vous pouvez interagir avec elle en zoomant, en arrière ou en vous déplaçant dans n'importe quelle direction.

Ouvrez la console Amazon Location Service.

Dans le volet de navigation de gauche, choisissez Trackers.

Choisissez Créer un tracker.

Remplissez tous les champs obligatoires.

Sous Filtrage des positions, choisissez l'option qui correspond le mieux à la manière dont vous avez l'intention d'utiliser votre ressource de suivi. Si vous ne définissez pas le filtrage de position, le paramètre par défaut est TimeBased. Pour plus d'informations, consultez la section Trackers dans ce guide et PositionFiltering dans le manuel Amazon Location Service Trackers API Reference.

Choisissez Créer un tracker pour terminer.

Ouvrez la console Amazon Location Service à l'adresse https://console.aws.amazon.com/location/.

Dans le volet de navigation de gauche, choisissez Geofence Collections.

Choisissez Créer une collection de géofences.

Saisissez un nom et une description pour la collection.

Dans le cadre d'une EventBridge règle avec CloudWatch comme cible, vous pouvez créer une EventBridge règle facultative pour commencer à réagir aux événements de géofence. Cela permet à Amazon Location de publier des événements sur Amazon CloudWatch Logs.

Choisissez Créer une collection de géofences.

Ouvrez la console Amazon Location.

Dans le volet de navigation de gauche, choisissez Trackers.

Sous Device Trackers, sélectionnez le lien du nom du tracker cible.

Sous Collections Geofence liées, choisissez Link Geofence Collection.

Dans la fenêtre Linked Geofence Collection, sélectionnez une collection de géofences dans le menu déroulant.

Choisissez Lier.

Une fois que vous aurez lié la ressource de suivi, le statut Actif lui sera attribué.

Ouvrez la AWS Lambda console à l'adresse https://console.aws.amazon.com/lambda/.

Dans le menu de navigation de gauche, choisissez Functions.

Choisissez Créer une fonction et assurez-vous que l'option Auteur à partir de zéro est sélectionnée.

Remplissez les cases suivantes :

Choisissez Créer une fonction.

Cliquez sur l'onglet Code pour ouvrir l'éditeur.

Remplacez le code de l'espace réservé dans le fichier index.js par le code suivant :

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 
                      }
                  }); 
                }
              });
            }

Choisissez Déployer pour enregistrer la fonction mise à jour.

Cliquez sur l’onglet Configuration.

Dans la section Déclencheurs, cliquez sur Ajouter un déclencheur.

Sélectionnez EventBridge (CloudWatch Événements) dans le champ Source.

Sélectionnez l'option radio « Règles existantes ».

Entrez le nom de la règle comme suit `AmazonLocationMonitor-GEOFENCECOLLECTION_NAME`.

Cliquez sur le bouton Ajouter.

Cela ajoutera également des « déclarations de politique basées sur les ressources » dans l'onglet des autorisations

Ouvrez la https://console.aws.amazon.com/iot/.

Dans le volet de navigation de gauche, choisissez le client de test MQTT.

Vous verrez une section intitulée Client de test MQTT dans laquelle vous pouvez configurer votre connexion MQTT.

Après avoir configuré les paramètres nécessaires, cliquez sur le bouton Connect pour établir une connexion avec le broker MQTT à l'aide des paramètres fournis.

Prenez note de la valeur du point de terminaison.

Dans le menu de gauche, sous Gérer, développez l'option de sécurité et cliquez sur Politiques.

Cliquez sur le bouton Créer une politique.

Entrez un nom de stratégie.

Dans le document de politique, sélectionnez l'onglet JSON.

Copiez-collez la politique ci-dessous, mais assurez-vous de mettre à jour tous les éléments avec votre REGION et ACCOUNT_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"
                 }
               ]
}        

Cliquez sur le bouton Créer pour terminer.

Clonez le dépôt git à partir de cette URL : https://github.com/aws-geospatial/amazon-location-samples-ios/tree/main/tracking- with-geofence-notifications.

Ouvrez le fichier de projet AWSLocationSampleApp.xcodeproj.

Attendez le processus de résolution du package.

Facultatif : Dans le menu de navigation du projet, renommez ConfigTemplate.xcconfig Config.xcconfig et renseignez les valeurs suivantes :

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`   

Créez et exécutez l'application.

L'application vous demandera des autorisations de localisation et de notification. Tu dois les autoriser.

Appuyez sur le bouton « Configuration Cognito ».

Si vous n'avez pas renseigné les valeurs du fichier `Config.xcConfig`, vous devez remplir le champ avec les valeurs de ressources que vous avez créées précédemment dans l'écran de configuration.

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`          

Enregistrez la configuration

Vous pouvez désormais voir les options de filtre pour le temps, la distance et la précision. Utilisez-les selon vos besoins.

Accédez à l'onglet « Suivi » de l'application et vous verrez la carte et le bouton « Démarrer le suivi ».

Si vous avez installé l'application sur un simulateur, vous souhaiterez peut-être simuler des changements de position. Cela peut être fait dans l'option du menu Fonctionnalités -> Emplacement. Par exemple, sélectionnez Fonctionnalités -> Emplacement -> Freeway Drive.

Appuyez sur le bouton « Démarrer le suivi ». Vous devriez voir les points de suivi sur la carte.

L'application suit également les emplacements en arrière-plan. Ainsi, lorsque vous déplacez l'application en arrière-plan, elle vous demandera l'autorisation de poursuivre le suivi en mode arrière-plan.

Vous pouvez arrêter le suivi en appuyant sur le bouton « Arrêter le suivi ».