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á.
# Adicione cercas geográficas com a Amazon Location
As geocercas contêm pontos e vértices que formam um limite fechado, que define uma área de interesse. As coleções de geocercas armazenam e gerenciam uma ou várias geocercas.
[As coleções de geofence de localização da Amazon armazenam cercas geográficas definidas usando um formato de dados geoespaciais padrão chamado GeoJSON (RFC 7946).](https://geojson.org/) Você pode usar ferramentas, como o [geojson.io](http://geojson.io/), gratuitamente para desenhar suas geocercas graficamente e salvar o arquivo GeoJSON de saída.
**nota**
O Amazon Location não suporta polígonos no sentido horário (use a ordem de enrolamento no sentido anti-horário, conforme exigido pela [RFC 7946 §3.1.6](https://www.rfc-editor.org/rfc/rfc7946#section-3.1.6)) e cercas geográficas que cruzam o antimeridiano (a linha de longitude de 180°).
**Topics**
+ [Criar uma coleção de gepcercas](#create-geofence-collection)
+ [Desenhe geocercas](#draw-geofences)
+ [Adicionar cercas geográficas poligonais](#draw-polygon-geofences)
+ [Adicione geofences circulares](#draw-circle-geofences)
## Criar uma coleção de gepcercas
Crie uma coleção de cercas geográficas para armazenar e gerenciar cercas geográficas usando o console de localização da Amazon, o AWS CLI ou as APIs de localização da Amazon.
------
#### [ Console ]
1. Abra o console do Amazon Location Service em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. No painel de navegação à esquerda, selecione **Coleções de geocercas**.
1. Selecione **Criar coleção de geocercas**.
1. Preencha as seguintes caixas:
+ ****Nome****: insira um nome exclusivo. Por exemplo, .{{ExampleGeofenceCollection}} Máximo de 100 caracteres. Entradas válidas incluem caracteres alfanuméricos, hifens, pontos e sublinhados.
+ ****Descrição**** — Insira uma descrição opcional para diferenciar seus recursos.
1. Em **EventBridge regra com CloudWatch como destino, você pode criar uma** EventBridge regra opcional para começar a [reagir aos eventos de delimitação geográfica](location-events.md). Isso permite que o Amazon Location publique eventos no Amazon CloudWatch Logs.
1. (Opcional) Em **Tags**, insira uma tag **Chave** e **Valor**. Isso adiciona uma etiqueta à sua nova coleção de cercas geográficas. Para obter mais informações, consulte [Gerenciar recursos com tags](manage-resources.md).
1. (Opcional) Em **Criptografia de chave gerenciada pelo cliente**, você pode selecionar **Adicionar uma chave gerenciada pelo cliente**. Isso adiciona uma chave simétrica gerenciada pelo cliente criada e gerenciada por meio da criptografia de AWS propriedade padrão. Para obter mais informações, consulte [Criptografia de dados em repouso](encryption-at-rest.md).
1. Selecione **Criar coleção de geocercas**.
------
#### [ API ]
Use a operação `[CreateGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_CreateGeofenceCollection.html)` das APIs de geocercas do Amazon Location.
O exemplo a seguir usa uma solicitação de API para criar uma coleção de geocercas chamada {{ExampleGeofenceCollection}}. A coleção de cercas geográficas está associada a uma [AWS KMS chave gerenciada pelo cliente para criptografar os dados](encryption-at-rest.md) do 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 ]
Use o comando `[create-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/create-geofence-collection.html)`.
O exemplo a seguir usa o AWS CLI para criar uma coleção de geofence chamada. {{ExampleGeofenceCollection}} A coleção de cercas geográficas está associada a uma [AWS KMS chave gerenciada pelo cliente para criptografar os dados](encryption-at-rest.md) do 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**
O faturamento depende do seu uso. Você pode incorrer em taxas pelo uso de outros AWS serviços. Para obter mais informações, consulte os [preços do Amazon Location Service](https://aws.amazon.com/location/pricing/).
## Desenhe geocercas
Agora que você criou sua coleção de geocercas, você pode definir suas geocercas. As geocercas são definidas como um polígono ou como um círculo. Para desenhar uma geocerca poligonal, você pode usar uma ferramenta de edição GeoJSON, como o [geojson.io.](http://geojson.io/)
Para criar uma cerca geográfica circular, defina o ponto central usando a latitude e a longitude do local e defina o raio em metros. Para obter mais informações, consulte [Adicione geofences circulares](#draw-circle-geofences).
Usando as APIs do Amazon Location Service, você também pode adicionar metadados à sua cerca geográfica na forma de pares de valores-chave. Eles podem ser úteis para armazenar informações sobre a geocerca, como seu tipo ou outras informações específicas do seu aplicativo. Você pode usar esses metadados quando [Reaja aos eventos do Amazon Location Service com a Amazon EventBridge](location-events.md).
## Adicionar cercas geográficas poligonais
As cercas geográficas poligonais usam matrizes de coordenadas GeoJSON para definir uma área. Use esse formato quando precisar rastrear entradas ou saídas de um limite geográfico de formato irregular.
### Desenhe geocercas usando uma ferramenta GeoJSON
1. [Abra uma ferramenta de edição GeoJSON, como geojson.io.](http://geojson.io/)
1. Selecione o ícone **Desenhar um polígono** e desenhe sua área de interesse.
1. Selecione **Salvar** e, em seguida, escolha **GeoJSON** no menu suspenso.
### Coloque geocercas GeoJSON em uma coleção de geocercas
Você pode usar o arquivo GeoJSON resultante para carregar suas cercas geográficas usando o console do Amazon Location Service, AWS CLI o ou as APIs de localização da Amazon.
------
#### [ Console ]
1. Abra o console do Amazon Location Service em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. No painel de navegação à esquerda, selecione **Coleções de geocercas**.
1. Na lista de **Coleções de geocercas**, selecione o link do nome da coleção de geocercas de destino.
1. Em **Geocercas**, selecione **Criar geocercas**.
1. Na janela **Adicionar cercas geográficas**, arraste e solte seu GeoJSON na janela.
1. Selecione **Adicionar geocercas**.
------
#### [ API ]
Use a operação `[PutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_PutGeofence.html)` das APIs de geocercas do Amazon Location.
O exemplo a seguir usa uma solicitação de API para adicionar uma cerca geográfica com o ID a uma coleção de {{GEOFENCE-EXAMPLE1}} delimitação geográfica chamada. {{ExampleGeofenceCollection}} Ela também especifica uma propriedade de metadados de delimitação geográfica com a chave e o 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, você pode adicionar mais de uma geocerca usando a operação `[BatchPutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchPutGeofence.html)`.
```
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 ]
Use o comando `[put-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/put-geofence.html)`.
O exemplo a seguir usa o AWS CLI para adicionar uma cerca geográfica a uma coleção de cerca geográfica chamada. {{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]]]'
```
------
## Adicione geofences circulares
Para criar uma cerca geográfica circular, você deve conhecer a latitude e longitude do ponto central e o raio em metros. Use cercas geográficas circulares quando precisar acionar eventos com base na proximidade de um ponto específico, como uma loja, depósito ou ponto de referência. Você pode criar cercas geográficas circulares com o console de localização da Amazon, as APIs de localização da Amazon ou o. AWS CLI
------
#### [ Console ]
1. Abra o console do Amazon Location Service em [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. No painel de navegação à esquerda, selecione **Coleções de geocercas**.
1. Na lista de **Coleções de geocercas**, selecione o link do nome da coleção de geocercas de destino.
1. Em **Geocercas**, selecione **Criar geocercas**.
1. Na janela **Adicionar cercas geográficas**, escolha **Círculo** e insira o centro de **Latitude, **Longitude**** e **Raio** em metros.
1. Selecione **Adicionar geocercas**.
------
#### [ API ]
Use a operação `[PutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_PutGeofence.html)` das APIs de geocercas do Amazon Location.
O exemplo a seguir usa uma solicitação de API para adicionar uma cerca geográfica com o ID a uma coleção de {{GEOFENCE-EXAMPLE2}} delimitação geográfica chamada. {{ExampleGeofenceCollection}}
```
PUT /geofencing/v0/collections/{{ExampleGeofenceCollection}}/geofences/{{GEOFENCE-EXAMPLE2}}
Content-type: application/json
{
"Geometry": {
"Circle": {
"Center": [-5.716667, -15.933333],
"Radius": 50
}
}
}
```
------
#### [ AWS CLI ]
Use o comando `[put-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/put-geofence.html)`.
O exemplo a seguir usa o AWS CLI para adicionar uma cerca geográfica circular a uma coleção de cerca geográfica chamada. {{ExampleGeofenceCollection}}
```
aws location \
put-geofence \
--collection-name {{ExampleGeofenceCollection}} \
--geofence-id {{ExampleGeofenceCircle}} \
--geometry 'Circle={Center=[-5.716667, -15.933333], Radius=50}'
```
**nota**
Você também pode colocar JSON para geometria complexa em seu próprio arquivo, como no exemplo a seguir.
```
aws location \
put-geofence \
--collection-name {{ExampleGeofenceCollection}} \
--geofence-id {{ExampleGeofenceCircle}} \
--geometry file://circle.json
```
Onde `circle.json` contém a geometria do círculo.
```
{
"Circle": {
"Center": [-74.006975, 40.717127],
"Radius": 287.7897969218057
}
}
```
------