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à.

# Valuta le posizioni dei dispositivi rispetto ai geofence
<a name="evaluate-geofences"></a>

Esistono due modi per valutare le posizioni rispetto ai geofence per generare eventi di geofence: 
+ Puoi collegare Trackers e Geofence Collections. Per maggiori informazioni, consulta la sezione:. [Collega un tracker a una raccolta di geofence](associate-consumer.md)
+ Puoi fare una richiesta diretta alla risorsa di raccolta geofence per valutare una o più posizioni. 

Se desideri anche tenere traccia della cronologia delle posizioni del dispositivo o visualizzare le posizioni su una mappa, collega il tracker a una raccolta di geofence. In alternativa, potresti non voler valutare tutti gli aggiornamenti sulla posizione o non intendi archiviare i dati sulla posizione in una risorsa di localizzazione. In uno di questi casi, puoi fare una richiesta diretta alla raccolta di geofence e valutare la posizione di uno o più dispositivi rispetto ai geofence.

La valutazione delle posizioni dei dispositivi rispetto ai geofence genera eventi. È possibile reagire a questi eventi e indirizzarli ad altri servizi. AWS Per ulteriori informazioni sulle azioni che puoi intraprendere quando ricevi eventi di geofence, consulta [Reagire agli eventi di Amazon Location Service con](https://docs.aws.amazon.com/location/latest/developerguide/location-events.html) Amazon. EventBridge

Un evento Amazon Location include gli attributi dell'aggiornamento della posizione del dispositivo che lo genera, inclusi i metadati relativi a ora, posizione, precisione e valore-chiave, e alcuni attributi del geofence da cui si entra o si esce. Per ulteriori informazioni sui dati inclusi in un evento di geofence, consulta. [Esempi di EventBridge eventi Amazon per Amazon Location Service](location-events.md#example-event)

I seguenti esempi utilizzano la AWS CLI, o la posizione Amazon APIs.

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

**Per valutare le posizioni dei dispositivi rispetto alla posizione dei geofence utilizzando Amazon Location APIs**

Usa l'`[BatchEvaluateGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchEvaluateGeofences.html)`operazione di Amazon Location Geofences APIs. 

L'esempio seguente utilizza una richiesta API per valutare la posizione del dispositivo rispetto *ExampleDevice* a una raccolta di geofence associata. *ExampleGeofenceCollection* Sostituisci questi valori con il tuo geofence e il tuo dispositivo. IDs

```
POST /geofencing/v0/collections/ExampleGeofenceCollection/positions HTTP/1.1
Content-type: application/json

{
   "DevicePositionUpdates": [ 
      { 
         "DeviceId": "ExampleDevice",
         "Position": [-123.123, 47.123],
         "SampleTime": "2021-11-30T21:47:25.149Z",
         "Accuracy": {
            "Horizontal": 10.30
         },
         "PositionProperties": {
            "field1": "value1",
            "field2": "value2"
         }
      }
   ]
}
```

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

**Per valutare le posizioni dei dispositivi rispetto alla posizione dei geofence utilizzando i comandi AWS CLI **

Utilizza il comando `[batch-evaluate-geofences](https://docs.aws.amazon.com/cli/latest/reference/location/batch-evaluate-geofences.html)`. 

L'esempio seguente utilizza an AWS CLI per valutare la posizione di *ExampleDevice* rispetto a una raccolta di geofence associata. *ExampleGeofenceCollection* Sostituisci questi valori con il tuo geofence e il tuo dispositivo. IDs

```
aws location \
    batch-evaluate-geofences \
        --collection-name ExampleGeofenceCollection \
        --device-position-updates '[{"DeviceId":"ExampleDevice","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z","Accuracy":{"Horizontal":10.30},"PositionProperties":{"field1":"value1","field2":"value2"}}]'
```

------