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á.
Saiba mais sobre cercas geográficas no Amazon Location Service
Os recursos de coleção de geocercas permitem que você armazene e gerencie geocercas, que são limites virtuais em um mapa. Você pode avaliar as localizações em relação a um recurso de coleção de geocercas e receber notificações quando a atualização de localização ultrapassar os limites de qualquer uma das geocercas na coleção de geocercas.
Veja a seguir como criar e usar recursos de coleção de geocercas:
-
Crie um recurso de coleta de cercas geográficas em sua AWS conta.
-
Adicione geocercas a essa coleção. Você pode fazer isso usando a ferramenta de upload de cercas geográficas no console de localização da Amazon ou usando as cercas geográficas de localização da Amazon. API Para obter mais informações sobre as opções disponíveis, consulte Acesso ao Amazon Location.
As geocercas podem ser definidas por um polígono ou por um círculo. Use um polígono para descobrir quando um dispositivo entra em uma área específica. Use um círculo para descobrir quando um dispositivo está a uma certa distância (raio) de um ponto.
-
Você pode começar a avaliar as localizações em relação a todas as suas geocercas. Quando uma atualização de localização ultrapassa os limites de uma ou mais cercas geográficas, seu recurso de coleta de cercas geográficas emite um dos seguintes tipos de eventos de cercas geográficas na Amazon: EventBridge
-
ENTER— Um evento é gerado para cada cerca geográfica em que a atualização de localização cruza seu limite ao entrar nela.
-
EXIT— Um evento é gerado para cada cerca geográfica em que a atualização de localização cruza seus limites ao sair dela.
Para obter mais informações, consulte Reagindo aos eventos do Amazon Location Service com a Amazon EventBridge. Você também pode integrar o monitoramento usando serviços como Amazon CloudWatch AWS CloudTrail e. Para obter mais informações, consulte Monitore o Amazon Location Service com a Amazon CloudWatch e Registre e monitore com AWS CloudTrail.
-
Por exemplo, se você estiver rastreando uma frota de caminhões e quiser ser notificado quando um caminhão chegar a uma determinada área de qualquer um dos seus armazéns. Você pode criar uma geocerca para a área ao redor de cada depósito. Então, quando os caminhões enviarem localizações atualizadas, você pode usar o Amazon Location Service para avaliar essas posições e ver se um caminhão entrou (ou saiu) de uma das áreas de geocercas.
nota
Você é cobrado pelo número de coleções de geocercas que você avalia. 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. Os eventos gerados incluirão a ID da geocerca individual na coleção, bem como a ID da coleção.
Eventos de geocercas
As localizações das posições que você está monitorando são referenciadas por uma ID chamada de DeviceId (e as posições são referenciadas como posições do dispositivo). Você pode enviar uma lista de posições do dispositivo para avaliação diretamente com o recurso de coleção de geocercas ou usar um rastreador. Consulte a próxima seção para mais informações sobre rastreadores.
Você recebe eventos (via Amazon EventBridge) somente quando um dispositivo entra ou sai de uma cerca geográfica, não para cada mudança de posição. Isso significa que normalmente você receberá eventos e precisará responder a eles com muito menos frequência do que cada atualização de posição do dispositivo.
nota
Para a primeira avaliação de localização de um DeviceID específico, presume-se que o dispositivo antes não estava em nenhuma geocerca. Portanto, a primeira atualização irá gerar um evento ENTER, se estiver dentro de uma geocerca na coleção, e nenhum evento se não estiver.
Para calcular se um dispositivo entrou ou saiu de uma geocerca, o Amazon Location Service deve manter o estado da posição anterior do dispositivo. Esse estado de posição é armazenado por 30 dias. Depois de 30 dias sem atualização para um dispositivo, uma nova atualização de localização será tratada como a primeira atualização de posição.
Terminologia de geocercas
- Coleção de geocercas
-
Contém zero ou mais geocercas. É capaz de monitorar a geocerca emitindo eventos de entrada e saída, quando solicitado, para avaliar a posição de um dispositivo em relação às suas geocercas.
- Geocerca
-
Geometria poligonal ou circular que define um limite virtual em um mapa.
- Geometria poligonal
-
Uma geocerca do Amazon Location é um limite virtual para uma área geográfica e é representada como um polígono ou como um círculo.
Um círculo é um ponto com uma distância ao seu redor. Use um círculo quando quiser ser notificado se um dispositivo estiver a uma certa distância de um local.
Um polígono é uma matriz composta por 1 ou mais anéis lineares. Use um polígono quando quiser definir um limite específico para notificações do dispositivo. Um anel linear é uma matriz de quatro ou mais vértices, onde o primeiro e o último vértice são iguais para formar um limite fechado. Cada vértice é um ponto bidimensional da forma
[longitude, latitude], onde as unidades de longitude e latitude são graus. Os vértices devem ser listados no sentido anti-horário ao redor do polígono.nota
O Amazon Location Service não é compatível com polígonos com mais de um anel. Isso inclui furos, ilhas ou multipolígonos. O Amazon Location também não é compatível com polígonos enrolados no sentido horário ou que cruzam o antimeridiano.
Veja a seguir um exemplo de um único anel externo linear:
[ [ [-5.716667, -15.933333], [-14.416667, -7.933333], [-12.316667, -37.066667], [-5.716667, -15.933333] ] ]
