View a markdown version of this page

Cómo agregar geovallas con Amazon Location - Amazon Location Service
Creación de una colección de geovallasDibujar geocercasAñada geocercas poligonalesAgregue geocercas circulares

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Cómo agregar geovallas con Amazon Location

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 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 en el sentido de las agujas del reloj (utilice el orden de enrollamiento en sentido contrario a las agujas del reloj, tal como exige el RFC 7946 § 3.1.6) ni geocercas que crucen el antimeridiano (la línea de longitud de 180°).

Creación de una colección de geovallas

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. Abre 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 una 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 geofence. Para obtener más información, consulte Administrar recursos con etiquetas.

  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 a través del cifrado predeterminado propiedad de AWS . 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 geofence 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 AWS CLI para crear una colección de geocercas llamada. ExampleGeofenceCollection La colección de geocercas 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. Es posible que se le paguen tarifas por el uso de otros servicios. 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 circular, defina el punto central utilizando la latitud y la longitud de la ubicación y establezca el radio en metros. Para obtener más información, consulte Agregue geocercas circulares.

Con las API de Amazon Location Service, también puede añadir 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 Reaccione a los eventos de Amazon Location Service con Amazon EventBridge.

Añada geocercas poligonales

Las geocercas poligonales utilizan matrices de coordenadas GeoJSON para definir un área. Utilice este formato cuando necesite rastrear las entradas o salidas de un límite geográfico de forma irregular.

Dibujar geocercas con una herramienta de GeoJSON

Para crear un archivo de GeoJSON

  1. Abra una herramienta de edición de GeoJSON, como 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. Abre 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 Añadir 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 propiedad de metadatos de una geocerca con la clave y el 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, 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 utiliza 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]]]'

Agregue geocercas circulares

Para crear una geocerca circular, debe conocer la latitud y la longitud del punto central y el radio en metros. Utilice geocercas circulares cuando necesite activar eventos en función de la proximidad a un punto específico, como una tienda, un almacén o un punto de referencia. Puede crear geocercas circulares con la consola de ubicación de Amazon, las API de ubicación de Amazon o la. AWS CLI

Console
Para añadir una geocerca circular a una colección de geocercas mediante la consola Amazon Location Service

  1. Abre 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 Añadir geocercas, seleccione Círculo e introduzca la latitud, la longitud y el radio del centro en metros.

  6. Seleccione Agregar geocercas.

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/geofences/GEOFENCE-EXAMPLE2
Content-type: application/json

{
   "Geometry": {
      "Circle": {
        "Center": [-5.716667, -15.933333],
        "Radius": 50
      }
   }
}
AWS CLI
Para agregar una geocerca circular a una colección de geocercas mediante comandos AWS CLI

Utilice el comando put-geofence.

En el siguiente ejemplo, se utiliza AWS CLI para agregar una geocerca circular a una colección de geocercas denominada. 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

Dónde circle.json contiene la geometría circular.

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