

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Gerencie os recursos de coleta de geocercas
<a name="managing-geofence-collections"></a>

Gerencie suas coleções de cercas geográficas usando o console de localização da Amazon AWS CLI, o ou o Amazon Location. APIs

## Liste seus recursos de coleta de geocercas
<a name="viewing-geofence-collections"></a>

Você pode visualizar sua lista de coleta de cercas geográficas usando o console de localização da Amazon, o AWS CLI, ou o Amazon Location: APIs

------
#### [ Console ]

**Para ver uma lista de coleções de geocercas usando o console do Amazon Location**

1. Abra o console de localização da Amazon em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).

1. Escolha **Coleções de geocercas** no painel de navegação à esquerda.

1. Veja uma lista de suas coleções de geocercas em **Minhas coleções de geocercas**.

------
#### [ API ]

Use a `[ListGeofenceCollections](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofenceCollections.html)` operação da Amazon Location Geofences APIs. 

O exemplo a seguir é uma solicitação de API para obter uma lista de coleções de cercas geográficas na AWS conta. 

```
POST /geofencing/v0/list-collections
```

Este é um exemplo de resposta 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 ]

Use o comando `[list-geofence-collections](https://docs.aws.amazon.com/cli/latest/reference/location/list-geofence-collections.html)`.

O exemplo a seguir é AWS CLI para obter uma lista de coleções de cercas geográficas na AWS conta. 

```
aws location list-geofence-collections
```

------

## Obtenha detalhes da coleção de geocercas
<a name="get-geofence-collection-details"></a>

Você pode obter detalhes sobre qualquer recurso de coleta de cercas geográficas em sua AWS conta usando o console de localização da Amazon AWS CLI, o ou o Amazon Location: APIs

------
#### [ Console ]

**Para visualizar os detalhes de uma coleção de geocercas usando o console do Amazon Location**

1. Abra o console de localização da Amazon em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).

1. Escolha **Coleções de geocercas** no painel de navegação à esquerda.

1. Em **Minhas coleções de geocercas**, selecione o link do nome da coleção de geocercas de destino. 

------
#### [ API ]

Use a `[DescribeGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DescribeGeofenceCollection.html)` operação da Amazon Location Geofences APIs. 

O exemplo a seguir é uma solicitação de API para obter os detalhes da coleção de cercas geográficas para. *ExampleCollection*

```
GET /geofencing/v0/collections/ExampleCollection
```

Este é um exemplo de resposta 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 ]

Use o comando `[describe-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/describe-geofence-collection.html)`.

O exemplo a seguir é AWS CLI para obter os detalhes da coleção de cercas geográficas. *ExampleCollection*

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

------

## Excluir uma coleção de geocercas
<a name="delete-geofence-collection"></a>

Você pode excluir uma coleção de cercas geográficas da sua AWS conta usando o console de localização da Amazon AWS CLI, o ou o Amazon Location. APIs

------
#### [ Console ]

**Para excluir uma coleção de geocercas usando o console do Amazon Location**

**Atenção**  
Essa operação exclui o recurso permanentemente.

 

1. Abra o console de localização da Amazon em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).

1. Escolha **Coleções de geocercas** no painel de navegação à esquerda.

1. Em **Minha coleção de geocercas**, selecione a coleção de geocercas de destino.

1. Escolha **Excluir coleção de geocercas.**

------
#### [ API ]

Use a `[DeleteGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DeleteGeofenceCollection.html)` operação da Amazon Location APIs. 

O exemplo a seguir é uma solicitação de API para excluir a coleção de cercas geográficas. *ExampleCollection*

```
DELETE /geofencing/v0/collections/ExampleCollection
```

Este é um exemplo de resposta para `DeleteGeofenceCollection`:

```
HTTP/1.1 200
```

------
#### [ CLI ]

Use o comando `[delete-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/delete-geofence-collection.html)`.

O exemplo a seguir é um AWS CLI comando para excluir a coleção de cercas geográficas. *ExampleCollection*

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

