View a markdown version of this page

Adicione cercas geográficas com a Amazon Location - Amazon Location Service
Criar uma coleção de gepcercasDesenhe geocercasAdicionar cercas geográficas poligonaisAdicione geofences circulares

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

Adicione cercas geográficas com a Amazon Location

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 geofence de localização da Amazon armazenam cercas geográficas 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 suporta polígonos no sentido horário (use a ordem de enrolamento no sentido anti-horário, conforme exigido pela RFC 7946 §3.1.6) e cercas geográficas que cruzam o antimeridiano (a linha de longitude de 180°).

Criar uma coleção de gepcercas

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 etiqueta à sua nova coleção de cercas geográficas. Para obter mais informações, consulte Gerenciar recursos com tags.

  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 criada e gerenciada por meio da criptografia de AWS propriedade padrão. 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 geocercas 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 cercas geográficas usando comandos AWS CLI

Use o comando create-geofence-collection.

O exemplo a seguir usa o 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 AWS serviços. 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 cerca geográfica circular, defina o ponto central usando a latitude e a longitude do local e defina o raio em metros. Para obter mais informações, consulte Adicione geofences circulares.

Usando as APIs do Amazon Location Service, você também pode adicionar metadados à sua cerca geográfica na forma de pares de valores-chave. 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 Reaja aos eventos do Amazon Location Service com a Amazon EventBridge.

Adicionar cercas geográficas poligonais

As cercas geográficas poligonais usam matrizes de coordenadas GeoJSON para definir uma área. Use esse formato quando precisar rastrear entradas ou saídas de um limite geográfico de formato irregular.

Desenhe geocercas usando uma ferramenta GeoJSON

Para criar um arquivo GeoJSON

  1. Abra uma ferramenta de edição GeoJSON, como 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, AWS CLI o ou as APIs de localização 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 cercas geográficas, 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 a uma coleção de GEOFENCE-EXAMPLE1 delimitação geográfica chamada. ExampleGeofenceCollection Ela também especifica uma propriedade de metadados de delimitação geográfica com a chave e o valor. Type loadingArea

PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofences/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 o 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]]]'

Adicione geofences circulares

Para criar uma cerca geográfica circular, você deve conhecer a latitude e longitude do ponto central e o raio em metros. Use cercas geográficas circulares quando precisar acionar eventos com base na proximidade de um ponto específico, como uma loja, depósito ou ponto de referência. Você pode criar cercas geográficas circulares com o console de localização da Amazon, as APIs de localização da Amazon ou o. AWS CLI

Console
Para adicionar uma cerca geográfica circular a uma coleção de cercas geográficas 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 cercas geográficas, escolha Círculo e insira o centro de Latitude, Longitude e Raio em metros.

  6. Selecione Adicionar geocercas.

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 a uma coleção de GEOFENCE-EXAMPLE2 delimitação geográfica chamada. ExampleGeofenceCollection

PUT /geofencing/v0/collections/ExampleGeofenceCollection/geofences/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 o AWS CLI para adicionar uma cerca geográfica circular 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

Onde circle.json contém a geometria do círculo.

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