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á. # 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.