As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Rastreadores do Amazon Location Service ![\[O diagrama mostra como criar e usar os recursos do rastreador.\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/images/illustration-trackers.PNG) **nota** O armazenamento do rastreador é criptografado automaticamente com chaves próprias da AWS. Você pode adicionar outra camada de criptografia usando as chaves KMS que você gerencia para garantir que somente você possa acessar seus dados. Para obter mais informações, consulte [Criptografia de dados em repouso para o Amazon Location Service](encryption-at-rest.md). Um rastreador armazena atualizações de posição para uma coleção de dispositivos. O rastreador pode ser usado para consultar a localização atual ou o histórico de localização dos dispositivos. Ele armazena as atualizações, mas reduz o espaço de armazenamento e o ruído visual ao filtrar os locais antes de armazená-los. Cada atualização de posição armazenada nos recursos do seu rastreador pode incluir uma medida da precisão da posição e até 3 campos de metadados sobre a posição ou o dispositivo que você deseja armazenar. Os metadados são armazenados como pares chave-valor e podem armazenar informações como velocidade, direção, pressão dos pneus ou temperatura do motor. A consulta e a filtragem da posição do rastreador são úteis por si só, mas os rastreadores são particularmente úteis quando combinados com geocercas. Você pode vincular rastreadores a um ou mais dos seus recursos de coleção de geocercas e as atualizações de posição são avaliadas automaticamente em relação às geocercas dessas coleções. O uso adequado da filtragem também pode reduzir consideravelmente os custos de suas avaliações de geocercas. 1. Primeiro, você cria um recurso de rastreador na sua conta da AWS. 1. Em seguida, decida como você envia atualizações de localização para seus recursos do rastreador. Use [AWS SDKs](dev-sdks.md) para integrar recursos de rastreamento em seus aplicativos móveis. Como alternativa, você pode usar o MQTT seguindo as instruções passo a passo em [rastreamento usando o MQTT.](tracking-using-mqtt.md) 1. Agora você pode usar seu recurso de rastreamento para registrar o histórico de localização e visualizá-lo em um mapa. 1. Você também pode vincular seu recurso de rastreador a uma ou mais coleções de geocercas para que cada atualização de posição enviada ao seu recurso de rastreamento seja avaliada automaticamente em relação a todas as coleções de geocercas vinculadas. Você pode vincular o recurso na página de detalhes do recurso de rastreador do console do Amazon Location ou usando a API Amazon Location Trackers. 1. Em seguida, é possível integrar o monitoramento usando serviços como o Amazon CloudWatch e o AWS CloudTrail. Para obter mais informações, consulte [Monitore com a Amazon CloudWatch](cloudwatch.md) e [Monitore e registre com AWS CloudTrail](cloudtrail.md). ## Atributos + **Filtragem de posição** – Os rastreadores podem filtrar automaticamente as posições que são enviadas a eles. Há várias razões pelas quais você pode querer filtrar algumas atualizações de localização do seu dispositivo. Se você tem um sistema que envia relatórios a cada minuto, talvez queira filtrar os dispositivos por tempo, armazenando e avaliando as posições somente a cada 30 segundos. Mesmo se você estiver monitorando com mais frequência, talvez queira filtrar as atualizações de posição para eliminar o ruído inerente associado ao hardware de GPS e ao relatório de posição. Sua precisão não é 100% perfeita, então até mesmo um dispositivo estacionário parece estar se movendo um pouco. Em baixas velocidades, essa *instabilidade* causa confusão visual e pode causar eventos falsos de entrada e saída se o dispositivo estiver próximo à borda de uma geocerca. A filtragem de posição funciona quando as atualizações de posição são recebidas por um rastreador, reduzindo o ruído visual nos caminhos do dispositivo (instabilidade), reduzindo o número de eventos falsos de entrada e saída da geocerca e ajudando a gerenciar custos ao reduzir o número de atualizações de posição armazenadas e avaliações de geocercas acionadas. Os rastreadores oferecem três opções de filtragem de posições para ajudar a gerenciar custos e reduzir a instabilidade nas atualizações de localização. + **Baseado na precisão**: *use com qualquer dispositivo que forneça uma medição de precisão. A maioria dos dispositivos GPS e móveis fornece essas informações.* A precisão de cada medição de posição é afetada por muitos fatores ambientais, incluindo recepção de satélite GPS, paisagem e a proximidade de dispositivos Wi-Fi e Bluetooth. A maioria dos dispositivos, incluindo a maioria dos dispositivos móveis, pode fornecer uma estimativa da precisão da medição junto com a medição. Com a filtragem `AccuracyBased`, o Amazon Location ignora atualizações de localização se o dispositivo tiver se movido menos em relação à precisão medida. Por exemplo, se duas atualizações consecutivas de um dispositivo tiverem uma faixa de precisão de 5 m e 10 m, o Amazon Location ignora a segunda atualização se o dispositivo tiver se movido menos de 15 m. O Amazon Location não avalia nem armazena as atualizações ignoradas em relação a geocercas. Quando a precisão não é fornecida, ela é tratada como zero, a medição é considerada perfeitamente precisa e nenhuma filtragem será aplicada às atualizações. **nota** Você pode usar a filtragem baseada em precisão para remover toda a filtragem. Se você selecionar a filtragem com base na precisão, mas substituir todos os dados de precisão para zero ou omitir totalmente a precisão, o Amazon Location não filtrará nenhuma atualização. + **Baseada na distância** – *Use quando seus dispositivos não fornecerem uma medição precisa, mas você quiser aproveitar a filtragem para reduzir a instabilidade e gerenciar os custos.* A filtragem `DistanceBased` ignora atualizações de localização nas quais dispositivos tenham se movido menos de 30 m (98,4 pés). Quando você usa a filtragem de posições `DistanceBased`, o Amazon Location não avalia nem armazena essas atualizações ignoradas em relação a geocercas. A precisão da maioria dos dispositivos móveis, incluindo a precisão média dos dispositivos iOS e Android, é de cerca de 15 m. Na maioria dos aplicativos, a filtragem `DistanceBased` pode reduzir o efeito das imprecisões de localização ao exibir a trajetória do dispositivo em um mapa e o efeito de vai e vem de vários eventos consecutivos de entrada e saída quando os dispositivos estão próximos à borda de uma geocerca. Ela também pode ajudar a reduzir o custo do seu aplicativo, fazendo menos chamadas para avaliar as geocercas vinculadas ou recuperar as posições dos dispositivos. A filtragem baseada em distância é útil se você quiser filtrar, mas seu dispositivo não fornecer medições de precisão, ou se você deseja filtrar um número maior de atualizações do que com base na precisão. + **Baseada no tempo**: (padrão) *use quando seus dispositivos enviam atualizações de posição com muita frequência (mais de uma vez a cada 30 segundos) e você deseja obter as avaliações da geocerca em tempo quase real sem armazenar todas as atualizações.* Na filtragem `TimeBased`, cada atualização de localização é avaliada em relação a coleções de geocercas vinculadas, mas nem todas as atualizações de localização são armazenadas. Se a frequência de atualização for superior a 30 segundos, apenas uma atualização a cada 30 segundos será armazenada para cada ID de dispositivo exclusivo. A filtragem baseada em tempo é particularmente útil quando você deseja armazenar menos posições, mas deseja que cada atualização de posição seja avaliada em relação às coleções de geocercas associadas. **nota** Esteja atento aos custos do seu aplicativo de rastreamento ao decidir seu método de filtragem e a frequência das atualizações de posição. Você é cobrado por cada atualização de localização e uma vez para avaliar a atualização de posição em relação a cada coleção de geocercas vinculada. Por exemplo, ao usar a filtragem baseada no tempo, se seu rastreador estiver vinculado a duas coleções de geocercas, cada atualização de posição contará como uma solicitação de atualização de localização e duas avaliações da coleção de geocercas. Se você estiver registrando atualizações de posição a cada cinco segundos para seus dispositivos e usando a filtragem com base no tempo, você será cobrado por 720 atualizações de localização e 1.440 avaliações da geocerca por hora para cada dispositivo. ## Casos de uso de rastreadores do Amazon Location Service A seguir estão alguns usos comuns dos rastreadores do Amazon Location Service. **Usar rastreadores com geocercas** Os rastreadores fornecem uma funcionalidade adicional quando combinados com geocercas. Você associa um rastreador a uma coleção de geocercas, seja por meio do console do Amazon Location ou da API, para avaliar automaticamente as localizações dos rastreadores. Cada vez que o rastreador recebe uma localização atualizada, essa localização será avaliada em relação a cada geocerca na coleção, e os eventos `ENTER` e `EXIT` apropriados serão gerados no Amazon EventBridge. Você também pode aplicar a filtragem ao rastreador e, dependendo da filtragem, pode reduzir os custos das avaliações de geocercas avaliando somente as atualizações de localização significativas. Se você associar o rastreador a uma coleção de geocercas depois que ele já tiver recebido algumas atualizações de posição, a primeira atualização de posição após a associação será tratada como uma atualização inicial para as avaliações da geocerca. Se estiver dentro de uma geocerca, você receberá um evento `ENTER`. Se não estiver dentro de nenhuma geocerca, você não receberá um evento `EXIT`, independentemente do estado anterior. **Melhorar as operações de serviços de campo ** Acompanhe sua força de trabalho móvel com rastreamento em tempo real. Defina geocercas nos locais dos clientes e nas áreas de serviço para receber alertas quando a equipe chegar e partir. Use dados de localização para otimizar cronogramas, enviar o técnico disponível mais próximo e reduzir os tempos de resposta. Capacite suas equipes de campo (como empresa de encanamento ou reparos de HVAC) a trabalhar com mais eficiência e aprimorar a experiência do cliente. **Monitorar e controlar ativos críticos** Utilize o Amazon Location Service para rastrear a localização e o status em tempo real de seus equipamentos valiosos, estoque e outros ativos móveis. Configure geocercas para receber alertas sobre movimentos ou remoções não autorizados, aumentando a segurança e a conformidade. Use essa visibilidade de localização para melhorar a utilização dos ativos, otimizar os cronogramas de manutenção e garantir que seus recursos essenciais sejam responsabilizados em todos os momentos. Sempre monitore máquinas pesadas, hardware de TI ou estoque de varejo com precisão, reduza as perdas e tome decisões operacionais mais informadas. **Melhorar a visibilidade da cadeia de fornecedores** Use o Amazon Location Service para rastrear encomendas e entregas em toda a cadeia de fornecedores. Defina geocercas em torno de centros de distribuição, lojas e outras instalações importantes para monitorar a movimentação de estoque e ativos. Use dados de localização em tempo real para melhorar o gerenciamento de estoque, otimizar o planejamento logístico e oferecer uma experiência superior ao cliente. Obtenha visibilidade completa das operações da sua cadeia de fornecedores, identifique gargalos e tome decisões baseadas em dados que aumentam a eficiência e a capacidade de resposta. **Marketing baseado em localização** Descubra o poder dos dados de localização para turbinar as iniciativas de geomarketing. Use o Amazon Location Service para definir limites virtuais em torno de locais, eventos e áreas de alto tráfego da concorrência. Dispare anúncios, ofertas e notificações personalizados quando os clientes entrarem nessas zonas geográficas. Analise os padrões de tráfego de pedestres para otimizar os posicionamentos de anúncios e descobrir sites estratégicos para novos locais de negócios. Monitore os movimentos dos clientes em seus próprios espaços com geocercas para obter informações mais detalhadas sobre os comportamentos de navegação e o caminho até a compra. Combine o rastreamento de localização em tempo real com as geocercas de precisão para oferecer um engajamento contextual hipersegmentado que aumenta as vendas e a fidelidade no mundo físico. # Conceitos de rastreador Esta seção detalha conceitos comuns de rastreadores. ## Terminologia comum dos rastreadores do Amazon Location Service **Recurso de rastreador** Um recurso da AWS que recebe atualizações de localização dos dispositivos. O recurso de rastreador fornece suporte para consultas de localização, como localização atual e histórica do dispositivo. A vinculação de um recurso de rastreador a uma coleção de geocercas avalia automaticamente as atualizações de localização em relação a todas as geocercas na coleção de geocercas vinculadas. **Dados de posição rastreados** Um recurso de rastreador armazena informações sobre seus dispositivos ao longo do tempo. As informações incluem uma série de atualizações de posição, em que cada atualização inclui localização, horário e metadados opcionais. Os metadados podem incluir a precisão de uma posição e até três pares de valores-chave para ajudar você a rastrear informações importantes sobre cada posição, como velocidade, direção, pressão dos pneus, combustível restante ou temperatura do motor do veículo que você está rastreando. Os rastreadores mantêm o histórico de localização do dispositivo por 30 dias. **Filtragem de posição** A filtragem de posição pode ajudar você a controlar os custos e melhorar a qualidade do seu aplicativo de rastreamento, filtrando as atualizações de posição que não fornecem informações valiosas antes que as atualizações sejam armazenadas ou avaliadas em relação às geocercas. Você pode escolher as filtragens `AccuracyBased`, `DistanceBased` ou `TimeBased`. Por padrão, a filtragem de posição está definida como `TimeBased`. Você pode configurar a filtragem de posição ao criar ou atualizar recursos do rastreador. **Formato de carimbo de data/hora RFC 3339 ** Os rastreadores do Amazon Location Service usam o formato [RFC 3339](https://tools.ietf.org/html/rfc3339), que segue o formato [8601 da International Organization for Standardization (ISO)](https://www.iso.org/iso-8601-date-and-time-format.html) para datas e horários. O formato é “AAAA-MM-DDThh:mm:ss.sssZ\$100:00”: + `YYYY-MM-DD`: representa o formato da data. + `T`: indica que os valores de tempo seguirão. + `hh:mm:ss.sss`: representa o horário no formato de 24 horas. + `Z`: indica que o fuso horário usado é UTC, que pode ser seguido por desvios do fuso horário UTC. + `+00:00`: opcionalmente, indica desvios do fuso horário UTC. Por exemplo, \$101:00 indica UTC \$1 1 hora. **Exemplo** Para 2 de julho de 2020, às 12:15:20 da tarde, com um ajuste de mais 1 hora no fuso horário UTC. ``` 2020-07-02T12:15:20.000Z+01:00 ``` # Conceitos básicos dos rastreadores do Amazon Location Service Esta seção fornece um guia abrangente para criar e usar rastreadores com o Amazon Location. Os rastreadores permitem que você armazene, processe e avalie as posições do dispositivo enquanto filtra as atualizações de localização para reduzir o ruído e gerenciar os custos. Com opções avançadas de filtragem de posição, suporte para coleções vinculadas de geocercas e integração com serviços da AWS como EventBridge e IoT Core, os rastreadores ativam aplicativos precisos de rastreamento e geocercas em tempo real, adaptados às suas necessidades específicas. **Topics** + [Criar um rastreador](start-create-tracker.md) + [Autenticação de suas solicitações](tracking-identity-pool.md) + [Atualize seu rastreador com a posição de um dispositivo](send-location-updates.md) + [Obtenha o histórico de localização de um dispositivo a partir de um rastreador](get-location-history.md) + [Liste suas posições dos dispositivos](list-device-positions.md) # Criar um rastreador Crie um recurso de rastreador para armazenar e processar as atualizações de posição de seus dispositivos. Você pode usar o console do Amazon Location Service AWS CLI, o ou o Amazon Location APIs. Cada atualização de posição armazenada em seus recursos de rastreador pode incluir uma medida da precisão da posição e até três campos de metadados sobre a posição ou o dispositivo que você deseja armazenar. Os metadados são armazenados como pares chave-valor e podem armazenar informações como velocidade, direção, pressão dos pneus ou temperatura do motor. Os rastreadores filtram as atualizações de posição à medida que elas são recebidas. Isso reduz o ruído visual nos caminhos do dispositivo (chamado de *instabilidade*) e reduz o número de eventos falsos de entrada e saída da geocerca. Isso também ajuda a gerenciar custos, reduzindo o número de avaliações iniciadas de geocercas. Os rastreadores oferecem três opções de filtragem de posições para ajudar a gerenciar custos e reduzir a instabilidade nas atualizações de localização. + **Baseado na precisão**: *use com qualquer dispositivo que forneça uma medição de precisão. A maioria dos dispositivos móveis fornece essas informações.* A precisão de cada medição de posição é afetada por muitos fatores ambientais, incluindo a recepção do satélite de GPS, a paisagem e a proximidade a dispositivos Wi-Fi e Bluetooth. A maioria dos dispositivos, incluindo a maioria dos dispositivos móveis, pode fornecer uma estimativa da precisão da medição junto com a medição. Com a filtragem `AccuracyBased`, o Amazon Location ignora atualizações de localização se o dispositivo tiver se movido menos em relação à precisão medida. Por exemplo, se duas atualizações consecutivas de um dispositivo tiverem uma faixa de precisão de 5 m e 10 m, o Amazon Location ignora a segunda atualização se o dispositivo tiver se movido menos de 15 m. O Amazon Location não avalia nem armazena as atualizações ignoradas em relação a geocercas. Quando a precisão não é fornecida, ela é tratada como zero, a medição é considerada perfeitamente precisa. **nota** Você também pode usar a filtragem baseada em precisão para remover toda a filtragem. Se você selecionar a filtragem com base na precisão, mas substituir todos os dados de precisão para zero ou omitir totalmente a precisão, o Amazon Location não filtrará nenhuma atualização. + **Baseada na distância**: *use quando seus dispositivos não fornecem uma medição precisa, mas você quer aproveitar a filtragem para reduzir a instabilidade e gerenciar os custos mesmo assim.* A filtragem `DistanceBased` ignora as atualizações de localização nas quais os dispositivos se moveram menos de 30 m (98,4 pés). Quando você usa a filtragem de posições `DistanceBased`, o Amazon Location não avalia nem armazena essas atualizações ignoradas em relação a geocercas. A precisão da maioria dos dispositivos móveis, incluindo a precisão média dos dispositivos iOS e Android, é de cerca de 15 m. Na maioria dos aplicativos, a filtragem `DistanceBased` pode reduzir o efeito das imprecisões de localização ao exibir a trajetória do dispositivo em um mapa e o efeito de vai e vem de vários eventos consecutivos de entrada e saída quando os dispositivos estão próximos à borda de uma geocerca. Ela também pode ajudar a reduzir o custo do seu aplicativo, fazendo menos chamadas para avaliar as geocercas vinculadas ou recuperar as posições dos dispositivos. + **Baseada no tempo**: (padrão) *use quando seus dispositivos enviam atualizações de posição com muita frequência (mais de uma vez a cada 30 segundos) e você deseja obter as avaliações da geocerca em tempo quase real sem armazenar todas as atualizações.*Na filtragem `TimeBased`, cada atualização de localização é avaliada em relação a coleções de geocercas vinculadas, mas nem todas as atualizações de localização são armazenadas. Se a frequência de atualização for superior a 30 segundos, apenas uma atualização a cada 30 segundos será armazenada para cada ID de dispositivo exclusivo. **nota** Esteja atento aos custos do seu aplicativo de rastreamento ao decidir seu método de filtragem e a frequência das atualizações de posição. Você é cobrado por cada atualização de localização e uma vez para avaliar a atualização de posição em relação a cada coleção de geocercas vinculada. Por exemplo, ao usar a filtragem baseada no tempo, se seu rastreador estiver vinculado a duas coleções de geocercas, cada atualização de posição contará como uma solicitação de atualização de localização e duas avaliações da coleção de geocercas. Se você estiver registrando atualizações de posição a cada cinco segundos para seus dispositivos e usando a filtragem com base no tempo, você será cobrado por 720 atualizações de localização e 1.440 avaliações da geocerca por hora para cada dispositivo. Sua fatura não é afetada pelo número de geocercas em cada coleção. Como cada coleção de geocercas pode conter até 50 mil geocercas, convém combinar suas geocercas em menos coleções, sempre que possível, para reduzir o custo das avaliações das geocercas. Por padrão, você receberá EventBridge eventos sempre que um dispositivo rastreado entrar ou sair de uma cerca geográfica vinculada. Para obter mais informações, consulte [Vincule um rastreador a uma coleção de geocercas](associate-consumer.md). Você pode ativar eventos para todas as atualizações de posição filtradas para um recurso de rastreador. Para obter mais informações, consulte [Ativar eventos de atualização para um rastreador](location-events.md#enable-update-events). **nota** Se você deseja criptografar seus dados usando sua própria chave gerenciada pelo AWS KMS cliente, o recurso Bounding Polygon Queries será desativado por padrão. Isso ocorre porque, ao usar esse recurso Bounding Polygon Queries, uma representação das posições do seu dispositivo não será criptografada usando sua chave gerenciada. AWS KMS No entanto, a posição exata do dispositivo é criptografada mesmo assim usando sua chave gerenciada. Você pode optar por ativar o atributo Bounding Polygon Queries definindo o parâmetro `KmsKeyEnableGeospatialQueries` como verdadeiro ao criar ou atualizar um rastreador. ------ #### [ Console ] **Para criar um rastreador usando o console do Amazon Location** 1. Abra o console do Amazon Location Service em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. No painel de navegação à esquerda, selecione **Rastreadores**. 1. Selecione **Criar rastreador**. 1. Preencha os seguintes campos: + ****Nome****: insira um nome exclusivo. Por exemplo, .*ExampleTracker* Máximo de 100 caracteres. Entradas válidas incluem caracteres alfanuméricos, hifens, pontos e sublinhados. + ****Descrição****: Insira uma descrição opcional. 1. 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 do Amazon Location Service](trackers.md) neste guia e `[PositionFiltering](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html#location-WaypointTracking_CreateTracker-request-PositionFiltering)` na Referência de APIs para Rastreadores do Amazon Location Service. 1. (Opcional) Em **Tags**, insira uma tag **Chave** e **Valor**. Isso adiciona uma tag à sua nova coleção de geocercas. Para obter mais informações, consulte [Como usar marcações](manage-resources.md#manage-resources_how-to). 1. (Opcional) Em **Criptografia de chave gerenciada pelo cliente**, você pode selecionar **Adicionar uma chave gerenciada pelo cliente**. Isso adiciona uma chave simétrica gerenciada pelo cliente que você cria, possui e gerencia por meio da criptografia padrão de AWS propriedade. Para obter mais informações, consulte [Criptografia de dados em repouso](encryption-at-rest.md). 1. (Opcional) Em **KmsKeyEnableGeospatialQueries**, você pode optar por ativar as **consultas geoespaciais**. Isso permite que você use o recurso Bounding Polygon Queries e, ao mesmo tempo, criptografe seus dados usando uma chave gerenciada pelo KMS do cliente. AWS **nota** Quando você usa o recurso Bounding Polygon Queries, uma representação das posições do seu dispositivo não é criptografada usando sua chave gerenciada. AWS KMS No entanto, a posição exata do dispositivo é criptografada mesmo assim usando sua chave gerenciada. 1. (Opcional) Em **EventBridge configuração**, você pode optar por ativar EventBridge eventos para atualizações de posição filtradas. Isso enviará um evento sempre que uma atualização de posição de um dispositivo nesse rastreador atender à avaliação de filtragem de posições. 1. Selecione **Criar rastreador**. ------ #### [ API ] **Para criar um rastreador usando a localização da Amazon APIs** Use a `[CreateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html)` operação dos Amazon Location Trackers APIs. O exemplo a seguir usa uma solicitação de API para criar um rastreador chamado*ExampleTracker*. O recurso rastreador está associado a uma [AWS KMS chave gerenciada pelo cliente para criptografar os dados do cliente](encryption-at-rest.md) e não [permite atualizações de posição](location-events.md#enable-update-events) em. EventBridge ``` POST /tracking/v0/trackers Content-type: application/json { "TrackerName": "ExampleTracker", "Description": "string", "KmsKeyEnableGeospatialQueries": false, "EventBridgeEnabled": false, "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "PositionFiltering": "AccuracyBased", "Tags": { "string" : "string" } } ``` **Crie um rastreador com `KmsKeyEnableGeospatialQueries` ativado** O exemplo a seguir tem o parâmetro `KmsKeyEnableGeospatialQueries` definido como verdadeiro. Isso permite que você use o recurso Bounding Polygon Queries e, ao mesmo tempo, criptografe seus dados usando uma chave gerenciada pelo cliente. AWS KMS Para obter informações sobre como usar o atributo Bounding Polygon Queries, consulte [Liste suas posições dos dispositivos](list-device-positions.md) **nota** Quando você usa o recurso Bounding Polygon Queries, uma representação das posições do seu dispositivo não é criptografada usando sua chave gerenciada. AWS KMS No entanto, a posição exata do dispositivo é criptografada mesmo assim usando sua chave gerenciada. ``` POST /tracking/v0/trackers Content-type: application/json { "TrackerName": "ExampleTracker", "Description": "string", "KmsKeyEnableGeospatialQueries": true, "EventBridgeEnabled": false, "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "PositionFiltering": "AccuracyBased", "Tags": { "string" : "string" } } ``` ------ #### [ AWS CLI ] **Para criar um rastreador usando comandos AWS CLI ** Use o comando `[create-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/create-tracker.html)`. O exemplo a seguir usa o AWS CLI para criar um rastreador chamado*ExampleTracker*. O recurso rastreador está associado a uma [AWS KMS chave gerenciada pelo cliente para criptografar os dados do cliente](encryption-at-rest.md) e não [permite atualizações de posição](location-events.md#enable-update-events) em. EventBridge ``` aws location \ create-tracker \ --tracker-name "ExampleTracker" \ --position-filtering "AccuracyBased" \ --event-bridge-enabled false \ --kms-key-enable-geospatial-queries false \ --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab" ``` **Crie um rastreador com `KmsKeyEnableGeospatialQueries` ativado** O exemplo a seguir tem o parâmetro `KmsKeyEnableGeospatialQueries` definido como verdadeiro. Isso permite que você use o recurso Bounding Polygon Queries e, ao mesmo tempo, criptografe seus dados usando uma chave gerenciada pelo cliente. AWS KMS Para obter informações sobre como usar o atributo Bounding Polygon Queries, consulte [Liste suas posições dos dispositivos](list-device-positions.md) **nota** Quando você usa o recurso Bounding Polygon Queries, uma representação das posições do seu dispositivo não é criptografada usando sua chave gerenciada. AWS KMS No entanto, a posição exata do dispositivo é criptografada mesmo assim usando sua chave gerenciada. ``` aws location \ create-tracker \ --tracker-name "ExampleTracker" \ --position-filtering "AccuracyBased" \ --event-bridge-enabled false \ --kms-key-enable-geospatial-queries true \ --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab" ``` ------ **nota** O faturamento depende do seu uso. Você pode incorrer em taxas pelo uso de outros serviços da AWS . Para obter mais informações, consulte os [preços do Amazon Location Service](https://aws.amazon.com/location/pricing/). Você pode editar a **Descrição**, a **filtragem de posição** e a **EventBridge configuração** após a criação do rastreador, escolhendo **Editar** rastreador. # Autenticação de suas solicitações Depois de criar um recurso de rastreador e estiver pronto para começar a avaliar as posições dos dispositivos em relação às geocercas, escolha como autenticar suas solicitações: + Para explorar as formas para acessar os serviços, consulte [Autenticação com o Amazon Location Service](access.md). + Se quiser publicar as posições de dispositivos com solicitações não autenticadas, talvez você deva usar o Amazon Cognito. **Exemplo** O exemplo a seguir mostra como o usar u banco de identidades do Amazon Cognito para autorização, usando o [AWS JavaScript SDK v3](https://aws.amazon.com/sdk-for-javascript/) e o [Web](how-to-auth-helper.md#loc-sdk-auth-web) do Amazon Location. ``` import { LocationClient, BatchUpdateDevicePositionCommand } from "@aws-sdk/client-location"; import { withIdentityPoolId } from "@aws/amazon-location-utilities-auth-helper"; // Unauthenticated identity pool you created const identityPoolId = "us-east-1:1234abcd-5678-9012-abcd-sample-id"; // Create an authentication helper instance using credentials from Cognito const authHelper = await withIdentityPoolId(identityPoolId); const client = new LocationClient({ region: "us-east-1", // The region containing both the identity pool and tracker resource ...authHelper.getLocationClientConfig(), // Provides configuration required to make requests to Amazon Location }); const input = { TrackerName: "ExampleTracker", Updates: [ { DeviceId: "ExampleDevice-1", Position: [-123.4567, 45.6789], SampleTime: new Date("2020-10-02T19:09:07.327Z"), }, { DeviceId: "ExampleDevice-2", Position: [-123.123, 45.123], SampleTime: new Date("2020-10-02T19:10:32Z"), }, ], }; const command = new BatchUpdateDevicePositionCommand(input); // Send device position updates const response = await client.send(command); ``` # Atualize seu rastreador com a posição de um dispositivo Para rastrear seus dispositivos, você pode publicar atualizações das posições dos dispositivos em seu rastreador. Posteriormente, você pode recuperar essas posições dos dispositivos ou o histórico das posições do dispositivo a partir do seu recurso de rastreador. Cada atualização de posição deve incluir a ID do dispositivo, um carimbo de data e hora e uma posição. Opcionalmente, você pode incluir outros metadados, incluindo a precisão e até três pares chave-valor para seu próprio uso. Se o seu rastreador estiver vinculado a uma ou mais coleções de geocercas, as atualizações serão avaliadas em relação a essas geocercas (seguindo as regras de filtragem que você especificou para o rastreador). Se um dispositivo violar uma área cercada geograficamente (movendo-se de dentro para fora da área ou vice-versa), você receberá eventos em. EventBridge Esses `ENTER` ou `EXIT` eventos incluem os detalhes da atualização da posição, incluindo a ID do dispositivo, o timestamp e quaisquer metadados associados. **nota** Para obter mais informações sobre a filtragem de posições, consulte [Criar um rastreador](start-create-tracker.md). Para obter mais informações sobre os eventos das geocercas, consulte [Reaja aos eventos do Amazon Location Service com a Amazon EventBridge](location-events.md). Use um desses métodos para enviar atualizações do dispositivo: + [Envie atualizações do MQTT](tracking-using-mqtt.md) para um recurso do AWS IoT Core e vincule-o ao seu recurso rastreador. + Envie atualizações de localização usando a API Amazon Location Trackers, usando o AWS CLI, ou o Amazon Location. APIs Você pode usar o [AWS SDKs](dev-sdks.md)para ligar para o a APIs partir do seu aplicativo iOS ou Android. ------ #### [ API ] **Para enviar uma atualização de posição usando a localização da Amazon APIs** Use a `[BatchUpdateDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchUpdateDevicePosition.html)` operação dos Amazon Location Trackers APIs. O exemplo a seguir usa uma solicitação de API para publicar uma atualização da posição do dispositivo *ExampleDevice* em um rastreador*ExampleTracker*. ``` POST /tracking/v0/trackers/ExampleTracker/positions Content-type: application/json { "Updates": [ { "DeviceId": "1", "Position": [ -123.12245146162303, 49.27521118043802 ], "SampleTime": "2022-10-24T19:09:07.327Z", "PositionProperties": { "name" : "device1" }, "Accuracy": { "Horizontal": 10 } }, { "DeviceId": "2", "Position": [ -123.1230104928471, 49.27752402723152 ], "SampleTime": "2022-10-02T19:09:07.327Z" }, { "DeviceId": "3", "Position": [ -123.12325592118916, 49.27340530543111 ], "SampleTime": "2022-10-02T19:09:07.327Z" }, { "DeviceId": "4", "Position": [ -123.11958813096311, 49.27774641063121 ], "SampleTime": "2022-10-02T19:09:07.327Z" }, { "DeviceId": "5", "Position": [ -123.1277418058896, 49.2765989015285 ], "SampleTime": "2022-10-02T19:09:07.327Z" }, { "DeviceId": "6", "Position": [ -123.11964267059481, 49.274188155916534 ], "SampleTime": "2022-10-02T19:09:07.327Z" } ] } ``` ------ #### [ AWS CLI ] **Para enviar uma atualização de posição usando comandos AWS CLI ** Use o comando `[batch-update-device-position](https://docs.aws.amazon.com/cli/latest/reference/location/batch-update-device-position.html)`. O exemplo a seguir usa um AWS CLI para publicar uma atualização da posição do dispositivo para *ExampleDevice-1* e *ExampleDevice-2* para um rastreador*ExampleTracker*. ``` aws location batch-update-device-position \ --tracker-name ExampleTracker \ --updates '[{"DeviceId":"ExampleDevice-1","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z"},{"DeviceId":"ExampleDevice-2","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z","Accuracy":{"Horizontal":10.30},"PositionProperties":{"field1":"value1","field2":"value2"}}]' ``` ------ # Obtenha o histórico de localização de um dispositivo a partir de um rastreador Seu recurso de rastreador do Amazon Location guarda o histórico de localização de todos os seus dispositivos rastreados por um período de 30 dias. Você pode recuperar o histórico de localização do dispositivo, incluindo todos os metadados associados, do seu recurso de rastreador. Os exemplos a seguir usam o AWS CLI, ou o Amazon Location APIs. ------ #### [ API ] **Para obter o histórico de localização do dispositivo de um rastreador usando o Amazon Location APIs** Use a `[GetDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePositionHistory.html)` operação dos Amazon Location Trackers APIs. O exemplo a seguir usa uma solicitação de URI de API para obter o histórico de localização *ExampleDevice* do dispositivo de um rastreador chamado *ExampleTracker* começando de `19:05:07` (inclusive) e termina em `19:20:07` (exclusivo) em`2020–10–02`. ``` POST /tracking/v0/trackers/ExampleTracker/devices/ExampleDevice/list-positions Content-type: application/json { "StartTimeInclusive": "2020-10-02T19:05:07.327Z", "EndTimeExclusive": "2020-10-02T19:20:07.327Z" } ``` ------ #### [ AWS CLI ] **Para obter o histórico de localização do dispositivo de um rastreador usando comandos AWS CLI ** Use o comando `[get-device-position-history](https://docs.aws.amazon.com/cli/latest/reference/location/get-device-position-history.html)`. O exemplo a seguir usa um AWS CLI para obter o histórico de localização *ExampleDevice* do dispositivo de um rastreador chamado *ExampleTracker* começando de `19:05:07` (inclusive) e termina em `19:20:07` (exclusivo). `2020–10–02` ``` aws location \ get-device-position-history \ --device-id "ExampleDevice" \ --start-time-inclusive "2020-10-02T19:05:07.327Z" \ --end-time-exclusive "2020-10-02T19:20:07.327Z" \ --tracker-name "ExampleTracker" ``` ------ # Liste suas posições dos dispositivos Você pode ver uma lista de posições de dispositivos para um rastreador usando o AWS CLI, ou o Amazon Location APIs, com a ListDevicePositions API. Quando você chama a ListDevicePositions API, uma lista das posições mais recentes de todos os dispositivos associados a um determinado rastreador é retornada. Por padrão, essa API retorna as 100 posições mais recentes do dispositivo por página de resultados para um determinado rastreador. Para retornar somente os dispositivos que estão dentro de uma região específica, use o parâmetro `FilterGeometry` para criar uma Bounding Polygon Query (solicitação do polígono limítrofe). Dessa forma, quando você ligar ListDevicePositions, somente os dispositivos dentro do polígono serão retornados. **nota** Se você deseja criptografar seus dados usando sua própria chave gerenciada pelo AWS KMS cliente, o recurso Bounding Polygon Queries será desativado por padrão. Isso ocorre porque, ao usar esse recurso, uma representação das posições do seu dispositivo não será criptografada usando sua chave AWS KMS gerenciada. A posição exata do dispositivo é criptografada mesmo assim usando sua chave gerenciada. Você pode optar por ativar o atributo Bounding Polygon Queries. Isso é feito definindo o parâmetro `KmsKeyEnableGeospatialQueries` como verdadeiro ao criar ou atualizar um rastreador. ------ #### [ API ] Use a `[ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html)` operação dos Amazon Location Trackers APIs. O exemplo a seguir é uma solicitação de API para obter uma lista das posições dos dispositivos na área poligonal, usando o parâmetro opcional `[FilterGeometry](https://docs.aws.amazon.com/)`. O exemplo retorna três localizações de dispositivos presentes na área definida pelo array `Polygon`. ``` POST /tracking/v0/trackers/TrackerName/list-positions HTTP/1.1 Content-type: application/json { "FilterGeometry": { "Polygon": [ [ [ -123.12003339442259, 49.27425121147397 ], [ -123.1176984148229, 49.277063620879744 ], [ -123.12389509145294, 49.277954183760926 ], [ -123.12755921328647, 49.27554025235713 ], [ -123.12330236586217, 49.27211836076236 ], [ -123.12003339442259, 49.27425121147397 ] ] ] }, "MaxResults": 3, "NextToken": "1234-5678-9012" } ``` Este é um exemplo de resposta para `[ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html)`: ``` { "Entries": [ { "DeviceId": "1", "SampleTime": "2022-10-24T19:09:07.327Z", "Position": [ -123.12245146162303, 49.27521118043802 ], "Accuracy": { "Horizontal": 10 }, "PositionProperties": { "name": "device1" } }, { "DeviceId": "3", "SampleTime": "2022-10-02T19:09:07.327Z", "Position": [ -123.12325592118916, 49.27340530543111 ] }, { "DeviceId": "2", "SampleTime": "2022-10-02T19:09:07.327Z", "Position": [ -123.1230104928471, 49.27752402723152 ] } ], "NextToken": "1234-5678-9012" } ``` ------ #### [ CLI ] Use o comando `[list-trackers](https://docs.aws.amazon.com/cli/latest/reference/location/list-trackers.html)`. O exemplo a seguir é AWS CLI para obter uma lista de dispositivos em uma área poligonal. ``` aws location list-device-positions TODO: add arguments add props for filter geo ``` ------ # Como trabalhar com os rastreadores do Amazon Location Service Esta seção fornece instruções para trabalhar com os rastreadores do Amazon Location. Saiba como verificar as posições dos dispositivos, vincular rastreadores a coleções de geocercas e rastrear localizações usando AWS IoT e MQTT. Além disso, aprenda a gerenciar seus rastreadores de forma eficaz para oferecer suporte aos aplicativos baseados em localização e garantir um rastreamento preciso e em tempo real. **Topics** + [Verificar as posições do dispositivo](verify-device-positions.md) + [Vincule um rastreador a uma coleção de geocercas](associate-consumer.md) + [Rastrear usando AWS IoT e MQTT com o Amazon Location Service](tracking-using-mqtt.md) + [Gerencie o rastreador do Amazon Location Service](managing-trackers.md) # Verificar as posições do dispositivo Para verificar a integridade da posição de um dispositivo, use a [VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)API. Essa API retorna informações sobre a integridade da posição do dispositivo, avaliando propriedades como o sinal da célula do dispositivo, o ponto de acesso Wi-Fi, o endereço Ipv4 e se um proxy está em uso. ## Pré-requisitos Antes de poder usar a lista APIs para verificação do dispositivo, verifique se você tem os seguintes pré-requisitos: + Você criou um rastreador para o dispositivo ou dispositivos que deseja verificar. Para obter mais informações, consulte [Conceitos básicos dos rastreadores do Amazon Location Service](start-tracking.md). O exemplo a seguir mostra uma solicitação para a [VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)API de localização da Amazon. ------ #### [ API ] **Para verificar as posições do dispositivo usando a localização da Amazon APIs** Use a `[VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)` operação do Amazon Location Tracking APIs. O exemplo a seguir mostra uma solicitação de API para avaliar a integridade da posição de um dispositivo. Substitua esses valores pelo seu próprio dispositivo IDs. ``` POST /tracking/v0/trackers/TrackerName/positions/verify HTTP/1.1 Content-type: application/json { "DeviceState": { "Accuracy": { "Horizontal": number }, "CellSignals": { "LteCellDetails": [ { "CellId": number, "LocalId": { "Earfcn": number, "Pci": number }, "Mcc": number, "Mnc": number, "NetworkMeasurements": [ { "CellId": number, "Earfcn": number, "Pci": number, "Rsrp": number, "Rsrq": number } ], "NrCapable": boolean, "Rsrp": number, "Rsrq": number, "Tac": number, "TimingAdvance": number } ] }, "DeviceId": "ExampleDevice", "Ipv4Address": "string", "Position": [ number ], "SampleTime": "string", "WiFiAccessPoints": [ { "MacAddress": "string", "Rss": number } ] }, "DistanceUnit": "string" } ``` ------ **nota** O **Integrity SDK** fornece atributos aprimorados relacionados à verificação de dispositivos e está disponível para uso mediante solicitação. Para ter acesso ao SDK, entre em contato com o [Sales Support](https://aws.amazon.com/contact-us/sales-support/?pg=locationprice&cta=herobtn). # Vincule um rastreador a uma coleção de geocercas Agora que você tem uma coleção de geocercas e um rastreador, você pode vinculá-los para que as atualizações de localização sejam avaliadas automaticamente em relação a todas as suas geocercas. Se você não quiser avaliar todas as atualizações de localização ou se você não estiver armazenando algumas de suas localizações em um recurso de rastreador, você pode [avaliar as posições dos dispositivos em relação às geocercas](https://docs.aws.amazon.com/location/latest/developerguide/evaluate-geofences.html) quando precisar. Quando as posições dos dispositivos são avaliadas em relação às geocercas, os eventos são gerados. Você pode definir uma ação para esses eventos. Para obter mais informações sobre ações que você pode definir para eventos de delimitação geográfica, consulte [Reagir aos eventos do Amazon Location Service com](https://docs.aws.amazon.com/location/latest/developerguide/location-events.html) a Amazon. EventBridge Um evento do Amazon Location inclui os atributos da atualização das posições dos dispositivos que o geram e alguns atributos da geocerca onde se entrou ou saiu. Para obter mais informações sobre os dados incluídos em um evento de geocercas, consulte [Exemplos de EventBridge eventos da Amazon para o Amazon Location Service](location-events.md#example-event). Os exemplos a seguir vinculam um recurso de rastreamento a uma coleção de cercas geográficas usando o console, o ou o Amazon AWS CLI Location. APIs ------ #### [ Console ] **Vincular um recurso de rastreador a uma coleção de geocercas usando o console do Amazon Location Service** 1. Abra o console do Amazon Location Service em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. No painel de navegação à esquerda, selecione **Rastreadores**. 1. Em **Rastreadores de dispositivos**, selecione o link do nome do rastreador de destino. 1. Em **Coleções de geocercas vinculadas**, selecione **Vincular coleção de geocercas**. 1. Na janela **Coleção de geocercas vinculadas**, selecione uma coleção de geocercas no menu suspenso. 1. Escolha **Vincular**. Depois de vincular o recurso de rastreador, ele receberá um status de **Ativo**. ------ #### [ API ] **Para vincular um recurso rastreador a uma coleção de cercas geográficas usando a localização da Amazon APIs** Use a `[AsssociateTrackerConsumer](https://docs.aws.amazon.com/location-trackers/latest/APIReference/API_AssociateTrackerConsumer.html)` operação dos Amazon Location Trackers APIs. O exemplo a seguir usa uma solicitação de API *ExampleTracker* associada a uma coleção de cercas geográficas usando seu [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html). ``` POST /tracking/v0/trackers/ExampleTracker/consumers Content-type: application/json { "ConsumerArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection" } ``` ------ #### [ AWS CLI ] **Para vincular um recurso rastreador a uma coleção de cercas geográficas usando comandos AWS CLI ** Use o comando `[associate-tracker-consumer](https://docs.aws.amazon.com/cli/latest/reference/location/associate-tracker-consumer.html)`. O exemplo a seguir usa um AWS CLI para criar uma coleção de geofence chamada. *ExampleGeofenceCollection* ``` aws location \ associate-tracker-consumer \ --consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection" \ --tracker-name "ExampleTracker" ``` ------ # Rastrear usando AWS IoT e MQTT com o Amazon Location Service O [MQTT](http://mqtt.org/) é um protocolo de mensagens leve e amplamente adotado, projetado para dispositivos restritos. O AWS IoT Core suporta conexões de dispositivos que usam o protocolo MQTT e o protocolo MQTT over WebSocket Secure (WSS). O [AWS IoT Core](https://aws.amazon.com/iot-core/) conecta dispositivos à AWS e permite que você envie e receba mensagens entre eles. O mecanismo de regras do AWS IoT Core armazena consultas sobre os tópicos de mensagens de seus dispositivos e permite que você defina ações para enviar mensagens para outros serviços da AWS, como o Amazon Location Service. Dispositivos que estão cientes de sua localização como coordenadas podem ter suas localizações encaminhadas para a Amazon Location por meio do mecanismo de regras. **nota** Os dispositivos podem saber sua própria posição, por exemplo, via GPS integrado. O AWS IoT também tem suporte para rastreamento de localização de dispositivos de terceiros. Para obter mais informações, consulte [Local do dispositivo AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/device-location.html) no *Guia do desenvolvedor do AWS IoT Core*. O passo a passo a seguir descreve o rastreamento usando regras AWS IoT Core. Você também pode enviar as informações do dispositivo para sua própria função AWS Lambda, se precisar processá-las antes de enviar para o Amazon Location. Para obter mais detalhes sobre o uso do Lambda para processar as localizações de seus dispositivos, consulte [Use AWS Lambda com o MQTT](tracking-using-mqtt-with-lambda.md). **Topics** + [Pré-requisito](#mqtt-prerequisite) + [Criar uma regra de AWS IoT Core](#mqtt-create-iot-rule) + [Teste sua regra de AWS IoT Core no console](#mqtt-test-iot-rule) + [Use AWS Lambda com o MQTT](tracking-using-mqtt-with-lambda.md) ## Pré-requisito Antes de começar a rastrear, conclua os seguintes pré-requisitos: + [Crie um recurso rastreador](start-create-tracker.md) para o qual você enviará os dados de localização do dispositivo. + [Crie um perfil do IAM](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-role.html) para conceder acesso AWS IoT Core ao seu rastreador. Ao seguir essas etapas, use a política a seguir para dar acesso ao seu rastreador: ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "WriteDevicePosition", "Effect": "Allow", "Action": "geo:BatchUpdateDevicePosition", "Resource": "arn:aws:geo:*:*:tracker/*" } ] } ``` ## Criar uma regra de AWS IoT Core Em seguida, crie uma regra de AWS IoT Core para encaminhar a telemetria posicional de seus dispositivos para o Amazon Location Service. Para obter mais informações sobre como criar regras, consulte os seguintes tópicos no *Guia do desenvolvedor do AWS IoT Core*: + [Criar uma regra do AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-rule.html) para obter informações sobre a criação de uma nova regra. + [Ação de localização](https://docs.aws.amazon.com/iot/latest/developerguide/location-rule-action.html) para obter informações específicas sobre a criação de uma regra para publicação no Amazon Location ## Teste sua regra de AWS IoT Core no console Se nenhum dispositivo estiver publicando telemetria que inclua localização no momento, você poderá testar sua regra usando o console do AWS IoT Core. O console tem um cliente de teste no qual você pode publicar uma mensagem de amostra para verificar os resultados da solução. 1. Faça login no console do AWS IoT Core em [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home). 1. No painel de navegação à esquerda, expanda **Teste** e escolha **Cliente de teste MQTT**. 1. 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 pelos rastreadores do Amazon Location Service). ``` { "payload": { "deviceid": "thing123", "timestamp": 1604940328, "location": { "lat": 49.2819, "long": -123.1187 }, "accuracy": { "Horizontal": 20.5 }, "positionProperties": { "field1": "value1", "field2": "value2" } } } ``` 1. Escolha **Publicar** no tópico para enviar a mensagem de teste. 1. 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 pelo que você usou. ``` aws location batch-get-device-position --tracker-name MyTracker --device-ids thing123 ``` # Use AWS Lambda com o MQTT Embora o uso não AWS Lambda seja mais necessário ao enviar dados de localização do dispositivo para o Amazon Location para rastreamento, talvez você ainda queira usar o Lambda em alguns casos. Por exemplo, se você mesmo quiser processar os dados de localização do seu dispositivo, antes de enviá-los para o Amazon Location. Os tópicos a seguir descrevem como usar o Lambda para processar as mensagens antes de enviá-las ao rastreador. Para obter mais informações sobre esse padrão, consulte a [arquitetura de referência](https://d1.awsstatic.com/architecture-diagrams/ArchitectureDiagrams/amazon-location-service-ra.pdf). **Topics** + [Pré-requisito](#mqtt-prerequisite-with-lambda) + [Criar uma função do Lambda](#mqtt-with-lambda-create-lambda) + [Crie uma AWS IoT Core regra](#mqtt-create-iot-rule-with-lambda) + [Teste sua AWS IoT Core regra no console](#mqtt-test-iot-rule-with-lambda) ## Pré-requisito Antes de começar a rastrear, você deve [criar um recurso de rastreador](start-tracking.md). Para criar um recurso de rastreamento, você pode usar o console de localização da Amazon AWS CLI, o ou o Amazon Location APIs. O exemplo a seguir usa o console do Amazon Location Service para criar o recurso rastreador: 1. Abra o console do Amazon Location Service em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. No painel de navegação à esquerda, selecione **Rastreadores**. 1. Selecione **Criar rastreador**. 1. Preencha as seguintes caixas: + **Nome**: insira um nome exclusivo com no máximo 100 caracteres. As entradas válidas incluem caracteres alfanuméricos, hífens e sublinhados. Por exemplo, .*MyTracker* + **Descrição**: insira uma descrição opcional. Por exemplo, .*Tracker for storing AWS IoT Core device positions* + **Filtragem de posição**: selecione a filtragem que você deseja usar para atualizações de posição. Por exemplo, **Filtragem baseada em precisão**. 1. Selecione **Criar rastreador**. ## Criar uma função do Lambda Para criar uma conexão entre AWS IoT Core o Amazon Location Service, você precisa de uma AWS Lambda função para processar mensagens encaminhadas por AWS IoT Core. Essa função extrairá todos os dados posicionais, os formatará para o Amazon Location Service e os enviará por meio da API do rastreador do Amazon Location. Você pode criar essa função por meio do AWS Lambda console ou usar o AWS Command Line Interface (AWS CLI) ou AWS Lambda APIs o. Para criar uma função do Lambda que publique atualizações de posição no Amazon Location usando o console: 1. Abra o AWS Lambda console em [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/home). 1. No painel de navegação à esquerda, selecione **Funções**. 1. Selecione **Criar função** e confirme se **Autor do zero** está selecionado. 1. Preencha as seguintes caixas: + **Nome da função**: insira um nome para a sua função. Entradas válidas incluem caracteres alfanuméricos, hifens, pontos e sublinhados, sem espaços. Por exemplo, .*MyLambda* + **Tempo de execução** — Escolha*Python 3.8*. 1. Selecione **Criar função**. 1. Selecione a guia **Código** para abrir o editor. 1. 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](#mqtt-prerequisite-with-lambda). ``` 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) } ``` 1. Selecione **Implantar** para salvar a função atualizada. 1. Escolha a guia **Configuração**. 1. 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. 1. Na página de **Resumo** do seu perfil, escolha **Adicionar permissões** e, na lista suspensa, selecione **Criar política embutida**. 1. 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/*" } ] } ``` 1. Escolha **Revisar política**. 1. Insira um nome de política. Por exemplo, .*AmazonLocationTrackerWriteOnly* 1. Escolha **Criar política**. Você pode modificar esse código de função, conforme o necessário, para se adaptar ao esquema de mensagens do seu próprio dispositivo. ## Crie uma AWS IoT Core regra Em seguida, crie uma AWS IoT Core regra para encaminhar a telemetria posicional de seus dispositivos para a AWS Lambda função para transformação e publicação no Amazon Location Service. O exemplo de regra fornecido pressupõe que qualquer transformação necessária das cargas úteis do dispositivo seja tratada pela sua função do Lambda. Você pode criar essa regra por meio do AWS IoT Core console, do AWS Command Line Interface (AWS CLI) ou do AWS IoT Core APIs. **nota** Embora o AWS IoT console gerencie a permissão necessária AWS IoT Core para permitir a invocação da função Lambda, se você estiver criando sua regra AWS CLI a partir do SDK ou, [deverá configurar uma política para a](https://docs.aws.amazon.com/iot/latest/developerguide/lambda-rule-action.html#lambda-rule-action-requirements) qual conceder permissão. AWS IoT **Para criar um AWS IoT Core usando o console** 1. Faça login no AWS IoT Core console em [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home). 1. No painel de navegação à esquerda, expanda **Agir** e **Regras**. 1. Escolha **Criar uma regra** para iniciar o novo assistente de regras. 1. Insira um nome e uma descrição para a regra. 1. 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' ``` 1. Em **Definir uma ou mais ações**, selecione **Adicionar ação**. 1. Selecione **Enviar uma mensagem para uma função do Lambda**. 1. Escolha **Configurar ação**. 1. Encontre e selecione sua função do Lambda na lista. 1. Selecione **Adicionar ação**. 1. Escolha **Criar regra**. ## Teste sua AWS IoT Core regra no console Se nenhum dispositivo estiver publicando telemetria que inclua localização no momento, você poderá testar sua regra e essa solução usando o AWS IoT Core console. O console tem um cliente de teste no qual você pode publicar uma mensagem de amostra para verificar os resultados da solução. 1. Faça login no AWS IoT Core console em [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home). 1. No painel de navegação à esquerda, expanda **Teste** e escolha **Cliente de teste MQTT**. 1. Em **Publicar em um tópico**, defina o **nome do tópico** como *iot/topic* (ou o nome do tópico que você configurou na sua AWS IoT Core regra, se for diferente) e forneça o seguinte para o **payload da mensagem**. Substitua o carimbo de *1604940328* data/hora por um válido dos ú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" } } } ``` 1. Escolha **Publicar** no tópico para enviar a mensagem de teste. 1. 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 ``` # Gerencie o rastreador do Amazon Location Service Você pode gerenciar seus rastreadores usando o console de localização da Amazon AWS CLI, o ou o Amazon Location. APIs ## Faça uma lista dos seus rastreadores Você pode ver sua lista de rastreadores usando o console de localização da Amazon AWS CLI, o ou o Amazon Location: APIs ------ #### [ Console ] **Para ver uma lista de rastreadores existentes usando o console Amazon Location** 1. Abra o console de localização da Amazon em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. Selecione **Rastreadores** na barra de navegação à esquerda. 1. Veja uma lista dos seus recursos de rastreador em **Meus rastreadores**. ------ #### [ API ] Use a `[ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html)` operação dos Amazon Location Trackers APIs. O exemplo a seguir é uma solicitação de API para obter uma lista de rastreadores em sua AWS conta. ``` POST /tracking/v0/list-trackers ``` Este é um exemplo de resposta para `[ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html)`: ``` { "Entries": [ { "CreateTime": 2020-10-02T19:09:07.327Z, "Description": "string", "TrackerName": "ExampleTracker", "UpdateTime": 2020-10-02T19:10:07.327Z } ], "NextToken": "1234-5678-9012" } ``` ------ #### [ CLI ] Use o comando `[list-trackers](https://docs.aws.amazon.com/cli/latest/reference/location/list-trackers.html)`. O exemplo a seguir é AWS CLI para obter uma lista de rastreadores em sua AWS conta. ``` aws location list-trackers ``` ------ ## Desconectando um rastreador de uma coleção de geocercas Você pode desconectar um rastreador de uma coleção de cercas geográficas usando o console de localização da Amazon, o AWS CLI ou o Amazon Location: APIs ------ #### [ Console ] **Para desassociar um rastreador de uma coleção associada de geocercas usando o console do Amazon Location** 1. Abra o console de localização da Amazon em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. Selecione **Rastreadores** no painel de navegação à esquerda. 1. Em **Meus rastreadores**, selecione o link do nome do rastreador de destino. 1. Em **Coleções de geocercas vinculadas**, selecione uma coleção de geocercas com status **Vinculada**. 1. Selecione **Desvincular**. ------ #### [ API ] Use a `[DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html)` operação dos Amazon Location Trackers APIs. O exemplo a seguir é uma solicitação de API para desassociar um rastreador de uma coleção de geocercas associada. ``` DELETE /tracking/v0/trackers/ExampleTracker/consumers/arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleCollection ``` Este é um exemplo de resposta para `[DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html)`: ``` HTTP/1.1 200 ``` ------ #### [ CLI ] Use o comando `[disassociate-tracker-consumer](https://docs.aws.amazon.com/cli/latest/reference/location/disassociate-tracker-consumer.html)`. O exemplo a seguir é um AWS CLI comando para desassociar um rastreador de uma coleção de cercas geográficas associada. ``` aws location disassociate-tracker-consumer \ --consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleCollection" \ --tracker-name "ExampleTracker" ``` ------ ## Obtenha detalhes do rastreador Você pode obter detalhes sobre qualquer rastreador em sua AWS conta usando o console de localização da Amazon AWS CLI, o ou o Amazon Location APIs. ------ #### [ Console ] **Para visualizar os detalhes do rastreador usando o console do Amazon Location** 1. Abra o console de localização da Amazon em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. Selecione **Rastreadores** na barra de navegação à esquerda. 1. Em **Meus rastreadores**, selecione o link do nome do rastreador de destino. 1. Veja os detalhes do rastreador em **Informações**. ------ #### [ API ] Use a `[DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html)` operação do Amazon Location Tracker APIs. O exemplo a seguir é uma solicitação de API para obter os detalhes do rastreador. *ExampleTracker* ``` GET /tracking/v0/trackers/ExampleTracker ``` Este é um exemplo de resposta para `[DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html)`: ``` { "CreateTime": 2020-10-02T19:09:07.327Z, "Description": "string", "EventBridgeEnabled": false, "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "PositionFiltering": "TimeBased", "Tags": { "Tag1" : "Value1" }, "TrackerArn": "arn:aws:geo:us-west-2:123456789012:tracker/ExampleTracker", "TrackerName": "ExampleTracker", "UpdateTime": 2020-10-02T19:10:07.327Z } ``` ------ #### [ CLI ] Use o comando `[describe-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/describe-tracker.html)`. O exemplo a seguir é um AWS CLI comando para obter detalhes do rastreador. *ExampleTracker* ``` aws location describe-tracker \ --tracker-name "ExampleTracker" ``` ------ ## Exclua um rastreador Você pode excluir um rastreador da sua AWS conta usando o console de localização da Amazon AWS CLI, o ou o Amazon Location: APIs ------ #### [ Console ] **Para excluir um recurso de mapa existente usando o console do Amazon Location** **Atenção** Essa operação exclui o recurso permanentemente. Se o recurso do rastreador estiver em uso, você poderá encontrar um erro. Confira se o recurso de destino não é uma dependência para seus aplicativos. 1. Abra o console de localização da Amazon em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. Selecione **Rastreadores** no painel de navegação à esquerda. 1. Em **Meus rastreadores**, selecione o rastreador de destino. 1. Selecione **Excluir rastreador**. ------ #### [ API ] Use a `[DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html)` operação do Amazon Location Tracker APIs. O exemplo a seguir é uma solicitação de API para excluir o rastreador*ExampleTracker*. ``` DELETE /tracking/v0/trackers/ExampleTracker ``` Este é um exemplo de resposta para `[DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html)`: ``` HTTP/1.1 200 ``` ------ #### [ CLI ] Use o comando `[delete-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/delete-tracker.html)`. O exemplo a seguir é um AWS CLI comando para excluir o rastreador*ExampleTracker*. ``` aws location delete-tracker \ --tracker-name "ExampleTracker" ``` ------ # Gerenciar custos e uso À medida que você continua aprendendo sobre os rastreadores do Amazon Location, é importante entender como gerenciar a capacidade do serviço, garantir que você siga os limites de uso e obter os melhores resultados por meio de otimizações de cotas e APIs. Quando aplica as práticas recomendadas de desempenho e precisão, você pode personalizar o aplicativo para lidar com consultas relacionadas ao local de forma eficiente e maximizar as solicitações de API. **Topics** + [Preços de rastreadores](trackers-pricing.md) + [Cota e uso dos rastreadores](trackers-quotas.md) # Preços de rastreadores Para obter informações sobre preços de APIs de rastreamento e geocercas, consulte a [página de preços do Amazon Location Service](https://aws.amazon.com/location/pricing/). **Posição escrita** Você pode usar `BatchUpdateDevicePosition` para carregar dados de atualização de posição de um ou mais dispositivos para um recurso de rastreador (até dez dispositivos por lote). O preço é baseado no número de posições do dispositivo em suas solicitações de API. O preço unitário por atualização da posição do dispositivo é baseado no volume total de uso mensal. Consulte a [página de preços do Amazon Location Service](https://aws.amazon.com/location/pricing/) para obter detalhes sobre preços unitários e níveis de volume. Você pode otimizar seu custo de Posição escrita configurando a frequência de atualização da posição do dispositivo (também conhecida como taxa de ping) em seus dispositivos de rastreamento e, opcionalmente, usar um filtro de local para carregar somente as atualizações relevantes da posição do dispositivo para o Amazon Location Service. **Posição lida** Você pode usar `BatchGetDevicePosition` para listar as posições mais recentes dos dispositivos solicitados, até 100 dispositivos por solicitação. Você também pode usar `GetDevicePosition` para recuperar a posição mais recente de um dispositivo de acordo com o tempo de amostragem. O preço é baseado no número de solicitações de API. **Posição excluir** Você pode usar `BatchDeleteDevicePositionHistory` para excluir o histórico de posição de um ou mais dispositivos de um recurso rastreador, até 100 dispositivos por solicitação. O preço é baseado no número de dispositivos em sua solicitação de API. **Avaliação da integridade da posição** Você pode usar `VerifyDevicePosition` para verificar a integridade da posição do dispositivo determinando se ela foi relatada por meio de um proxy e comparando-a com uma posição inferida estimada com base no estado do dispositivo. O preço é baseado no número de solicitações de API. # Cota e uso dos rastreadores Este tópico apresenta um resumo dos limites de taxas e cotas dos rastreadores do Amazon Location Service. **nota** Se precisar de cotas mais altas, você poderá usar o console do Service Quotas para [solicitar aumentos das cotas](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) para cotas ajustáveis. Ao solicitar um aumento de cota, selecione a região na qual você deseja aumentar a cota, pois a maioria das cotas é específica da região. AWS Você pode solicitar até o dobro do limite padrão para cada API. Para solicitações que excedam o dobro do limite padrão, sua solicitação enviará um ticket de suporte. Você também pode entrar em contato com sua equipe de suporte premium. Não há cobranças diretas para solicitações de aumento de cota, mas níveis mais altos de uso podem levar ao aumento dos custos de serviço com base nos recursos adicionais consumidos. Consulte [Gerenciar cotas com o Service Quotas](manage-quotas.md) para obter mais informações. As Cotas de Serviço são o número máximo de recursos que você pode ter por AWS conta e AWS região. O Amazon Location Service nega solicitações adicionais que excedam a Cota de serviço. ## Recursos | Nome da API | Padrão | Limite máximo ajustável | | --- | --- | --- | | Recursos de Rastreamento por conta | 500 | 1000 Se precisar de mais do que isso, [solicite aumentos de cota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou entre em contato com a equipe de suporte. | | Consumidores de rastreador por rastreador | 5 | O limite máximo ajustável não é aplicável. Entre em contato com a equipe de suporte. | ## API CRUD **nota** Se você precisar de um limite maior para qualquer um deles APIs, [solicite aumentos de cota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou entre em contato com a equipe de suporte. | Nome da API | Padrão | Limite máximo ajustável | | --- | --- | --- | | [AssociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_AssociateTrackerConsumer.html) | 10 | 20 | | [CreateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html) | 10 | 20 | | [DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html) | 10 | 20 | | [DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html) | 10 | 20 | | [DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html) | 10 | 20 | | [ListTrackerConsumers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackerConsumers.html) | 10 | 20 | | [ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html) | 10 | 20 | | [UpdateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_UpdateTracker.html) | 10 | 20 | ## Data API (API de dados) **nota** Se você precisar de um limite maior para qualquer um deles APIs, [solicite aumentos de cota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou entre em contato com a equipe de suporte. | Nome da API | Padrão | Limite máximo ajustável | | --- | --- | --- | | [BatchGetDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchGetDevicePosition.html) | 50 | 100 | | [BatchUpdateDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchUpdateDevicePosition.html) | 50 | 100 | | [GetDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePosition.html) | 50 | 100 | | [GetDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePositionHistory.html) | 50 | 100 | | [BatchDeleteDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchDeleteDevicePositionHistory.html) | 50 | 100 | | [ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html) | 50 | 100 | ## Outros limites de uso