Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Aggiungi geofence con Amazon Location
I geofence contengono punti e vertici che formano un confine chiuso, che definisce un'area di interesse. Le collezioni Geofence archiviano e gestiscono uno o più geofence.
[Le raccolte di geofence di Amazon Location archiviano le geofence definite utilizzando un formato di dati geospaziali standard chiamato GeoJSON (RFC 7946).](https://geojson.org/) Puoi utilizzare strumenti, come [geojson.io](http://geojson.io/), gratuitamente per disegnare graficamente i tuoi geofence e salvare il file GeoJSON di output.
**Nota**
Amazon Location non supporta i poligoni in senso orario (usa l'ordine di avvolgimento in senso antiorario come richiesto dalla [RFC 7946 §3.1.6) e le geofence che attraversano l'antimeridiano (la linea di longitudine di 180°](https://www.rfc-editor.org/rfc/rfc7946#section-3.1.6)).
**Topics**
+ [Creazione di una collezione di recinzioni geografiche virtuali.](#create-geofence-collection)
+ [Disegna geofence](#draw-geofences)
+ [Aggiungi geofence poligonali](#draw-polygon-geofences)
+ [Aggiungi geofence circolari](#draw-circle-geofences)
## Creazione di una collezione di recinzioni geografiche virtuali.
Crea una raccolta di geofence per archiviare e gestire i geofence utilizzando la console Amazon Location, AWS CLI o le API di Amazon Location.
------
#### [ Console ]
1. Apri la console Amazon Location Service all'indirizzo [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Nel riquadro di navigazione a sinistra, scegli Collezioni **Geofence.**
1. Scegli **Crea collezione geofence**.
1. Compila le seguenti caselle:
+ ****Nome****: inserisci un nome univoco. Ad esempio, {{ExampleGeofenceCollection}}. Massimo 100 caratteri. Le voci valide includono caratteri alfanumerici, trattini, punti e caratteri di sottolineatura.
+ ****Descrizione****: inserisci una descrizione opzionale per differenziare le tue risorse.
1. In base a **EventBridge rule with CloudWatch as a target**, puoi creare una EventBridge regola opzionale per iniziare a [reagire agli eventi di geofence](location-events.md). Ciò consente ad Amazon Location di pubblicare eventi su Amazon CloudWatch Logs.
1. (Facoltativo) In **Tag**, immettere **Key (Chiave)** e **Value (Valore)** di un tag. Questo aggiunge un tag alla tua nuova collezione di geofence. Per ulteriori informazioni, consulta [Gestire le risorse con](manage-resources.md) i tag.
1. (Facoltativo) In **Crittografia a chiave gestita dal cliente**, puoi scegliere di **aggiungere una chiave gestita dal cliente**. In questo modo viene aggiunta una chiave simmetrica gestita dal cliente che puoi creare, possedere e gestire tramite la crittografia predefinita AWS di proprietà. Per ulteriori informazioni, consulta [Crittografia dei dati](encryption-at-rest.md) inattivi.
1. Scegli **Crea raccolta di geofence**.
------
#### [ API ]
Usa l'`[CreateGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_CreateGeofenceCollection.html)`operazione dalle API Amazon Location Geofences.
L'esempio seguente utilizza una richiesta API per creare una raccolta di geofence chiamata. {{ExampleGeofenceCollection}} La raccolta di geofence è associata a una [AWS KMS chiave gestita dal cliente per crittografare](encryption-at-rest.md) i dati dei clienti.
```
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 ]
Utilizza il comando `[create-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/create-geofence-collection.html)`.
L'esempio seguente utilizza AWS CLI per creare una raccolta di geofence chiamata. {{ExampleGeofenceCollection}} La raccolta di geofence è associata a una [AWS KMS chiave gestita dal cliente per crittografare](encryption-at-rest.md) i dati dei clienti.
```
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**
La fatturazione dipende dall'utilizzo. Potresti incorrere in commissioni per l'uso di altri servizi. AWS Per ulteriori informazioni, consulta i [prezzi di Amazon Location Service](https://aws.amazon.com/location/pricing/).
## Disegna geofence
Ora che hai creato la tua collezione di geofence, puoi definire i tuoi geofence. I geofence sono definiti come poligono o come cerchio. [Per disegnare un geofence poligonale puoi usare uno strumento di modifica GeoJSON, come geojson.io.](http://geojson.io/)
Per creare un geofence circolare, definisci il punto centrale utilizzando la latitudine e la longitudine della posizione e imposta il raggio in metri. Per ulteriori informazioni, consulta [Aggiungi geofence circolari](#draw-circle-geofences).
Utilizzando le API di Amazon Location Service, puoi anche aggiungere metadati al tuo geofence sotto forma di coppie chiave-valore. Questi possono essere utili per archiviare informazioni sul geofence, ad esempio il tipo, o altre informazioni specifiche dell'applicazione. Puoi utilizzare questi metadati quando. [Reagisci agli eventi di Amazon Location Service con Amazon EventBridge](location-events.md)
## Aggiungi geofence poligonali
I geofence poligonali utilizzano gli array di coordinate GeoJSON per definire un'area. Utilizzate questo formato quando è necessario tenere traccia delle entrate o delle uscite da un confine geografico di forma irregolare.
### Disegna geofence usando uno strumento GeoJSON
1. [Apri uno strumento di modifica GeoJSON, come geojson.io.](http://geojson.io/)
1. Scegli l'icona **Disegna un poligono e disegna la tua area di interesse**.
1. Scegli **Salva**, quindi scegli **GeoJSON** dal menu a discesa.
### Inserisci geofence GeoJSON in una raccolta di geofence
Puoi utilizzare il file GeoJSON risultante per caricare i tuoi geofence utilizzando la console Amazon Location Service, o AWS CLI le API Amazon Location.
------
#### [ Console ]
1. Apri la console Amazon Location Service all'indirizzo [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Nel riquadro di navigazione a sinistra, scegli Collezioni **Geofence.**
1. Dall'elenco delle **raccolte Geofence**, seleziona il link del nome per la raccolta di geofence di destinazione.
1. **In **Geofences, scegli Crea geofences**.**
1. Nella finestra **Aggiungi geofences**, trascina e rilascia il tuo GeoJSON nella finestra.
1. **Scegli Aggiungi geofence.**
------
#### [ API ]
Usa l'`[PutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_PutGeofence.html)`operazione dalle API Amazon Location Geofences.
L'esempio seguente utilizza una richiesta API per aggiungere un geofence con l'ID {{GEOFENCE-EXAMPLE1}} a una raccolta di geofence chiamata. {{ExampleGeofenceCollection}} Inoltre, specifica una proprietà dei metadati del geofence con la chiave e il valore. `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]
]
]
}
}
```
In alternativa, è possibile aggiungere più di un geofence utilizzando l'operazione. `[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 ]
Utilizza il comando `[put-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/put-geofence.html)`.
L'esempio seguente utilizza il AWS CLI per aggiungere un geofence a una raccolta di geofence chiamata. {{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]]]'
```
------
## Aggiungi geofence circolari
Per creare un geofence circolare, è necessario conoscere la latitudine e la longitudine del punto centrale e il raggio in metri. Utilizza i geofence circolari quando devi attivare eventi in base alla vicinanza a un punto specifico, come un negozio, un magazzino o un punto di riferimento. Puoi creare geofence circolari con la console Amazon Location, le API di Amazon Location o il. AWS CLI
------
#### [ Console ]
1. Apri la console Amazon Location Service all'indirizzo [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Nel riquadro di navigazione a sinistra, scegli Collezioni **Geofence.**
1. Dall'elenco delle **raccolte Geofence**, seleziona il link del nome per la raccolta di geofence di destinazione.
1. **In **Geofences, scegli Crea geofences**.**
1. ****Nella finestra **Aggiungi geofence**, scegli **Cerchio**, quindi inserisci la **latitudine centrale, la longitudine** e il raggio in metri.****
1. **Scegli Aggiungi geofence.**
------
#### [ API ]
Usa l'`[PutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_PutGeofence.html)`operazione dalle API Amazon Location Geofences.
L'esempio seguente utilizza una richiesta API per aggiungere un geofence con l'ID {{GEOFENCE-EXAMPLE2}} a una raccolta di geofence chiamata. {{ExampleGeofenceCollection}}
```
PUT /geofencing/v0/collections/{{ExampleGeofenceCollection}}/geofences/{{GEOFENCE-EXAMPLE2}}
Content-type: application/json
{
"Geometry": {
"Circle": {
"Center": [-5.716667, -15.933333],
"Radius": 50
}
}
}
```
------
#### [ AWS CLI ]
Utilizza il comando `[put-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/put-geofence.html)`.
L'esempio seguente utilizza il AWS CLI per aggiungere un geofence circolare a una raccolta di geofence chiamata. {{ExampleGeofenceCollection}}
```
aws location \
put-geofence \
--collection-name {{ExampleGeofenceCollection}} \
--geofence-id {{ExampleGeofenceCircle}} \
--geometry 'Circle={Center=[-5.716667, -15.933333], Radius=50}'
```
**Nota**
È inoltre possibile inserire JSON per geometrie complesse in un file separato, come nell'esempio seguente.
```
aws location \
put-geofence \
--collection-name {{ExampleGeofenceCollection}} \
--geofence-id {{ExampleGeofenceCircle}} \
--geometry file://circle.json
```
Dove `circle.json` contiene la geometria del cerchio.
```
{
"Circle": {
"Center": [-74.006975, 40.717127],
"Radius": 287.7897969218057
}
}
```
------