Agregar geocercas

Las geocercas contienen puntos y vértices que forman un límite cerrado que define un área de interés. Las colecciones de geocercas almacenan y administran una o varias geocercas.

Las colecciones de geocercas de Amazon Location almacenan las geocercas definidas mediante un formato de datos geoespaciales estándar denominado GeoJSON (RFC 7946). Puede utilizar herramientas, como geojson.io, sin coste alguno para dibujar sus geocercas gráficamente y guardar el archivo GeoJSON de salida.

nota

Amazon Location no admite polígonos con agujeros, multipolígonos, polígonos en el sentido de las agujas del reloj ni geocercas que crucen el antimeridiano.

Crear una colección de geocercas

Cree una colección de geovallas para almacenar y gestionar geocercas mediante la consola de ubicación de Amazon, las AWS CLI o las API de ubicación de Amazon.

Console

Para crear una colección de geocercas mediante la consola de Amazon Location

1. Abra la consola de Amazon Location Service en https://console.aws.amazon.com/location/.

2. En el panel de navegación izquierdo, elija Colecciones de geocercas.

3. Seleccione Crear colección de geocercas.

4. Complete las casillas siguientes:

   • Nombre: escriba un nombre único. Por ejemplo,. ExampleGeofenceCollection 100 caracteres como máximo. Entre las entradas válidas se incluyen caracteres alfanuméricos, guiones, puntos y guiones bajos.

   • Descripción: introduzca una descripción opcional para diferenciar sus recursos.

5. En el EventBridge caso de la regla con CloudWatch como objetivo, puede crear una EventBridge regla opcional para empezar a reaccionar ante los eventos de la geocerca. Esto permite a Amazon Location publicar eventos en Amazon CloudWatch Logs.

6. (Opcional) En Etiquetas, escriba una clave y un valor de etiqueta. Esto añade una etiqueta a su nueva colección de geocercas. Para obtener más información, consulte Etiquetado de los recursos de Amazon Location Service.

7. (Opcional) En Cifrado de claves gestionadas por el cliente, puede optar por agregar una clave gestionada por el cliente. Esto añade una clave simétrica gestionada por el cliente que usted crea, posee y administra mediante el cifrado que AWS posee de forma predeterminada. Para obtener más información, consulte Cifrado de datos en reposo.

8. Seleccione Crear colección de geocercas.

API

Para crear una colección de geocercas mediante las API de Amazon Location

Utilice la operación CreateGeofenceCollection desde las API de Amazon Location Geofences.

En el siguiente ejemplo, se utiliza una solicitud de API para crear una colección de geovallas llamada. ExampleGeofenceCollection La colección de geocercas está asociada a una AWS KMS clave administrada por el cliente para cifrar los datos del 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 crear una colección de geocercas mediante comandos AWS CLI

Utilice el comando create-geofence-collection.

En el siguiente ejemplo se utiliza una AWS CLI para crear una colección de geovallas llamada. ExampleGeofenceCollection La colección de geovallas está asociada a una AWS KMS clave administrada por el cliente para cifrar los datos del 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

La facturación depende del uso. Puede incurrir en cargos por el uso de otros servicios de AWS . Para obtener más información, consulte los precios de Amazon Location Service.

Dibujar geocercas

Ahora que ha creado su colección de geocercas, puede definir sus geocercas. Las geocercas se definen como un polígono o un círculo. Para dibujar una geocerca poligonal, puede utilizar una herramienta de edición de GeoJSON, como geojson.io.

Para crear una geocerca como un círculo, debe definir el punto central del círculo y el radio. Por ejemplo, si desea crear una geocerca para recibir notificaciones cada vez que un dispositivo se encuentre a menos de 50 metros de una ubicación específica, debe utilizar la latitud y la longitud de esa ubicación y especificar el radio en 50 metros.

Con las API de Amazon Location Service, también puede agregar metadatos a su geocerca en forma de pares clave-valor. Pueden resultar útiles para almacenar información sobre la geocerca, como su tipo, u otra información específica de su aplicación. Puede utilizar estos metadatos al Cómo reaccionar a los eventos de Amazon Location Service con Amazon EventBridge.

Agregar geocercas poligonales

En esta sección se describe la creación de geocercas poligonales

Dibujar geocercas con una herramienta de GeoJSON

Ahora que ha creado su colección de geocercas, puede definirlas mediante una herramienta de edición de GeoJSON, como geojson.io.

Para crear un archivo de GeoJSON

1. Abra una herramienta de edición de GeoJSON. Por ejemplo, geojson.io.

2. Elija el icono Dibujar un polígono y dibuje su área de interés.

3. Seleccione Guardar y, a continuación, seleccione GeoJSON en el menú desplegable.

Coloque geocercas de GeoJSON en una colección de geocercas

Puede utilizar el archivo GeoJSON resultante para cargar sus geocercas mediante la consola de Amazon Location Service, las API de ubicación de Amazon AWS CLI o las API de ubicación de Amazon:

Console

Para agregar una geocerca a una colección de geocercas mediante la consola de Amazon Location Service

1. Abra la consola de Amazon Location Service en https://console.aws.amazon.com/location/.

2. En el panel de navegación izquierdo, elija Colecciones de geocercas.

3. En la lista de Colecciones de geocercas, seleccione el enlace con el nombre de la colección de geocercas de destino.

4. En Geocercas, elija Crear geocercas.

5. En la ventana Agregar geocercas, arrastre y suelte su GeoJSON en la ventana.

6. Seleccione Agregar geocercas.

API

Para agregar geocercas mediante las API de Amazon Location

Utilice la operación PutGeofence desde las API de Amazon Location Geofences.

En el siguiente ejemplo, se utiliza una solicitud de API para añadir una geocerca con el ID GEOFENCE-EXAMPLE1 a una colección de geovallas llamada. ExampleGeofenceCollection También especifica una única propiedad de metadatos de geocerca con la clave Type y el 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, puede agregar más de una geocerca mediante la operación 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 agregar una geocerca a una colección de geocercas mediante comandos AWS CLI

Utilice el comando put-geofence.

En el siguiente ejemplo, se usa una AWS CLI para agregar una geocerca a una colección de geocercas llamada. 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"
    }

agregar geocercas circulares

En esta sección se describe la creación de geocercas circulares. Debe conocer la latitud y la longitud del punto que desea que sea el centro del círculo y el radio en metros del círculo. Puede crear geocercas circulares con las API de Amazon Location o con la AWS CLI.

API

Para agregar geocercas circulares mediante las API de Amazon Location

Utilice la operación PutGeofence desde las API de Amazon Location Geofences.

En el siguiente ejemplo, se utiliza una solicitud de API para añadir una geocerca con el ID GEOFENCE-EXAMPLE2 a una colección de geovallas llamada: 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 añadir una geocerca circular a una colección de geocercas mediante comandos AWS CLI

Utilice el comando put-geofence.

En el siguiente ejemplo, se usa una AWS CLI para agregar una geocerca a una colección de geocercas llamada. ExampleGeofenceCollection

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

nota

También puede incluir JSON para geometrías complejas en su propio archivo, como en el siguiente ejemplo.

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

En el ejemplo, el archivo circle.json incluye JSON para la geometría circular.

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