Collega un tracker a una raccolta di geofence

Ora che hai una raccolta di geofence e un tracker, puoi collegarli tra loro in modo che gli aggiornamenti di posizione vengano valutati automaticamente rispetto a tutti i geofence. Se non desideri valutare tutti gli aggiornamenti di posizione o, in alternativa, se non stai archiviando alcune delle tue posizioni in una risorsa di localizzazione, puoi valutare le posizioni dei dispositivi rispetto ai geofence su richiesta.

Quando le posizioni dei dispositivi vengono valutate rispetto ai geofence, vengono generati degli eventi. È possibile impostare un'azione per questi eventi. Per ulteriori informazioni sulle azioni che puoi impostare per gli eventi di geofence, consulta Reagire agli eventi di Amazon Location Service con Amazon. EventBridge

Un evento Amazon Location include gli attributi dell'aggiornamento della posizione del dispositivo che lo genera e alcuni attributi del geofence che viene inserito o uscito. Per ulteriori informazioni sui dati inclusi in un evento di geofence, consulta. Esempi di EventBridge eventi Amazon per Amazon Location Service

I seguenti esempi collegano una risorsa tracker a una raccolta di geofence utilizzando la console, o le AWS CLI API Amazon Location.

Console

Per collegare una risorsa tracker a una raccolta di geofence utilizzando la console Amazon Location Service

1. Apri la console Amazon Location Service all'indirizzo https://console.aws.amazon.com/location/.

2. Nel riquadro di navigazione a sinistra, scegli Trackers.

3. In Device tracker, seleziona il link del nome del tracker di destinazione.

4. In Collezioni Geofence collegate, scegli Collega collezione Geofence.

5. Nella finestra Linked Geofence Collection, seleziona una collezione di geofence dal menu a discesa.

6. Scegliere Link (Collegamento).

Dopo aver collegato la risorsa tracker, ad essa verrà assegnato uno stato Attivo.

API

Per collegare una risorsa tracker a una raccolta di geofence utilizzando le API di Amazon Location

Usa l'AsssociateTrackerConsumeroperazione dalle API di Amazon Location Trackers.

L'esempio seguente utilizza una richiesta API associata ExampleTrackera una raccolta di geofence utilizzando il relativo Amazon Resource Name (ARN).

POST /tracking/v0/trackers/ExampleTracker/consumers
Content-type: application/json

{
   "ConsumerArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection"
}

AWS CLI

Per collegare una risorsa tracker a una raccolta di geofence utilizzando i comandi AWS CLI

Utilizza il comando associate-tracker-consumer.

L'esempio seguente utilizza an AWS CLI per creare una raccolta di geofence chiamata. ExampleGeofenceCollection

aws location \
    associate-tracker-consumer \
        --consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection" \
        --tracker-name "ExampleTracker"