Create an Android application

In the AWS console, navigate to the Amazon Cognito service and then select Identity pools from the left side menu and select Create Identity pool.

Make sure Guest Access is checked, and press Next to continue.

Next create a new IAM role or Use an existing IAM role.

Enter an Identity pool name, and make sure Identity Pool has access to Amazon Location (geo)resources for the map and tracker you will be creating in the next procedure.

Navigate to the Maps section in the Amazon Location console and select Create Map to preview available map styles.

Give the new map resource a Name and Description. Record the name you assign to the map resource, as it is used later in the tutorial.

When choosing a map style, consider the map data provider. Refer to section 82 of the AWS service terms for more details.

Accept the Amazon Location Terms and Conditions, then select Create Map. After map has been created, you can interact with the map by zooming in, out, or panning in any direction.

Open the Amazon Location Service console.

In the left navigation pane, choose Trackers.

Choose Create tracker.

Fill in the all the required fields.

Under Position filtering, choose the option that best fits how you intend to use your tracker resource. If you do not set Position filtering, the default setting is TimeBased. For more information, see Trackers in this guide, and PositionFiltering in the Amazon Location Service Trackers API Reference.

Choose Create tracker to finish.

Open the Amazon Location Service console at https://console.aws.amazon.com/location/.

In the left navigation pane, choose Geofence Collections.

Choose Create geofence collection.

Provide a name and description for the collection.

Under EventBridge rule with CloudWatch as a target, you can create an optional EventBridge rule to get started reacting to geofence events. This enables Amazon Location to publish events to Amazon CloudWatch Logs.

Choose Create geofence collection.

Open the Amazon Location console.

In the left navigation pane, choose Trackers.

Under Device Trackers, select the name link of the target tracker.

Under Linked Geofence Collections, choose Link Geofence Collection.

In the Linked Geofence Collection window, select a geofence collection from the dropdown menu.

Choose Link.

After you link the tracker resource, it will be assigned an Active status.

Open the AWS Lambda console at https://console.aws.amazon.com/lambda/.

From the left navigation, choose Functions.

Choose Create Function, and make sure that Author from scratch is selected.

Fill out the following boxes:

Choose Create function.

Choose the Code tab to open the editor.

Overwrite the placeholder code in index.js with the following:

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

Choose Deploy to save the updated function.

Choose the Configuration tab.

In the Triggers section, click on Add trigger.

Select EventBridge (CloudWatch Events) in Source field.

Select `Existing Rules` radio option.

Enter the rule name like this `AmazonLocationMonitor-GEOFENCECOLLECTION_NAME`.

Click on the Add button.

This will also attach `Resource-based policy statements` in permissions tab

Open the https://console.aws.amazon.com/iot/.

In the left navigation pane, choose MQTT test client.

You'll see a section titled MQTT test client where you can configure your MQTT connection.

After configuring the necessary settings, click on the Connect button to establish a connection to the MQTT broker using the provided parameters.

Note down Endpoint value.

On the left side menu, under Manage expand Security option and click on Policies.

Click on Create Policy button.

Enter a policy name.

On Policy Document select JSON tab.

Copy paste the policy shown below, but make sure to update all elements with your REGION and 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"
                }
              ]
}

Select the Create button to finish.

Navigate to Amazon Cognito and open your identity pool. Then, proceed to user access and select the guest role.

Click on permission policies to enable editing.

{
    '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'
        }
    ]
}

With the above policy changes, all necessary AWS resources are now configured appropriately for the application.

Open Android Studio and select New and then Project from Version Control.

Navigate to the File menu in Android Studio’s top left corner.

Select “New” from the dropdown menu.

Choose “Project from Version Control”.

Enter Repository URL In the dialogue box that appears, find the field marked “URL”.

Copy and paste the following URL for the sample app into this field:https://github.com/aws-geospatial/amazon-location-mobile-sdk-sample-app-android.git

Decide on the directory where you want to clone the repository. Use either the default directory or opt for a custom location.

After setting the repository URL and directory preferences, hit the “Clone” button. Android Studio will proceed to clone the repository to your specified location.

You have now cloned the application to your machine and can begin using it.