创建 Android 应用程序

在 AWS 控制台中，导航至 Amazon Cognito 服务，从左侧菜单中选择身份池，然后选择创建身份池。

确保选中访客访问权限，然后按下一步继续。

接下来，创建一个新 IAM 角色或使用现有 IAM 角色。

输入身份池名称，并确保身份池可以访问您将在接下来的步骤中创建的地图和跟踪器的 Amazon Location (geo) 资源。

导航至 Amazon Location 控制台的地图部分，然后选择创建地图，预览可用的地图样式。

为新地图资源提供名称和描述。记录您分配给地图资源的名称，因为稍后本教程会使用该名称。

选择地图样式时，请考虑地图数据提供程序。有关更多详细信息，请参阅 AWS 服务条款的第 82 节。

接受 Amazon Location 条款和条件，然后选择创建地图。创建地图后，您可以通过放大、缩小或向任意方向平移来与地图进行交互。

打开 Amazon Location Service 控制台。

在左侧导航窗格中，选择跟踪器。

选择创建跟踪器。

填写所有必填字段。

在位置筛选下，选择最适合您打算如何使用跟踪器资源的选项。如果未设置位置筛选，则默认设置为 TimeBased。有关更多信息，请参阅本指南中的“跟踪器”，以及《Amazon Location Service 跟踪器 API 参考》中的“PositionFiltering”。

选择创建跟踪器完成操作。

打开 Amazon Location Service 控制台：https://console.aws.amazon.com/location/。

在左侧导航窗格中，选择“地理围栏集合”。

选择创建地理围栏集合。

为集合提供名称和描述。

根据以 CloudWatch 为目标的 EventBridge 规则，您可以创建一条可选的 EventBridge 规则，以开始对地理围栏事件做出反应。这使 Amazon Location 能够向 Amazon CloudWatch Logs 发布事件。

选择创建地理围栏集合。

打开 Amazon Location 控制台。

在左侧导航窗格中，选择跟踪器。

在设备跟踪器下，选择目标跟踪器的名称链接。

在链接的地理围栏集合下，选择链接地理围栏集合。

在链接的地理围栏集合窗口中，从下拉菜单中选择一个地理围栏集合。

选择链接。

在您关联跟踪器资源后，它将处于活动状态。

通过 https://console.aws.amazon.com/lambda/ 打开 AWS Lambda 控制台。

从左侧导航窗格中，选择函数。

选择创建函数，并确保选择从头开始创作。

填写以下选框：

选择“创建函数”。

选择“代码”选项卡以打开编辑器。

在 index.js 中使用以下内容覆盖占位符代码：

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

选择部署以保存您更新的函数。

选择配置选项卡。

在“触发器”部分中，单击“添加触发器”。

在“源”字段中选择 EventBridge (CloudWatch Events)。

选择“现有规则”单选选项。

输入类似这样的规则名称：“AmazonLocationMonitor-GEOFENCECOLLECTION_NAME”。

单击“添加”按钮。

此时，系统还会在“权限”选项卡中附加“基于资源的策略声明”

打开 https://console.aws.amazon.com/iot/。

在左侧导航窗格中，选择 MQTT 测试客户端。

您将看到标题为 MQTT 测试客户端的部分，您可以在其中配置 MQTT 连接。

配置必要的设置后，单击连接按钮，使用提供的参数建立与 MQTT 代理的连接。

记下端点值。

在左侧菜单的管理下，展开安全性选项，然后单击策略。

单击创建策略按钮。

输入策略名称。

在策略文档上，选择 JSON 选项卡。

复制粘贴下面显示的策略，但请务必使用您的 REGION 和 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"
                }
              ]
}

选择创建按钮完成操作。

导航至 Amazon Cognito 并打开您的身份池。然后，继续设置用户访问权限并选择访客角色。

单击权限策略以启用编辑。

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

通过上述策略更改，现在已为应用程序正确配置所有必要的 AWS 资源。

打开 Android Studio，选择新建，然后选择版本控制中的项目。

导航至 Android Studio 左上角的文件菜单。

从下拉菜单中选择“新建”。

选择“版本控制中的项目”。

输入存储库 URL。在出现的对话框中，找到标有“URL”的字段。

将示例应用程序的以下 URL 复制并粘贴到此字段中：https://github.com/aws-geospatial/amazon-location-samples-android.git

确定要将存储库克隆到哪个目录。使用默认目录，或选择自定义位置。

设置存储库 URL 和目录首选项后，点击“克隆”按钮。Android Studio 会继续将存储库克隆到您指定的位置。

现在，您已将应用程序克隆到计算机上，可以开始使用它了。