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à.
# Geofence del servizio di Localizzazione Amazon
![\[Una panoramica di Amazon Location Service Geofences.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/geofences-overview.png)
Le risorse di raccolta Geofence ti consentono di archiviare e gestire geofence, confini virtuali su una mappa. È possibile valutare le posizioni rispetto a una risorsa di raccolta di geofence e ricevere notifiche quando l'aggiornamento della posizione supera il confine di uno qualsiasi dei geofence della raccolta.
**Geofence e raccolta di geofence**
Un geofence è una geometria circolare, poligonale o multipoligonale che definisce un confine virtuale su una mappa. Una raccolta di geofence contiene zero o più geofence. È in grado di monitorare i geofence emettendo `ENTER` ed `EXIT` eventi, quando richiesto, per valutare la posizione di un dispositivo rispetto ai geofence.
**Eventi Geofence**
Le posizioni che stai monitorando sono referenziate da un ID chiamato a. `DeviceId` Le posizioni sono denominate posizioni del dispositivo. Puoi inviare un elenco di posizioni dei dispositivi da valutare direttamente alla risorsa di raccolta geofence oppure puoi utilizzare un tracker. Per ulteriori informazioni sull'uso dei tracker, consulta. [Localizzatori Amazon Location Service](trackers.md)
Ricevi eventi (tramite Amazon EventBridge) solo quando un dispositivo entra o esce da un geofence, non per ogni cambio di posizione. Ciò significa che in genere riceverai eventi e dovrai rispondere ad essi molto meno frequentemente rispetto a ogni aggiornamento della posizione del dispositivo.
**Nota**
Per la prima valutazione della posizione di un determinato dispositivo`DeviceID`, si presume che in precedenza il dispositivo non si trovasse in alcun geofence. Quindi il primo aggiornamento genererà un `ENTER` evento, se all'interno di un geofence della raccolta, e nessun evento in caso contrario.
Per calcolare se un dispositivo è entrato o uscito da un geofence, Amazon Location Service deve mantenere lo stato della posizione precedente del dispositivo. Questo stato di posizione viene memorizzato per 30 giorni. Dopo 30 giorni senza un aggiornamento per un dispositivo, un nuovo aggiornamento della posizione verrà considerato come il primo aggiornamento della posizione.
## Casi d'uso per Amazon Location Service Geofences
Di seguito sono riportati alcuni usi comuni di Amazon Location Service Geofences.
**Migliora le operazioni di assistenza sul campo**
Tieni sotto controllo la tua forza lavoro mobile con il monitoraggio in tempo reale. Imposta recinti geografici attorno alle sedi dei clienti e alle aree di assistenza per ricevere avvisi quando il personale arriva e parte. Utilizza i dati sulla posizione per ottimizzare la pianificazione, inviare il tecnico disponibile più vicino e ridurre i tempi di risposta. Consentite ai vostri team sul campo (ad esempio quelli che si occupano di riparazioni idrauliche o HVAC) di lavorare in modo più efficiente, migliorando al contempo l'esperienza del cliente.
**Monitora e controlla le risorse critiche**
Utilizza Amazon Location Service per monitorare la posizione e lo stato in tempo reale delle tue preziose apparecchiature, dell'inventario e di altre risorse mobili. Configura geofence per ricevere avvisi su spostamenti o traslochi non autorizzati, migliorando la sicurezza e la conformità. Utilizza questa visibilità sulla posizione per migliorare l'utilizzo delle risorse, ottimizzare i programmi di manutenzione e garantire che le risorse critiche siano sempre prese in considerazione. Monitora sempre con precisione i macchinari pesanti, l'hardware IT o l'inventario di vendita al dettaglio, riduci le perdite e prendi decisioni operative più informate.
**Migliora la visibilità della catena di fornitura**
Sfrutta Amazon Location Service per tracciare spedizioni e consegne lungo l'intera catena di fornitura. Definisci recinti geografici attorno ai centri di distribuzione, ai negozi e ad altre strutture chiave per monitorare il movimento dell'inventario e degli asset. Utilizza i dati sulla posizione in tempo reale per migliorare la gestione dell'inventario, ottimizzare la pianificazione logistica e offrire un'esperienza cliente di livello superiore. Ottieni end-to-end visibilità sulle operazioni della catena di fornitura, identifica gli ostacoli e prendi decisioni basate sui dati che promuovono l'efficienza e la reattività.
**Rafforza la sicurezza e la protezione**
Il geofencing consente di impostare confini virtuali attorno ad aree sicure, zone con restrizioni e altri luoghi critici. Ricevi avvisi istantanei quando personale o risorse non autorizzati entrano o escono da questi geofence predefiniti. Sfrutta questo monitoraggio della posizione in tempo reale per migliorare la sicurezza sul posto di lavoro, scoraggiare le violazioni di domicilio e garantire la conformità normativa. Che tu gestisca un impianto di produzione, un cantiere o un campus aziendale, il geofencing ti consente di mantenere un controllo più stretto sugli accessi, migliorare la risposta agli incidenti e proteggere persone, proprietà e risorse.
**Marketing basato sulla posizione**
Sfrutta la potenza dei dati sulla posizione per potenziare le tue attività di geomarketing. Usa Amazon Location Service per stabilire confini virtuali attorno alle sedi, agli eventi e alle aree ad alto traffico dei concorrenti. Attiva annunci, offerte e notifiche personalizzati quando i clienti entrano in queste zone geofrecintate. Analizza i modelli di traffico pedonale per ottimizzare il posizionamento degli annunci e scoprire i siti migliori per nuove sedi commerciali. Monitora i movimenti dei clienti all'interno dei tuoi spazi geofrecintati per ottenere informazioni più approfondite sui comportamenti di navigazione e. path-to-purchase Combina il tracciamento della posizione in tempo reale con il geofencing di precisione per offrire un coinvolgimento contestuale e ipermirato che stimoli le vendite e la fidelizzazione nel mondo fisico.
# Concetti di geofence
Questa sezione descrive alcuni concetti comuni di geofence, inclusa la terminologia comune e come gestire i geofence.
## Terminologia del geofence di Amazon Location Service
Geofence
Un confine virtuale per un'area geografica su una mappa.
Collezione Geofence
Un gruppo di geofence in grado di emettere `Entry` ed `Exit` eventi, quando richiesto, per valutare la posizione di un dispositivo rispetto ai geofence che lo compongono.
Geometria dei geofence
Una forma geometrica o un insieme di forme che definiscono le aree da includere o escludere da un geofence. Una geometria di geofence può essere rappresentata come un, o. `Circle` `Polygon` `MultiPolygon`
A `Circle` è un punto con una distanza attorno ad esso. Usa un cerchio per ricevere una notifica se un dispositivo si trova entro una certa distanza da una posizione.
A `Polygon` è un elenco di anelli lineari che rappresentano la forma di un geofence. Questo elenco *deve* includere un anello esterno che rappresenti il perimetro esterno del geofence e può facoltativamente includere più anelli interni che rappresentano spazi poligonali all'interno del perimetro, che sono esclusi dall'area del geofence.
A è un elenco di elementi che rappresentano la forma di un `MultiPolygon` geofence. `Polygon` I `Polygon` componenti di una `MultiPolygon` geometria possono definire aree geografiche separate che sono considerate parte dello stesso geofence, perimetri di aree esterne più ampie con spazi interni più piccoli che sono esclusi dal geofence, o una combinazione di questi casi d'uso per formare confini di geofence complessi.
Per ulteriori informazioni sulla definizione delle geometrie di geofence, inclusi requisiti di sintassi, limitazioni ed esempi, consulta [GeofenceGeometry](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GeofenceGeometry.html)il riferimento alle API di Amazon Location *Service*.
# Inizia a usare Amazon Location Service Geofences
I geofence sono strumenti potenti per definire i confini geografici e attivare azioni basate sugli aggiornamenti della posizione. Questa guida illustra il processo di creazione e utilizzo delle risorse di raccolta di geofence in Amazon Location. Configurando geofence e valutando le posizioni rispetto ad esse, puoi monitorare i movimenti e generare eventi automatici, come notifiche quando un dispositivo entra o esce da un'area definita. Queste funzionalità sono ideali per applicazioni come il monitoraggio della flotta, le notifiche basate sulla posizione e altro ancora.
1. Crea una risorsa per la raccolta di geofence nel tuo account. AWS
1. Aggiungi geofence alla raccolta. Puoi utilizzare lo strumento di caricamento geofence sulla console Amazon Location o l'API Amazon Location Geofences. Per ulteriori informazioni sulle opzioni disponibili, consulta [Autenticazione con Amazon Location Service](access.md). Un geofence può essere definito come un, o. `Circle` `Polygon` `MultiPolygon` Usa un `Polygon` o `MultiPolygon` per determinare quando un dispositivo entra in un'area specifica. Utilizzate `Circle` a per determinare quando un dispositivo si trova entro una certa distanza (raggio) da un punto. Per ulteriori informazioni, consulta la terminologia del [geofence di Amazon Location Service](https://docs.aws.amazon.com/location/latest/developerguide/geofence-components.html#geofence-terminology).
1. Puoi iniziare a valutare le posizioni rispetto a tutti i tuoi geofence. Quando un aggiornamento della posizione supera i confini di uno o più geofence, la tua risorsa di raccolta di geofence emette uno dei seguenti tipi di eventi di geofence su Amazon: EventBridge
+ **INVIO**: viene generato un evento per ogni geofence in cui l'aggiornamento della posizione ne attraversa il confine entrando.
+ **USCITA**: viene generato un evento per ogni geofence in cui l'aggiornamento della posizione ne attraversa il confine uscendo.
Per ulteriori informazioni, consulta [Reagisci agli eventi di Amazon Location Service con Amazon EventBridge](location-events.md). Puoi anche integrare il monitoraggio utilizzando servizi come Amazon CloudWatch e AWS CloudTrail. Per ulteriori informazioni, consulta [Monitora con Amazon CloudWatch](cloudwatch.md) e [Monitora e accedi con AWS CloudTrail](cloudtrail.md).
Ad esempio, stai monitorando una flotta di camion e desideri ricevere una notifica quando un camion entra in una determinata area di uno dei tuoi magazzini. Crea un recinto geografico per l'area intorno a ciascun magazzino. Quando i camion ti inviano posizioni aggiornate, usa Amazon Location Service per valutare tali posizioni e vedere se un camion è entrato (o uscito) da una delle aree di geofence.
**Nota**
La fatturazione viene calcolata in base al numero di raccolte di geofence in base alle quali effettui la valutazione. La tua fattura non è influenzata dal numero di geofence presenti in ogni collezione. Poiché ogni raccolta di geofence può contenere fino a 50.000 geofence, potresti voler combinare i geofence in un numero inferiore di raccolte, ove possibile, per ridurre i costi delle valutazioni dei geofence. Gli eventi generati includeranno l'ID del singolo geofence della raccolta, nonché l'ID della raccolta.
# Come lavorare con Amazon Location Service Geofences
Questa sezione fornisce step-by-step indicazioni per lavorare con le attività relative al geofence in Amazon Location. Scopri come valutare le posizioni dei dispositivi rispetto ai geofence, rispondere agli eventi di geofence utilizzando Amazon e gestire efficacemente le tue EventBridge risorse di geofence. Questi tutorial sono progettati per aiutarti a implementare funzionalità chiave per tracciare e gestire con facilità gli eventi basati sulla posizione.
**Topics**
+ [Valuta le posizioni dei dispositivi rispetto ai geofence](evaluate-geofences.md)
+ [Reagisci agli eventi di Amazon Location Service con Amazon EventBridge](location-events.md)
+ [Gestisci le tue risorse di raccolta di geofence](managing-geofence-collections.md)
# Valuta le posizioni dei dispositivi rispetto ai geofence
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"}}]'
```
------
# Reagisci agli eventi di Amazon Location Service con Amazon EventBridge
Amazon EventBridge è un bus di eventi serverless che collega in modo efficiente le applicazioni tra loro utilizzando i dati di AWS servizi come Amazon Location. EventBridge riceve eventi da Amazon Location e indirizza i dati a destinazioni come AWS Lambda. Puoi impostare regole di routing per determinare dove inviare i dati per creare architetture applicative che reagiscono in tempo reale.
Per impostazione predefinita, vengono inviati solo gli eventi di geofence (`ENTER`e `EXIT` gli eventi, quando i dispositivi entrano o escono dalle aree geofenzionate). EventBridge Puoi anche abilitare tutti gli eventi di aggiornamento della posizione filtrati per una risorsa tracker. Per ulteriori informazioni, consulta [Abilita gli eventi di aggiornamento per un tracker](#enable-update-events).
Per ulteriori informazioni, consulta [Events and Event Patterns](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) *nella Amazon EventBridge User Guide*.
**Topics**
+ [Abilita gli eventi di aggiornamento per un tracker](#enable-update-events)
+ [Crea regole per eventi per Amazon Location](#create-event-rule)
+ [Esempi di EventBridge eventi Amazon per Amazon Location Service](#example-event)
## Abilita gli eventi di aggiornamento per un tracker
Per impostazione predefinita, Amazon Location invia solo eventi di geofence `ENTER` e `EXIT` geofence a. EventBridge Puoi abilitare tutti gli `UPDATE` eventi di posizione filtrati a cui inviare un tracker. EventBridge Puoi farlo quando [crei](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html) o [aggiorni](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_UpdateTracker.html) un tracker.
Ad esempio, per aggiornare un tracker esistente utilizzando il AWS CLI, puoi usare il seguente comando (usa il nome della tua risorsa tracker al posto di). *MyTracker*
```
aws location update-tracker --tracker-name MyTracker --event-bridge-enabled
```
Per disattivare gli eventi di posizione per un tracker, devi utilizzare l'API o la console Amazon Location Service.
## Crea regole per eventi per Amazon Location
Puoi creare [fino a 300 regole per bus di eventi EventBridge per](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-quota.html) configurare le azioni intraprese in risposta a un evento Amazon Location.
Ad esempio, puoi creare una regola per gli eventi di geofence in base alla quale verrà inviata una notifica push quando viene rilevato un telefono all'interno di un confine geofenzato.
**Per creare una regola per gli eventi di Amazon Location**
Utilizzando i seguenti valori, [crea una EventBridge regola](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-visual.html) basata sugli eventi di Amazon Location:
+ Per **Tipo di regola**, scegli **Regola con un modello di eventi**.
+ Nella casella **Schema di evento**, aggiungi lo schema seguente:
```
{
"source": ["aws.geo"],
"detail-type": ["Location Geofence Event"]
}
```
Per creare una regola per gli aggiornamenti della posizione del tracker, puoi invece utilizzare il seguente schema:
```
{
"source": ["aws.geo"],
"detail-type": ["Location Device Position Event"]
}
```
Facoltativamente, puoi specificare solo `ENTER` `EXIT` gli eventi aggiungendo un `detail` tag (se la tua regola riguarda gli aggiornamenti della posizione del tracker, ce n'è solo uno`EventType`, quindi non è necessario filtrarlo):
```
{
"source": ["aws.geo"],
"detail-type": ["Location Geofence Event"],
"detail": {
"EventType": ["ENTER"]
}
}
```
Opzionalmente, puoi anche filtrare in base alle proprietà della posizione o del geofence:
```
{
"source": ["aws.geo"],
"detail-type": ["Location Geofence Event"],
"detail": {
"EventType": ["ENTER"],
"GeofenceProperties": {
"Type": "LoadingDock"
},
"PositionProperties": {
"VehicleType": "Truck"
}
}
}
```
+ Per **gli obiettivi Select**, scegli l'azione da intraprendere quando si riceve un evento da Amazon Location Service.
Ad esempio, utilizza un argomento Amazon Simple Notification Service (SNS) per inviare un'e-mail o un messaggio di testo quando si verifica un evento. Per fare ciò, è necessario creare un argomento Amazon SNS utilizzando la console di Amazon SNS. Per ulteriori informazioni, consulta [Utilizzo di Amazon SNS per le notifiche degli utenti](https://docs.aws.amazon.com/sns/latest/dg/sns-user-notifications.html).
**avvertimento**
È buona norma confermare che la regola relativa all'evento sia stata applicata correttamente o che l'azione automatica potrebbe non essere avviata come previsto. Per verificare la regola dell'evento, avvia le condizioni per la regola dell'evento. Ad esempio, simula l'ingresso di un dispositivo in un'area geofrecintata.
Puoi anche acquisire tutti gli eventi da Amazon Location, semplicemente escludendo la `detail-type` sezione. Esempio:
```
{
"source": [
"aws.geo"
]
}
```
**Nota**
Lo stesso evento può essere organizzato più di una volta. Puoi utilizzare l'id dell'evento per deduplicare gli eventi che ricevi.
## Esempi di EventBridge eventi Amazon per Amazon Location Service
Di seguito è riportato un esempio di evento per l'accesso a un geofence avviato tramite chiamata. `BatchUpdateDevicePosition`
```
{
"version": "0",
"id": "aa11aa22-33a-4a4a-aaa5-example",
"detail-type": "Location Geofence Event",
"source": "aws.geo",
"account": "636103698109",
"time": "2020-11-10T23:43:37Z",
"region": "eu-west-1",
"resources": [
"arn:aws:geo:eu-west-1:0123456789101:geofence-collection/GeofenceEvents-GeofenceCollection_EXAMPLE",
"arn:aws:geo:eu-west-1:0123456789101:tracker/Tracker_EXAMPLE"
],
"detail": {
"EventType": "ENTER",
"GeofenceId": "polygon_14",
"DeviceId": "Device1-EXAMPLE",
"SampleTime": "2020-11-10T23:43:37.531Z",
"Position": [
-123.12390073297821,
49.23433613216247
],
"Accuracy": {
"Horizontal": 15.3
},
"GeofenceProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
},
"PositionProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
}
}
}
```
Di seguito è riportato un esempio di evento di uscita da un geofence avviato tramite chiamata. `BatchUpdateDevicePosition`
```
{
"version": "0",
"id": "aa11aa22-33a-4a4a-aaa5-example",
"detail-type": "Location Geofence Event",
"source": "aws.geo",
"account": "123456789012",
"time": "2020-11-10T23:41:44Z",
"region": "eu-west-1",
"resources": [
"arn:aws:geo:eu-west-1:0123456789101:geofence-collection/GeofenceEvents-GeofenceCollection_EXAMPLE",
"arn:aws:geo:eu-west-1:0123456789101:tracker/Tracker_EXAMPLE"
],
"detail": {
"EventType": "EXIT",
"GeofenceId": "polygon_10",
"DeviceId": "Device1-EXAMPLE",
"SampleTime": "2020-11-10T23:41:43.826Z",
"Position": [
-123.08569321875426,
49.23766166742559
],
"Accuracy": {
"Horizontal": 15.3
},
"GeofenceProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
},
"PositionProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
}
}
}
```
Di seguito è riportato un esempio di evento per l'aggiornamento di una posizione, avviato mediante una chiamata. `BatchUpdateDevicePosition`
```
{
"version": "0",
"id": "aa11aa22-33a-4a4a-aaa5-example",
"detail-type": "Location Device Position Event",
"source": "aws.geo",
"account": "123456789012",
"time": "2020-11-10T23:41:44Z",
"region": "eu-west-1",
"resources": [
"arn:aws:geo:eu-west-1:0123456789101:tracker/Tracker_EXAMPLE"
],
"detail": {
"EventType": "UPDATE",
"TrackerName": "tracker_2",
"DeviceId": "Device1-EXAMPLE",
"SampleTime": "2020-11-10T23:41:43.826Z",
"ReceivedTime": "2020-11-10T23:41:39.235Z",
"Position": [
-123.08569321875426,
49.23766166742559
],
"Accuracy": {
"Horizontal": 15.3
},
"PositionProperties": {
"ExampleKey1": "ExampleField1",
"ExampleKey2": "ExampleField2"
}
}
}
```
# Gestisci le tue risorse di raccolta di geofence
Gestisci le tue raccolte di geofence utilizzando la console Amazon Location AWS CLI, o Amazon Location. APIs
## Elenca le risorse della tua raccolta di geofence
Puoi visualizzare la tua lista di collezioni di geofence utilizzando la console Amazon Location AWS CLI, o Amazon Location: APIs
------
#### [ Console ]
**Per visualizzare un elenco di raccolte di geofence utilizzando la console Amazon Location**
1. Apri la console Amazon Location all'indirizzo [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Scegli le **collezioni Geofence** dal riquadro di navigazione a sinistra.
1. **Visualizza un elenco delle tue raccolte di geofence in Le mie collezioni di geofence.**
------
#### [ API ]
Usa l'`[ListGeofenceCollections](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofenceCollections.html)`operazione di Amazon Location Geofences APIs.
L'esempio seguente è una richiesta API per ottenere un elenco di raccolte di geofence nell'account. AWS
```
POST /geofencing/v0/list-collections
```
Di seguito è riportato un esempio di risposta per: `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 ]
Utilizza il comando `[list-geofence-collections](https://docs.aws.amazon.com/cli/latest/reference/location/list-geofence-collections.html)`.
L'esempio seguente serve AWS CLI per ottenere un elenco delle raccolte di geofence presenti nell' AWS account.
```
aws location list-geofence-collections
```
------
## Ottieni i dettagli della collezione di geofence
Puoi ottenere dettagli su qualsiasi risorsa di raccolta di geofence nel tuo AWS account utilizzando la console Amazon Location AWS CLI, o Amazon Location: APIs
------
#### [ Console ]
**Per visualizzare i dettagli di una raccolta di geofence utilizzando la console Amazon Location**
1. Apri la console Amazon Location all'indirizzo [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Scegli le **collezioni Geofence** dal riquadro di navigazione a sinistra.
1. In Le **mie collezioni di geofence**, seleziona il link del nome della raccolta di geofence di destinazione.
------
#### [ API ]
Usa l'`[DescribeGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DescribeGeofenceCollection.html)`operazione di Amazon Location Geofences APIs.
L'esempio seguente è una richiesta API per cui ottenere i dettagli della raccolta di geofence. *ExampleCollection*
```
GET /geofencing/v0/collections/ExampleCollection
```
Di seguito è riportato un esempio di risposta per: `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 ]
Utilizza il comando `[describe-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/describe-geofence-collection.html)`.
L'esempio seguente è un AWS CLI modo per ottenere i dettagli della raccolta di geofence. *ExampleCollection*
```
aws location describe-geofence-collection \
--collection-name "ExampleCollection"
```
------
## Eliminare una raccolta di geofence
Puoi eliminare una raccolta di geofence dal tuo AWS account utilizzando la console Amazon Location AWS CLI, o Amazon Location. APIs
------
#### [ Console ]
**Per eliminare una raccolta di geofence utilizzando la console Amazon Location**
**avvertimento**
Questa operazione elimina la risorsa in modo permanente.
1. Apri la console Amazon Location all'indirizzo [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Scegli le **collezioni Geofence** dal riquadro di navigazione a sinistra.
1. In **La mia collezione di geofence, seleziona la raccolta** di geofence di destinazione.
1. **Scegli Elimina la raccolta di geofence.**
------
#### [ API ]
Usa l'`[DeleteGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DeleteGeofenceCollection.html)`operazione dalla sede Amazon APIs.
L'esempio seguente è una richiesta API per eliminare la raccolta geofence. *ExampleCollection*
```
DELETE /geofencing/v0/collections/ExampleCollection
```
Di seguito è riportato un esempio di risposta per: `DeleteGeofenceCollection`
```
HTTP/1.1 200
```
------
#### [ CLI ]
Utilizza il comando `[delete-geofence-collection](https://docs.aws.amazon.com/cli/latest/reference/location/delete-geofence-collection.html)`.
L'esempio seguente è un AWS CLI comando per eliminare la raccolta geofence. *ExampleCollection*
```
aws location delete-geofence-collection \
--collection-name "ExampleCollection"
```
------
## Elenca i geofence memorizzati
Puoi elencare i geofence archiviati in una raccolta di geofence specificata utilizzando la console Amazon Location, AWS CLI o Amazon Location. APIs
------
#### [ Console ]
**Per visualizzare un elenco di geofence utilizzando la console Amazon Location**
1. Apri la console Amazon Location all'indirizzo [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Scegli le **collezioni Geofence** dal riquadro di navigazione a sinistra.
1. In **La mia collezione di geofence, seleziona il link del nome della collezione** di geofence di destinazione.
1. **Visualizza i geofence nella collezione di geofence in Geofences**
------
#### [ API ]
Usa l'`[ListGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofences.html)`operazione di Amazon Location Geofences APIs.
L'esempio seguente è una richiesta API per ottenere un elenco di geofence archiviati nella raccolta di geofence. *ExampleCollection*
```
POST /geofencing/v0/collections/ExampleCollection/list-geofences
```
Di seguito è riportato un esempio di risposta per: `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 ]
Utilizza il comando `[list-geofences](https://docs.aws.amazon.com/cli/latest/reference/location/list-geofences.html)`.
L'esempio seguente è un AWS CLI modo per ottenere un elenco di geofence archiviati nella collezione di geofence. *ExampleCollection*
```
aws location list-geofences \
--collection-name "ExampleCollection"
```
------
## Ottieni i dettagli del geofence
Puoi ottenere i dettagli di un geofence specifico, come l'ora di creazione, l'ora di aggiornamento, la geometria e lo stato, da una raccolta di geofence utilizzando la console Amazon Location AWS CLI o Amazon Location. APIs
------
#### [ Console ]
**Per visualizzare lo stato di un geofence utilizzando la console Amazon Location**
1. Apri la console Amazon Location all'indirizzo [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Scegli le **collezioni Geofence** dal riquadro di navigazione a sinistra.
1. In **La mia collezione di geofence, seleziona il link del nome della collezione** di geofence di destinazione.
1. In **Geofences**, potrai visualizzare lo stato dei tuoi geofence.
------
#### [ API ]
Usa l'`[GetGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GetGeofence.html)`operazione di Amazon Location Geofences APIs.
L'esempio seguente è una richiesta API per ottenere i dettagli del geofence da una raccolta di geofence. *ExampleCollection*
```
GET /geofencing/v0/collections/ExampleCollection/geofences/ExampleGeofence1
```
Di seguito è riportato un esempio di risposta per: `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 ]
Utilizza il comando `[get-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/get-geofence.html)`.
L'esempio seguente è un AWS CLI modo per ottenere i dettagli della raccolta di geofence. *ExampleCollection*
```
aws location get-geofence \
--collection-name "ExampleCollection" \
--geofence-id "ExampleGeofence1"
```
------
## Eliminare geofences
Puoi eliminare i geofence da una raccolta di geofence utilizzando la console Amazon Location, AWS CLI o Amazon Location. APIs
------
#### [ Console ]
**Per eliminare un geofence utilizzando la console Amazon Location**
**avvertimento**
Questa operazione elimina la risorsa in modo permanente.
1. Apri la console Amazon Location all'indirizzo [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home).
1. Scegli le **collezioni Geofence** dal riquadro di navigazione a sinistra.
1. In **La mia collezione di geofence, seleziona il link del nome della collezione** di geofence di destinazione.
1. In **Geofences, seleziona il geofence di destinazione.**
1. **Scegli Elimina geofence.**
------
#### [ API ]
Usa l'`[BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html)`operazione di Amazon Location Geofences APIs.
L'esempio seguente è una richiesta API per eliminare geofence dalla collezione geofence. *ExampleCollection*
```
POST /geofencing/v0/collections/ExampleCollection/delete-geofences
Content-type: application/json
{
"GeofenceIds": [ "ExampleGeofence11" ]
}
```
Di seguito è riportato un esempio di risposta riuscita per. `[BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html)`
```
HTTP/1.1 200
```
------
#### [ CLI ]
Utilizza il comando `[batch-delete-geofence](https://docs.aws.amazon.com/cli/latest/reference/location/batch-delete-geofence.html)`.
L'esempio seguente è un AWS CLI comando per eliminare i geofence dalla collezione geofence. *ExampleCollection*
```
aws location batch-delete-geofence \
--collection-name "ExampleCollection" \
--geofence-ids "ExampleGeofence11"
```
------
# Gestione dei costi e dell'utilizzo
Man mano che continui a conoscere Amazon Location Geofences, è importante capire come gestire la capacità del servizio, assicurarti di rispettare i limiti di utilizzo e ottenere i migliori risultati attraverso l'ottimizzazione delle quote e delle API. Applicando le migliori pratiche in termini di prestazioni e precisione, puoi personalizzare la tua applicazione per gestire in modo efficiente le query relative al luogo e massimizzare le tue richieste API.
**Topics**
+ [Prezzi Geofences](geofence-price.md)
+ [Quote e utilizzo dei geofences](geofence-quotas.md)
# Prezzi Geofences
Per informazioni sui prezzi per il tracciamento e il geofencing APIs, consulta la pagina [dei prezzi di Amazon Location Service](https://aws.amazon.com/location/pricing/).
**Valutazione della posizione**
È possibile utilizzarla `BatchEvaluateGeofences` per valutare le posizioni dei dispositivi rispetto alle geometrie di geofence di una determinata raccolta di geofence. Una richiesta valuterà fino a dieci posizioni dei dispositivi rispetto a tutti i geofence in un'unica raccolta di geofence. Il prezzo si basa sul numero di posizioni dei dispositivi nelle richieste API. Il prezzo unitario per posizione del dispositivo valutato si basa sul volume di utilizzo mensile totale. Consulta la [pagina dei prezzi di Amazon Location Service](https://aws.amazon.com/location/pricing/) per dettagli sul prezzo unitario e sui livelli di volume.
Puoi ottimizzare i costi di valutazione della posizione configurando la frequenza di aggiornamento della posizione del dispositivo (nota anche come frequenza di ping) dai tuoi dispositivi di tracciamento e sfruttando la funzionalità di filtro sui Tracker per valutare solo gli aggiornamenti di posizione pertinenti.
**Gestione e archiviazione di Geofence**
Puoi utilizzare`GetGeofence`, `PutGeofence``BatchPutGeofence`, e gestire i tuoi `BatchDeleteGeofence` geofence in una raccolta di geofence. Il prezzo di questi APIs si basa sul numero di geofence presenti nelle richieste API.
Lo spazio di archiviazione per i geofence verrà addebitato mensilmente (solo per i geofence archiviati per più di un mese). Puoi anche gestire la tua collezione Geofence utilizzando quanto segue APIs:`CreateGeofenceCollection`,,,, `DeleteGeofenceCollection` e. `DescribeGeofenceCollection` `ListGeofenceCollections` `UpdateGeofenceCollection` `ListGeofences` Il prezzo di questi APIs si basa sul numero di richieste API.
**Geofence Event Forecast**
È possibile `ForecastGeofenceEvents` utilizzarlo per prevedere gli eventi di geofence futuri che potrebbero verificarsi entro un orizzonte temporale specificato se un dispositivo continua a muoversi alla velocità attuale. Il prezzo si basa sul numero di richieste API.
# Quote e utilizzo dei geofences
Questo argomento fornisce un riepilogo dei limiti di velocità e delle quote per Amazon Location Service Geofences.
**Nota**
Se hai bisogno di una quota più alta, puoi utilizzare la console Service Quotas per [richiedere aumenti delle quote per le quote](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) regolabili. Quando richiedi un aumento della quota, seleziona la regione in cui desideri aumentare la quota, poiché la maggior parte delle quote è specifica della regione. AWS Puoi richiedere fino al doppio del limite predefinito per ciascuna API.
Per le richieste che superano il doppio del limite predefinito, la richiesta invierà un ticket di assistenza. Puoi anche connetterti al tuo team di supporto premium. Non sono previsti costi diretti per le richieste di aumento delle quote, ma livelli di utilizzo più elevati possono comportare un aumento dei costi di servizio in base alle risorse aggiuntive consumate. Per ulteriori informazioni, consulta [Gestisci le quote con Service Quotas](manage-quotas.md).
Le Service Quotas sono il numero massimo di risorse che puoi avere a disposizione per AWS account e AWS regione. Amazon Location Service rifiuta le richieste aggiuntive che superano la quota di servizio.
## Resources
| Nome API | Predefinita | Limite massimo regolabile |
| --- | --- | --- |
| Risorse di raccolta per account | 1500 | 3000 Se hai bisogno di qualcosa di più, [richiedi un aumento della quota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o contatta il team di supporto. |
| Geofence per collezione | 50000 | Contatta il team di supporto. |
## CRUD API
**Nota**
Se hai bisogno di un limite più alto per uno di questi APIs, [richiedi un aumento della quota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o contatta il team di supporto.
| Nome API | Predefinita | Limite massimo regolabile |
| --- | --- | --- |
| [CreateGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_CreateGeofenceCollection.html) | 10 | 20 |
| [DeleteGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DeleteGeofenceCollection.html) | 10 | 20 |
| [DescribeGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_DescribeGeofenceCollection.html) | 10 | 20 |
| [ListGeofenceCollections](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofenceCollections.html) | 10 | 20 |
| [UpdateGeofenceCollection](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_UpdateGeofenceCollection.html) | 10 | 20 |
## Data API (API dati).
**Nota**
Se hai bisogno di un limite più alto per uno di questi APIs, [richiedi un aumento della quota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o contatta il team di supporto.
| Nome API | Predefinita | Limite massimo regolabile |
| --- | --- | --- |
| [BatchEvaluateGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchEvaluateGeofences.html) | 50 | 100 |
| [PutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_PutGeofence.html) | 50 | 100 |
| [BatchPutGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchPutGeofence.html) | 50 | 100 |
| [ListGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_ListGeofences.html) | 50 | 100 |
| [GetGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GetGeofence.html) | 50 | 100 |
| [BatchDeleteGeofence](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchDeleteGeofence.html) | 50 | 100 |
## Altri limiti di utilizzo