Creare un'applicazione iOS

Nella AWS console, accedi al servizio Amazon Cognito, quindi seleziona Pool di identità dal menu a sinistra e seleziona Crea pool di identità.

Assicurati che Guest Access sia selezionato e premi Avanti per continuare.

Quindi crea un nuovo ruolo IAM o utilizza un ruolo IAM esistente.

Inserisci il nome di un pool di identità e assicurati che Identity Pool abbia accesso alle (geo) risorse di Amazon Location per la mappa e il tracker che creerai nella procedura successiva.

Vai alla sezione Mappe nella console Amazon Location e seleziona Crea mappa per visualizzare in anteprima gli stili di mappa disponibili.

Assegna un nome e una descrizione alla nuova risorsa cartografica. Registra il nome che assegni alla risorsa cartografica, poiché verrà utilizzato più avanti nel tutorial.

Quando scegli uno stile di mappa, considera il fornitore dei dati cartografici. Per maggiori dettagli, consulta la sezione 82 dei termini del AWS servizio.

Accetta i termini e le condizioni di Amazon Location, quindi seleziona Crea mappa. Dopo aver creato la mappa, puoi interagire con essa ingrandendo, rimpicciolendo o spostandola in qualsiasi direzione.

Apri la console Amazon Location Service.

Nel riquadro di navigazione a sinistra, scegli Trackers.

Scegli Crea tracker.

Compila tutti i campi obbligatori.

In Filtro di posizione, scegli l'opzione più adatta al modo in cui intendi utilizzare la risorsa del tracker. Se non imposti il filtro di posizione, l'impostazione predefinita è. TimeBased Per ulteriori informazioni, consulta Trackers in questa guida e PositionFiltering nell'Amazon Location Service Trackers API Reference.

Scegli Crea tracker per terminare.

Apri la console Amazon Location Service all'indirizzo https://console.aws.amazon.com/location/.

Nel riquadro di navigazione a sinistra, scegli Geofence Collections.

Scegli Crea collezione geofence.

Fornisci un nome e una descrizione per la raccolta.

In EventBridge rule with CloudWatch as a target, puoi creare una EventBridge regola opzionale per iniziare a reagire agli eventi di geofence. Ciò consente ad Amazon Location di pubblicare eventi su Amazon CloudWatch Logs.

Scegli Create geofence collection.

Apri la console Amazon Location.

Nel riquadro di navigazione a sinistra, scegli Trackers.

In Device Trackers, seleziona il link del nome del tracker di destinazione.

In Collezioni Geofence collegate, scegli Collega collezione Geofence.

Nella finestra Linked Geofence Collection, seleziona una collezione di geofence dal menu a discesa.

Scegliere Link (Collegamento).

Dopo aver collegato la risorsa tracker, ad essa verrà assegnato uno stato Attivo.

Apri la AWS Lambda console all'indirizzo. https://console.aws.amazon.com/lambda/

Dalla barra di navigazione a sinistra, scegli Funzioni.

Scegli Crea funzione e assicurati che sia selezionato Author from zero.

Compila le seguenti caselle:

Scegli Crea funzione.

Scegliete la scheda Codice per aprire l'editor.

Sovrascrivi il codice segnaposto in index.js con quanto segue:

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

Scegliete Deploy per salvare la funzione aggiornata.

Scegli la scheda Configurazione.

Nella sezione Trigger, fai clic su Aggiungi trigger.

Seleziona EventBridge (CloudWatch Eventi) nel campo Origine.

Seleziona l'opzione radio `Regole esistenti`.

Inserisci il nome della regola in questo modo `-GEOFENCECOLLECTION_NAME`. AmazonLocationMonitor

Fate clic sul pulsante Aggiungi.

Verranno inoltre allegate le `dichiarazioni politiche basate sulle risorse` nella scheda delle autorizzazioni

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

Nel riquadro di navigazione a sinistra, scegli MQTT test client.

Vedrai una sezione intitolata Client di test MQTT in cui puoi configurare la tua connessione MQTT.

Dopo aver configurato le impostazioni necessarie, fare clic sul pulsante Connect per stabilire una connessione al broker MQTT utilizzando i parametri forniti.

Prendi nota del valore Endpoint.

Nel menu a sinistra, sotto Gestisci, espandi l'opzione Sicurezza e fai clic su Politiche.

Fai clic sul pulsante Crea politica.

Inserire un nome per la policy.

In Policy Document seleziona la scheda JSON.

Copia e incolla la politica mostrata di seguito, ma assicurati di aggiornare tutti gli elementi con il tuo REGION eACCOUNT_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"
                 }
               ]
}        

Seleziona il pulsante Crea per terminare.

Clona il repository git da questo URL: https://github.com/aws-geospatial/amazon-location-samples-ios/tree/main/tracking-. with-geofence-notifications

Apri il file di progetto AWSLocationSampleApp.xcodeproj.

Attendi il processo di risoluzione del pacchetto.

Facoltativo: nel menu di navigazione del progetto, ConfigTemplate.xcconfig rinominare Config.xcconfig e inserire i seguenti valori:

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`   

Crea ed esegui l'app.

L'app ti chiederà le autorizzazioni di localizzazione e notifica. Devi consentirli.

Tocca il pulsante `Configurazione Cognito`.

Se non hai inserito i valori nel file `config.xcconfig`, devi compilare il campo con i valori delle risorse che hai creato in precedenza nella schermata di configurazione.

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`          

Salva la configurazione

Ora puoi vedere le opzioni di filtro per tempo, distanza e precisione. Usali secondo le tue necessità.

Vai alla scheda `Tracciamento` dell'app e vedrai la mappa e il pulsante `Avvia tracciamento`.

Se hai installato l'app su un simulatore, potresti voler simulare i cambiamenti di posizione. Questo può essere fatto nell'opzione del menu Caratteristiche -> Posizione. Ad esempio, seleziona Caratteristiche -> Posizione -> Freeway Drive.

Tocca il pulsante `Avvia tracciamento`. Dovresti vedere i punti di tracciamento sulla mappa.

L'app monitora anche le posizioni in background. Pertanto, quando sposti l'app in background, ti chiederà l'autorizzazione per continuare il tracciamento in modalità background.

Puoi interrompere il tracciamento toccando il pulsante `Stop Tracking`.