建立 Android 應用程式

在 AWS 主控台中，導覽至 Amazon Cognito 服務，然後從左側選單中選取身分集區，然後選取建立身分集區。

確定已核取訪客存取，然後按下一步繼續。

接著建立新的 IAM 角色或使用現有的 IAM 角色。

輸入身分集區名稱，並確保身分集區可以存取您將在下一個程序中建立的映射和追蹤器的 Amazon Location (geo)資源。

導覽至 Amazon Location 主控台中的映射區段，然後選取建立映射以預覽可用的映射樣式。

為新的映射資源命名和描述。記錄您指派給映射資源的名稱，因為它稍後會在教學課程中使用。

選擇映射樣式時，請考慮映射資料提供者。如需詳細資訊，請參閱 AWS 服務條款的第 82 節。

接受 Amazon Location 條款與條件，然後選取建立映射。建立地圖之後，您可以透過放大、縮小或平移任何方向來與地圖互動。

開啟 Amazon Location Service 主控台。

在左側導覽窗格中，選擇追蹤器。

選擇建立追蹤器。

填寫所有必要欄位。

在位置篩選下，選擇最符合您打算如何使用追蹤器資源的選項。如果您未設定位置篩選，則預設設定為 TimeBased。如需詳細資訊，請參閱本指南中的追蹤器，以及 Amazon Location Service Trackers API 參考中的 PositionFiltering。

選擇建立追蹤器以完成。

開啟位於 https：//https://console.aws.amazon.com/location/ 的 Amazon Location Service 主控台。

在左側導覽窗格中，選擇 Geofence 集合。

選擇建立地理圍欄集合。

提供集合的名稱和描述。

在以 CloudWatch 做為目標的 EventBridge 規則下，您可以建立選用的 EventBridge 規則，以開始對地理圍欄事件做出反應。這讓 Amazon Location 能夠將事件發佈到 Amazon CloudWatch Logs 中。

選擇建立地理圍欄集合。

開啟 Amazon Location 主控台。

在左側導覽窗格中，選擇追蹤器。

在裝置追蹤器下，選取目標追蹤器的名稱連結。

在連結的地理圍欄集合下，選擇連結地理圍欄集合。

在連結的地理圍欄集合視窗中，從下拉式功能表中選取地理圍欄集合。

選擇 Link (連結)。

連結追蹤器資源後，會為其指派作用中狀態。

在 https：//https://console.aws.amazon.com/lambda/ 開啟 AWS Lambda 主控台。

從左側導覽中，選擇函數。

選擇建立函數，並確定已選取從頭開始撰寫。

填寫下列方塊：

選擇 Create function (建立函數)。

選擇程式碼索引標籤以開啟編輯器。

使用下列項目覆寫 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 
               }
        }); 
       }
      });
     }

選擇部署以儲存更新的函數。

選擇 Configuration (組態) 索引標籤。

在觸發條件區段中，按一下新增觸發條件。

在來源欄位中選取 EventBridge (CloudWatch Events)。

選取 `現有規則` 選項選項。

輸入類似此 `AmazonLocationMonitor-GEOFENCECOLLECTION_NAME` 的規則名稱。

按一下新增按鈕。

這也會在許可索引標籤中連接以資源為基礎的政策陳述式

開啟 https：//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 將繼續將儲存庫複製到您指定的位置。

您現在已將應用程式複製到您的機器，並可以開始使用它。