Adicione geocercas

As geocercas contêm pontos e vértices que formam um limite fechado, que define uma área de interesse. As coleções de geocercas armazenam e gerenciam uma ou várias geocercas.

As coleções de geocercas do Amazon Location armazenam geocercas definidas usando um formato de dados geoespaciais padrão chamado GeoJSON (RFC 7946). Você pode usar ferramentas, como o geojson.io, gratuitamente para desenhar suas geocercas graficamente e salvar o arquivo GeoJSON de saída.

nota

O Amazon Location não oferece suporte para polígonos com furos, multipolígonos, polígonos no sentido horário e geocercas que cruzam o antimeridiano.

Criar uma coleção de geofences

Crie uma coleção de cercas geográficas para armazenar e gerenciar cercas geográficas usando o console de localização da Amazon, o AWS CLI ou as APIs de localização da Amazon.

Console

Para criar uma coleção de geocercas usando o console Amazon Location

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

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

3. Selecione Criar coleção de geocercas.

4. Preencha as seguintes caixas:

   • Nome: insira um nome exclusivo. Por exemplo, ExampleGeofenceCollection. Máximo de 100 caracteres. Entradas válidas incluem caracteres alfanuméricos, hifens, pontos e sublinhados.

   • Descrição: insira uma descrição opcional para diferenciar seus recursos.

5. Em EventBridge regra com CloudWatch como destino, você pode criar uma EventBridge regra opcional para começar a reagir aos eventos de delimitação geográfica. Isso permite que o Amazon Location publique eventos no Amazon CloudWatch Logs.

6. (Opcional) Em Tags, insira uma tag Chave e Valor. Isso adiciona uma tag à sua nova coleção de geocercas. Para ter mais informações, consulte Marcar os recursos do Amazon Location Service.

