Tutorial: Use AWS Lambda com o MQTT

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

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

Selecione Criar rastreador.

Preencha as seguintes caixas:

Selecione Criar rastreador.

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:

Selecione Criar função.

Selecione a guia Código para abrir o editor.

Substitua o código do espaço reservado em lambda_function.py pelo seguinte, substituindo o valor atribuído a TRACKER_NAME pelo nome do rastreador que você criou como pré-requisito.

from datetime import datetime
import json
import os

import boto3

# Update this to match the name of your Tracker resource
TRACKER_NAME = "MyTracker"

"""
This Lambda function receives a payload from AWS IoT Core and publishes device updates to 
Amazon Location Service via the BatchUpdateDevicePosition API.

Parameter 'event' is the payload delivered from AWS IoT Core.

In this sample, we assume that the payload has a single top-level key 'payload' and a nested key
'location' with keys 'lat' and 'long'. We also assume that the name of the device is nested in
the payload as 'deviceid'. Finally, the timestamp of the payload is present as 'timestamp'. For
example:

>>> event
{ 'payload': { 'deviceid': 'thing123', 'timestamp': 1604940328,
  'location': { 'lat': 49.2819, 'long': -123.1187 },
  'accuracy': {'Horizontal': 20.5 },
  'positionProperties': {'field1':'value1','field2':'value2'} }
}

If your data doesn't match this schema, you can either use the AWS IoT Core rules engine to
format the data before delivering it to this Lambda function, or you can modify the code below to
match it.
"""
def lambda_handler(event, context):
  update = {
      "DeviceId": event["payload"]["deviceid"],
      "SampleTime": datetime.fromtimestamp(event["payload"]["timestamp"]).strftime("%Y-%m-%dT%H:%M:%SZ"),
      "Position": [
        event["payload"]["location"]["long"],
        event["payload"]["location"]["lat"]
        ]
    }
  if "accuracy" in event["payload"]:
      update["Accuracy"] = event["payload"]['accuracy']
  if "positionProperties" in event["payload"]:
      update["PositionProperties"] = event["payload"]['positionProperties']
 
  client = boto3.client("location")
  response = client.batch_update_device_position(TrackerName=TRACKER_NAME, Updates=[update])

  return {
    "statusCode": 200,
    "body": json.dumps(response)
  }

Selecione Implantar para salvar a função atualizada.

Escolha a guia Configuração.

Na seção Permissões, escolha o nome da Função com hiperlink para conceder permissões do Amazon Location Service à sua função do Lambda.

Na página de Resumo do seu perfil, escolha Adicionar permissões e, na lista suspensa, selecione Criar política embutida.

Escolha a guia JSON e sobrescreva a política com o seguinte documento. Isso permite que sua função do Lambda atualize as posições do dispositivo gerenciadas por todos os recursos do rastreador em todas as Regiões.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "WriteDevicePosition",
      "Effect": "Allow",
      "Action": "geo:BatchUpdateDevicePosition",
      "Resource": "arn:aws:geo:*:*:tracker/*"
    }
  ]
}

Escolha Revisar política.

Insira um nome de política. Por exemplo, AmazonLocationTrackerWriteOnly.

Escolha Criar política.

Faça login no console do AWS IoT Core em https://console.aws.amazon.com/iot/.

No painel de navegação à esquerda, expanda Agir e Regras.

Escolha Criar uma regra para iniciar o novo assistente de regras.

Insira um nome e uma descrição para a regra.

Para a Declaração de regra de consulta, atualize o atributo FROM para se referir a um tópico em que pelo menos um dispositivo esteja publicando telemetria que inclua a localização. Se você estiver testando a solução, nenhuma modificação será necessária.

SELECT * FROM 'iot/topic'

Em Definir uma ou mais ações, selecione Adicionar ação.

Selecione Enviar uma mensagem para uma função do Lambda.

Escolha Configurar ação.

Encontre e selecione sua função do Lambda na lista.

Selecione Adicionar ação.

Escolha Criar regra.

Faça login no console do AWS IoT Core em https://console.aws.amazon.com/iot/.

No painel de navegação à esquerda, expanda Teste e escolha Cliente de teste MQTT.

Em Publicar em um tópico, defina o Nome do tópico como iot/tópico (ou o nome do tópico que você configurou na sua regra AWS IoT Core, se for diferente) e forneça o seguinte para a Carga útil da mensagem. Substitua o carimbo de data/hora 1604940328 por um carimbo de data/hora válido nos últimos 30 dias (qualquer carimbo de data/hora anterior a 30 dias é ignorado).

{
  "payload": {
    "deviceid": "thing123",
    "timestamp": 1604940328,
    "location": { "lat": 49.2819, "long": -123.1187 },
    "accuracy": { "Horizontal": 20.5 },
    "positionProperties": { "field1": "value1", "field2": "value2" }
  }
}

Escolha Publicar no tópico para enviar a mensagem de teste.

Para validar se a mensagem foi recebida pelo Amazon Location Service, use o comando AWS CLI a seguir. Se você o modificou durante a configuração, substitua o nome do rastreador e o ID do dispositivo pelos que você usou.

aws location batch-get-device-position --tracker-name MyTracker --device-ids thing123