Seleccione sus preferencias de cookies

Usamos cookies esenciales y herramientas similares que son necesarias para proporcionar nuestro sitio y nuestros servicios. Usamos cookies de rendimiento para recopilar estadísticas anónimas para que podamos entender cómo los clientes usan nuestro sitio y hacer mejoras. Las cookies esenciales no se pueden desactivar, pero puede hacer clic en “Personalizar” o “Rechazar” para rechazar las cookies de rendimiento.

Si está de acuerdo, AWS y los terceros aprobados también utilizarán cookies para proporcionar características útiles del sitio, recordar sus preferencias y mostrar contenido relevante, incluida publicidad relevante. Para aceptar o rechazar todas las cookies no esenciales, haga clic en “Aceptar” o “Rechazar”. Para elegir opciones más detalladas, haga clic en “Personalizar”.

Preferencias
Contacte con nosotros
Comentarios
AWS Documentation
Cree una cuenta AWS

Agregar geovallas con Amazon Location

PDF
RSS
Modo de enfoque
Agregar geovallas con Amazon Location - Amazon Location Service
Crear una colección de geocercasDibujar geocercasAgregar geocercas poligonalesagregar geocercas circulares

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 geocercas para almacenar y gestionar las geocercas mediante la consola de Amazon Location, AWS CLI o las API de Amazon Location.

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 regla de EventBridge con CloudWatch como objetivo, puede crear una regla de EventBridge opcional para empezar a reaccionar ante los eventos de geocerca. Esto permite a Amazon Location publicar eventos en Registros de Amazon CloudWatch.

  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 Etiquetar 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 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 geocercas llamada ExampleGeofenceCollection. La colección de geocercas está asociada a una clave de AWS KMS gestionada 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 geocercas llamada ExampleGeofenceCollection. La colección de geocercas está asociada a una clave de AWS KMS gestionada 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
anchoranchoranchor

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 regla de EventBridge con CloudWatch como objetivo, puede crear una regla de EventBridge opcional para empezar a reaccionar ante los eventos de geocerca. Esto permite a Amazon Location publicar eventos en Registros de Amazon CloudWatch.

  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 Etiquetar 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 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.
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 usar el archivo de GeoJSON resultante para cargar sus geocercas mediante la consola de Amazon Location Service, la AWS CLI y las API de Amazon Location:

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 agregar una geocerca con el ID GEOFENCE-EXAMPLE1 a una colección de geocercas 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 de la AWS CLI

Utilice el comando put-geofence.

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

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.

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 agregar una geocerca con el ID GEOFENCE-EXAMPLE2 a una colección de geocercas 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 agregar una geocerca circular a una colección de geocercas mediante comandos de la AWS CLI

Utilice el comando put-geofence.

En el siguiente ejemplo, se utiliza una AWS CLI para agregar una geocerca 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

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

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

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 agregar una geocerca con el ID GEOFENCE-EXAMPLE2 a una colección de geocercas llamada ExampleGeofenceCollection:

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

En esta página

PrivacidadTérminos del sitioPreferencias de cookies
© 2025, Amazon Web Services, Inc o sus afiliados. Todos los derechos reservados.