Administrar sus recursos de colección de geovallas

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

Enumerar sus recursos de colección de geovallas

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

Console

Para ver una lista de colecciones de geovallas 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 geovallas.

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

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 geovallas 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 un AWS CLI para obtener una lista de las colecciones de geovallas de la cuenta de AWS.

aws location list-geofence-collections

Obtenga los detalles de la colección de geovallas

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

Console

Para ver los detalles de una colección de geovallas 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 geovallas.

3. En Mis colecciones de geovallas, seleccione el enlace con el nombre de la colección de geovallas 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 recopilación de geocercas. 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 AWS CLI para obtener los detalles de la colección de geovallas. ExampleCollection

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

Eliminar una colección de geovallas

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

Console

Para eliminar una colección de geovallas 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 geovallas.

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

4. Seleccione Eliminar colección de geovallas.

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 geovallas. 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 AWS CLI comando para eliminar la colección de geovallas. ExampleCollection

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

Enumerar las geovallas almacenadas

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

Console

Para ver una lista de geovallas 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 geovallas.

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

4. Consulte las geovallas de la colección de geovallas en Geovallas

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 sirve 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 geovallas

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

Console

Para ver el estado de una geovalla 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 geovallas.

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

4. En Geovallas, podrá ver el estado de sus geovallas.

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 una 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 AWS CLI para obtener los detalles de la colección de geocercas. ExampleCollection

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

Eliminar geovallas

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

Console

Para eliminar una geovalla 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 geovallas.

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

4. En Geovallas, seleccione la geovalla de destino.

5. Seleccione Eliminar geovalla.

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 AWS CLI comando para eliminar las geocercas de la colección de geocercas. ExampleCollection

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