7. (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.

8. Selecione Criar coleção de geocercas.

API

Para criar uma coleção de geocercas usando as APIs do Amazon Location

Use a operação CreateGeofenceCollection das APIs de geocercas do Amazon Location.

O exemplo a seguir usa uma solicitação de API para criar uma coleção de geofence chamada. ExampleGeofenceCollection A coleção de cercas geográficas está associada a uma AWS KMS chave gerenciada pelo cliente para criptografar os dados do cliente.

POST /geofencing/v0/collections
Content-type: application/json

{
   "CollectionName": "ExampleGeofenceCollection",
   "Description": "Geofence collection 1 for shopping center",
   "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
   "Tags": { 
      "Tag1" : "Value1"
   }
}

AWS CLI

Para criar uma coleção de geocercas usando comandos AWS CLI

Use o comando create-geofence-collection.

O exemplo a seguir usa um AWS CLI para criar uma coleção de geofence chamada. ExampleGeofenceCollection A coleção de cercas geográficas está associada a uma AWS KMS chave gerenciada pelo cliente para criptografar os dados do cliente.

aws location \
  create-geofence-collection \
  --collection-name "ExampleGeofenceCollection" \
  --description "Shopping center geofence collection" \
  --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab" \
  --tags Tag1=Value1

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.

Desenhe geocercas

Agora que você criou sua coleção de geocercas, você pode definir suas geocercas. As geocercas são definidas como um polígono ou como um círculo. Para desenhar uma geocerca poligonal, você pode usar uma ferramenta de edição GeoJSON, como o geojson.io.

Para criar uma geocerca circular, você deve definir o ponto central do círculo e o raio. Por exemplo, se você quiser criar uma geocerca para ser notificado sempre que um dispositivo chegar a 50 metros de um local específico, use a latitude e a longitude desse local e especifique o raio como 50 metros.

Usando as APIs do Amazon Location Service, você também pode adicionar metadados à sua geocerca na forma de pares chave-valor. Eles podem ser úteis para armazenar informações sobre a geocerca, como seu tipo ou outras informações específicas do seu aplicativo. Você pode usar esses metadados quando Reagindo aos eventos do Amazon Location Service com a Amazon EventBridge.

Adicionando geocercas poligonais

Esta seção descreve a criação de geocercas poligonais

Desenhe geocercas usando uma ferramenta GeoJSON

Agora que você criou sua coleção de geocercas, você pode definir suas geocercas usando uma ferramenta de edição GeoJSON, como o geojson.io.

Para criar um arquivo GeoJSON

1. Abra uma ferramenta de edição GeoJSON. Por exemplo, o geojson.io.

2. Selecione o ícone Desenhar um polígono e desenhe sua área de interesse.

3. Selecione Salvar e, em seguida, escolha GeoJSON no menu suspenso.

Coloque geocercas GeoJSON em uma coleção de geocercas

Você pode usar o arquivo GeoJSON resultante para carregar suas cercas geográficas usando o console do Amazon Location Service, o, ou as APIs de localização AWS CLI da Amazon:

Console

Para adicionar uma geocerca 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/.

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

3. Na lista de Coleções de geocercas, selecione o link do nome da coleção de geocercas de destino.

4. Em Geocercas, selecione Criar geocercas.

5. Na janela Adicionar geocercas, arraste e solte seu GeoJSON na janela.

6. Selecione Adicionar geocercas.

API

Para adicionar geocercas usando as APIs do Amazon Location

Use a operação PutGeofence das APIs de geocercas do Amazon Location.

O exemplo a seguir usa uma solicitação de API para adicionar uma cerca geográfica com o ID GEOFENCE-EXAMPLE1 a uma coleção de delimitação geográfica chamada. ExampleGeofenceCollection Ela também especifica uma única propriedade para os metadados da geocerca com a chave Type e o valor loadingArea.

PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofence/GEOFENCE-EXAMPLE1
    Content-type: application/json
    
    {
       "GeofenceProperties": {
          "Type" : "loadingArea"
       },
       "Geometry": { 
          "Polygon": [   
            [
                [-5.716667, -15.933333],
                [-14.416667, -7.933333],
                [-12.316667, -37.066667],
                [-5.716667, -15.933333]
            ]
          ]
       }
    }

Como alternativa, você pode adicionar mais de uma geocerca usando a operação BatchPutGeofence.

POST /geofencing/v0/collections/ExampleGeofenceCollection/put-geofences
    Content-type: application/json
    
    {
       "Entries": [ 
          {
             "GeofenceProperties": {
                "Type" : "loadingArea"
             },
             "GeofenceId": "GEOFENCE-EXAMPLE1",
             "Geometry": { 
                "Polygon": [ 
                   [ 
                      [-5.716667, -15.933333],
                      [-14.416667, -7.933333],
                      [-12.316667, -37.066667],
                      [-5.716667, -15.933333]
                   ]
                ]
             }
          }
       ]
    }

AWS CLI

Para adicionar uma cerca geográfica a uma coleção de cercas geográficas usando comandos AWS CLI

Use o comando put-geofence.

O exemplo a seguir usa an AWS CLI para adicionar uma cerca geográfica a uma coleção de cerca geográfica chamada. ExampleGeofenceCollection

$ aws location \
        put-geofence \
            --collection-name ExampleGeofenceCollection \
            --geofence-id ExampleGeofenceTriangle \
            --geofence-properties '{"Type": "loadingArea"}' \
            --geometry 'Polygon=[[[-5.716667, -15.933333],[-14.416667, -7.933333],[-12.316667, -37.066667],[-5.716667, -15.933333]]]'
    {
        "CreateTime": "2020-11-11T00:16:14.487000+00:00",
        "GeofenceId": "ExampleGeofenceTriangle",
        "UpdateTime": "2020-11-11T00:19:59.894000+00:00"
    }

Adicionando geocercas circulares

Esta seção descreve a criação de geocercas circulares. Você deve saber a latitude e a longitude do ponto o qual você deseja que seja o centro do círculo e o raio do círculo em metros. Você pode criar geocercas circulares com as APIs do Amazon Location ou o AWS CLI.

API

Para adicionar geocercas circulares usando as APIs do Amazon Location

Use a operação PutGeofence das APIs de geocercas do Amazon Location.

O exemplo a seguir usa uma solicitação de API para adicionar uma cerca geográfica com o ID GEOFENCE-EXAMPLE2 a uma coleção de delimitação geográfica chamada: ExampleGeofenceCollection

PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofence/GEOFENCE-EXAMPLE2
    Content-type: application/json
    
    {
       "Geometry": { 
          "Circle": {   
            "Center": [-5.716667, -15.933333],
            "Radius": 50
          }
       }
    }

AWS CLI

Para adicionar uma cerca geográfica circular a uma coleção de cercas geográficas usando comandos AWS CLI

Use o comando put-geofence.

O exemplo a seguir usa an AWS CLI para adicionar uma cerca geográfica a uma coleção de cerca geográfica chamada. ExampleGeofenceCollection

$ aws location \
        put-geofence \
            --collection-name ExampleGeofenceCollection \
            --geofence-id ExampleGeofenceCircle \
            --geometry 'Circle={Center=[-5.716667, -15.933333], Radius=50}'

nota

Você também pode colocar JSON para geometria complexa em seu próprio arquivo, como no exemplo a seguir.

$ aws location \
        put-geofence \
            --collection-name ExampleGeofenceCollection \
            --geofence-id ExampleGeofenceCircle \
            --geometry file:circle.json

No exemplo, o arquivo circle.json inclui JSON para a geometria do círculo.

{
    "Circle": {
        "Center": [-74.006975, 40.717127],
        "Radius": 287.7897969218057
    }
}