Criar um aplicativo Android

No console da AWS, navegue até o serviço Amazon Cognito e selecione Bancos de identidades no menu do lado esquerdo e, em seguida, selecione Criar banco de identidades.

Verifique se a opção Acesso de convidado está marcada e pressione Avançar para continuar.

Escolha um perfil do IAM existente ou crie um novo.

Insira o nome do banco de identidades e certifique-se de que o banco de identidades tenha acesso aos recursos de (geo) do Amazon Location para o mapa e o rastreador que você criará no próximo procedimento.

Navegue até a seção Mapas do console do Amazon Location e selecione Criar mapa para visualizar os estilos de mapa disponíveis.

Dê um nome e uma descrição ao novo recurso de mapa. Registre o nome que você atribuir ao recurso de mapa, conforme ele será usado posteriormente no tutorial.

Ao escolher um estilo de mapa, considere o provedor de dados do mapa. Consulte a seção 82 dos Termos de serviço da AWS para obter mais detalhes.

Aceite os Termos e condições do Amazon Location e selecione Criar mapa. Após criar o mapa, você pode interagir com ele ampliando, reduzindo o zoom ou fazendo uma panorâmica em qualquer direção.

Abra o console do Amazon Location Service.

No painel de navegação à esquerda, selecione Rastreadores.

Selecione Criar rastreador.

Preencha os campos obrigatórios:

Em Filtragem de posições, escolha a opção que melhor se adequa à forma como você pretende usar seu recurso de rastreador. Se você não definir a Filtragem de posições, a configuração padrão será TimeBased. Para obter mais informações, consulte Rastreadores neste guia e PositionFiltering na Referência de APIs para rastreadores do Amazon Location Service.

Escolha Criar rastreador para finalizar.

Abra o console do Amazon Location Service em https://console.aws.amazon.com/location/.

No painel de navegação à esquerda, selecione Coleções de geocercas.

Selecione Criar coleção de geocercas.

Forneça um nome e uma descrição para a coleção.

De acordo com a regra do EventBridge com o CloudWatch como alvo, você pode criar uma regra opcional do EventBridge para começar a reagir aos eventos das geocercas. Isso permite que o Amazon Location publique eventos no Amazon CloudWatch Logs.

Selecione Criar coleção de geocercas.

Abra o console do Amazon Location.

No painel de navegação à esquerda, selecione Rastreadores.

Em Rastreadores de dispositivos, selecione o link do nome do rastreador de destino.

Em Coleções de geocercas vinculadas, selecione Vincular coleção de geocercas.

Na janela Coleção de geocercas vinculadas, selecione uma coleção de geocercas no menu suspenso.

Escolha Vincular.

Depois de vincular o recurso de rastreador, ele receberá um status de Ativo.

Abra o console AWS Lambda em https://console.aws.amazon.com/lambda/.

No painel de navegação à esquerda, selecione Funções.

Selecione Criar função e confirme se Autor do zero está selecionado.

Preencha as seguintes caixas:

Escolha a opção Criar função.

Selecione a guia Código para abrir o editor.

Substitua o código do espaço reservado em index.js pelo seguinte:

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

Selecione Implantar para salvar a função atualizada.

Escolha a guia Configuração.

Na seção Acionadores, escolha Adicionar acionador.

Selecione EventBridge (CloudWatch Events) no campo Fonte.

Selecione a opção de rádio “Regras existentes”.

Por exemplo, insira o nome “AmazonLocationMonitor-GEOFENCECECOLLECTION_NAME`.

Clique no botão Adicionar.

Isso também anexará `Resource-based policy statements` (declarações de políticas baseadas em recursos) na guia de permissões

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

No painel de navegação, escolha Cliente de teste MQTT.

Você verá uma seção intitulada Cliente de teste MQTT, na qual você pode configurar sua conexão MQTT.

Depois de definir as configurações necessárias, clique no botão Connect para estabelecer uma conexão com o broker MQTT usando os parâmetros fornecidos.

Anote o valor do endpoint.

No menu do lado esquerdo, em Gerenciar, expanda a opção Segurança e clique em Políticas.

Clique no botão Criar política.

Insira um nome de política.

Em Documento de política, selecione a guia JSON.

Copie e cole a política mostrada abaixo, mas certifique-se de atualizar todos os elementos com seu REGION e 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"
                }
              ]
}

Selecione o botão Criar para finalizar.

Navegue até o Amazon Cognito e abra seu banco de identidades. Em seguida, vá para o acesso do usuário e selecione a função de convidado.

Clique nas políticas de permissão para ativar a edição.

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

Com as mudanças de política acima, todos os AWS recursos necessários agora estão configurados adequadamente para a aplicação.

Abra o Android Studio e selecione Novo e, em seguida, Projeto no controle de versão.

Navegue até o menu Arquivo no canto superior esquerdo do Android Studio.

No menu suspenso, selecione “Novo”.

Escolha “Projeto no controle de versão”.

Insira o URL do repositório na caixa de diálogo exibida, localize o campo marcado como “URL”.

Copie e cole o seguinte URL da aplicação de exemplo neste campo: https://github.com/aws-geospatial/amazon-location-samples-android.git

Decida em qual diretório você deseja clonar o repositório. Use o diretório padrão ou opte por um local personalizado.

Depois de definir o URL do repositório e as preferências do diretório, clique no botão “Clonar”. O Android Studio continuará clonando o repositório no local especificado.

Agora você clonou o aplicativo em sua máquina e pode começar a usá-lo.