Administración de los recursos de recopilación de geocercas - Amazon Location Service
Enumerar sus recursos de colección de geocercasObtenga los detalles de la colección de geocercasEliminar una colección de geocercasEnumerar las geocercas almacenadasObtener detalles de geocercasEliminar geocercas

Administración de los recursos de recopilación de geocercas

Gestione sus colecciones de geocercas mediante la consola de Amazon Location, la AWS CLI o las API de Amazon Location.

Enumerar sus recursos de colección de geocercas

Puede ver su lista de colecciones de geocercas mediante la consola de Amazon Location, la AWS CLI o las API de Amazon Location:

Console

Para ver una lista de colecciones de geocercas mediante la consola de Amazon Location

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

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

  3. Consulte una lista de sus colecciones de geocercas en Mis colecciones de geocercas.

API

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

El siguiente ejemplo es una solicitud de API para obtener una lista de las colecciones de geocercas de la cuenta de AWS. 

POST /geofencing/v0/list-collections

A continuación se muestra un ejemplo de respuesta para ListGeofenceCollections:

{
    "Entries": [ 
    { 
        "CollectionName": "ExampleCollection",
        "CreateTime": 2020-09-30T22:59:34.142Z,
        "Description": "string",
        "UpdateTime": 2020-09-30T23:59:34.142Z
    },
    "NextToken": "1234-5678-9012"
}
CLI

Utilice el comando list-geofence-collections.

El siguiente ejemplo es una AWS CLI para obtener una lista de las colecciones de geocercas de la cuenta de AWS. 

aws location list-geofence-collections

Obtenga los detalles de la colección de geocercas

Puede obtener información sobre cualquier recurso de colección de geocercas de su cuenta de AWS mediante la consola de Amazon Location, la AWS CLI o la API de Amazon Location:

Console

Para ver los detalles de una colección de geocercas mediante la consola de Amazon Location

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

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

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

API

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

El siguiente ejemplo es una solicitud de API para obtener los detalles de la colección de geocercas para ExampleCollection.

GET /geofencing/v0/collections/ExampleCollection

A continuación se muestra un ejemplo de respuesta para DescribeGeofenceCollection:

{
    "CollectionArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/GeofenceCollection",
    "CollectionName": "ExampleCollection",
    "CreateTime": 2020-09-30T22:59:34.142Z,
    "Description": "string",
    "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
    "Tags": { 
        "Tag1" : "Value1"
    },
    "UpdateTime": 2020-09-30T23:59:34.142Z
}
CLI

Utilice el comando describe-geofence-collection.

El siguiente ejemplo es una AWS CLI para obtener los detalles de la colección de geocercas de ExampleCollection.

aws location describe-geofence-collection \
    --collection-name "ExampleCollection"

Eliminar una colección de geocercas

Puede eliminar una colección de geocercas de su cuenta de AWS mediante la consola de Amazon Location, la AWS CLI o las API de Amazon Location.

Console

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

aviso

Esta operación elimina el recurso de forma permanente.

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

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

  3. En Mi colección de geocercas, seleccione la colección de geocercas de destino.

  4. Seleccione Eliminar colección de geocercas.

API

Use la operación DeleteGeofenceCollection de las API de Amazon Location.

El siguiente ejemplo es una solicitud de API para eliminar la colección de geocercas ExampleCollection.

DELETE /geofencing/v0/collections/ExampleCollection

A continuación se muestra un ejemplo de respuesta para DeleteGeofenceCollection:

HTTP/1.1 200
CLI

Utilice el comando delete-geofence-collection.

El siguiente ejemplo es un comando de la AWS CLI para eliminar la colección de geocercas ExampleCollection.

aws location delete-geofence-collection \
    --collection-name "ExampleCollection"

Enumerar las geocercas almacenadas

Puede enumerar las geocercas almacenadas en una colección de geocercas específica mediante la consola de Amazon Location, la AWS CLI o las API de Amazon Location.

Console

Para ver una lista de geocercas mediante la consola de Amazon Location

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

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

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

  4. Consulte las geocercas de la colección de geocercas en Geocercas

API

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

El siguiente ejemplo es una solicitud de API para obtener una lista de geocercas almacenadas en la colección de geocercas ExampleCollection. 

POST /geofencing/v0/collections/ExampleCollection/list-geofences

A continuación se muestra un ejemplo de respuesta para ListGeofences:

{
   "Entries": [ 
      { 
         "CreateTime": 2020-09-30T22:59:34.142Z,
         "GeofenceId": "geofence-1",
         "Geometry": { 
             "Polygon": [            
                 [-5.716667, -15.933333,
                 [-14.416667, -7.933333],
                 [-12.316667, -37.066667],
                 [-5.716667, -15.933333]
             ]
         },
         "Status": "ACTIVE",
         "UpdateTime": 2020-09-30T23:59:34.142Z
      }
   ],
   "NextToken": "1234-5678-9012"
}
CLI

Utilice el comando list-geofences.

El siguiente ejemplo es una AWS CLI para obtener una lista de geocercas almacenadas en la colección de geocercas ExampleCollection. 

aws location list-geofences \
    --collection-name "ExampleCollection"

Obtener detalles de geocercas

Puede obtener los detalles de una geocerca específica, como la hora de creación, la hora de actualización, la geometría y el estado, de una colección de geocercas mediante la consola de Amazon Location, la AWS CLI o las API de Amazon Location.

Console

Para ver el estado de una geocerca mediante la consola de Amazon Location

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

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

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

  4. En Geocercas, podrá ver el estado de sus geocercas.

API

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

El siguiente ejemplo es una solicitud de API para obtener los detalles de geocerca de una colección de geocercas ExampleCollection.

GET /geofencing/v0/collections/ExampleCollection/geofences/ExampleGeofence1

A continuación se muestra un ejemplo de respuesta para GetGeofence:

{
   "CreateTime": 2020-09-30T22:59:34.142Z,
   "GeofenceId": "ExampleGeofence1",
   "Geometry": { 
      "Polygon": [            
          [-1,-1],
          [1,-1],
          [0,1],
          [-1,-1] 
      ]
   },
   "Status": "ACTIVE",
   "UpdateTime": 2020-09-30T23:59:34.142Z
}
CLI

Utilice el comando get-geofence.

El siguiente ejemplo es una AWS CLI para obtener los detalles de la colección de geocercas de ExampleCollection.

aws location get-geofence \
    --collection-name "ExampleCollection" \
    --geofence-id "ExampleGeofence1"

Eliminar geocercas

Puede eliminar las geocercas de una colección de geocercas mediante la consola de Amazon Location, la AWS CLI o las API de Amazon Location.

Console

Para eliminar una geocerca mediante la consola de Amazon Location

aviso

Esta operación elimina el recurso de forma permanente.

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

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

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

  4. En Geocercas, seleccione la geocerca de destino.

  5. Seleccione Eliminar geocerca.

API

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

El siguiente ejemplo es una solicitud de API para eliminar geocercas de la colección de geocercas ExampleCollection.

POST /geofencing/v0/collections/ExampleCollection/delete-geofences
Content-type: application/json

{
   "GeofenceIds": [ "ExampleGeofence11" ]
}

A continuación se muestra un ejemplo de una respuesta correcta para BatchDeleteGeofence. 

HTTP/1.1 200
CLI

Utilice el comando batch-delete-geofence.

El siguiente ejemplo es un comando AWS CLI para eliminar geocercas de la colección de geocercas ExampleCollection.

aws location batch-delete-geofence \
    --collection-name "ExampleCollection" \
    --geofence-ids "ExampleGeofence11"