------

## Listar geocercas armazenadas
<a name="viewing-geofences"></a>

Você pode listar cercas geográficas armazenadas em uma coleção de cercas geográficas especificada usando o console de localização da Amazon, o AWS CLI ou o Amazon Location. APIs

------
#### [ Console ]

**Para ver uma lista de geocercas usando o console do Amazon Location**

1. Abra o console de localização da Amazon em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).

1. Escolha **Coleções de geocercas** no painel de navegação à esquerda.

1. Em **Minha coleção de geocercas**, selecione o link do nome da coleção de geocercas de destino.

1. Veja geocercas na coleção de geocercas em **Geocercas**

------
#### [ API ]

Use a `[ListGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofences.html)` operação da Amazon Location Geofences APIs. 

O exemplo a seguir é uma solicitação de API para obter uma lista de cercas geográficas armazenadas na coleção de cercas geográficas. *ExampleCollection* 

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

Este é um exemplo de resposta 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 ]

Use o comando `[list-geofences](https://docs.aws.amazon.com/cli/latest/reference/location/list-geofences.html)`.

O exemplo a seguir é AWS CLI para obter uma lista de cercas geográficas armazenadas na coleção de cercas geográficas. *ExampleCollection* 

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

------

## Obter detalhes de uma geocerca
<a name="get-geofence-details"></a>

Você pode obter os detalhes de uma cerca geográfica específica, como hora de criação, hora de atualização, geometria e status, de uma coleção de cercas geográficas usando o console de localização da Amazon AWS CLI ou a localização da Amazon. APIs

------
#### [ Console ]

**Para visualizar o status de uma geocerca usando o console do Amazon Location**

1. Abra o console de localização da Amazon em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).

1. Escolha **Coleções de geocercas** no painel de navegação à esquerda.

1. Em **Minha coleção de geocercas**, selecione o link do nome da coleção de geocercas de destino.

1. Em **Geocercas**, você poderá ver o status de suas geocercas.

------
#### [ API ]

Use a `[GetGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GetGeofence.html)` operação da Amazon Location Geofences APIs. 

O exemplo a seguir é uma solicitação de API para obter os detalhes da cerca geográfica de uma coleção de cercas geográficas. *ExampleCollection*

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

Este é um exemplo de resposta 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 ]

Use o comando `[get-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/get-geofence.html)`.

O exemplo a seguir é AWS CLI para obter os detalhes da coleção de cercas geográficas. *ExampleCollection*

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

------

## Excluir geocercas
<a name="delete-geofence"></a>

Você pode excluir cercas geográficas de uma coleção de cercas geográficas usando o console de localização da Amazon, o AWS CLI ou o Amazon Location. APIs

------
#### [ Console ]

**Para excluir uma geocerca usando o console do Amazon Location**

**Atenção**  
Essa operação exclui o recurso permanentemente. 

 

1. Abra o console de localização da Amazon em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).

1. Escolha **Coleções de geocercas** no painel de navegação à esquerda.

1. Em **Minha coleção de geocercas**, selecione o link do nome da coleção de geocercas de destino.

1. Em **Geocercas**, selecione a geocerca de destino.

1. Escolha **Excluir geocerca**.

------
#### [ API ]

Use a `[BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html)` operação da Amazon Location Geofences APIs. 

O exemplo a seguir é uma solicitação de API para excluir cercas geográficas da coleção de cercas geográficas. *ExampleCollection*

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

{
   "GeofenceIds": [ "ExampleGeofence11" ]
}
```

Veja a seguir um exemplo de uma resposta bem-sucedida do `[BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html)`: 

```
HTTP/1.1 200
```

------
#### [ CLI ]

Use o comando `[batch-delete-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/batch-delete-geofence.html)`.

O exemplo a seguir é um AWS CLI comando para excluir cercas geográficas da coleção de cercas geográficas. *ExampleCollection*

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

------