Esempio di applicazione di tracciamento e geofencing per iOS

Apri la console Amazon Cognito e seleziona Pool di identità dal menu a sinistra, quindi 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 della console Amazon Location e seleziona Crea mappa.

Assegna un nome e una descrizione alla nuova mappa. Registra il nome che assegni, così come verrà usato 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 condizioni di Amazon Location, quindi seleziona Crea mappa per completare il processo di creazione della mappa.

Apri la sezione Mappe nella console Amazon Location.

Scegli Crea tracker.

Compila i campi obbligatori. Prendi nota del nome del tracker poiché verrà utilizzato come riferimento nel corso di questo tutorial.

Nel campo Filtro della posizione, scegli l'opzione più adatta a come intendi utilizzare la risorsa del tracker. Se non imposti il filtro di posizione, l'impostazione predefinita è. TimeBased Per ulteriori informazioni, consulta Start tracking e PositionFilteringnell'Amazon Location API Reference.

Scegli Crea tracker per completare la creazione del tracker.

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

Dalla barra di navigazione a sinistra, scegli Funzioni.

Quindi scegli Crea funzione e assicurati che sia selezionata l'opzione Autore da zero.

fornite un nome per la funzione e, per l'opzione Runtime, scegliete Node.js 16.x.

Scegli Crea funzione.

Aprite la scheda Codice per accedere all'editor.

Sovrascrivi il codice segnaposto nel index.js file 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 
                      }
                  }); 
                }
              });
            }

Premete Deploy per salvare la funzione aggiornata.

Quindi apri la scheda Configurazione.

Nella sezione Trigger, premi il pulsante Aggiungi trigger.

Seleziona EventBridge (CloudWatch Eventi) nel campo Origine.

Seleziona l'opzione Regole esistenti.

Inserisci il nome della regola, ad esempioAmazonLocationMonitor-GEOFENCECOLLECTION_NAME.

Premi il pulsante Aggiungi.

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

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

Nel riquadro di navigazione a sinistra, selezionate il client di test MQTT.

Verrà visualizzata una sezione intitolata Client di test MQTT in cui è possibile configurare la connessione MQTT.

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

Registra l'endpoint, così come verrà utilizzato più avanti nel tutorial.

Una volta connessi al client di test, è possibile abbonarsi agli argomenti MQTT o pubblicare messaggi sugli argomenti utilizzando i rispettivi campi di input forniti nell'interfaccia del client di test MQTT. Successivamente creerai una AWS IoT politica.

Nel menu a sinistra, in Gestione, 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 completamento del processo di risoluzione dei pacchetti.

Nel menu di navigazione del progetto, ConfigTemplate.xcconfig rinominate Config.xcconfig e inserite 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.

Premi il pulsante Configurazione Cognito.

Salvare la configurazione.

Ora puoi visualizzare 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 in Funzionalità nell'opzione del menu Posizione. Ad esempio, seleziona Caratteristiche, poi Posizione, quindi Freeway Drive.

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