Valuta le posizioni dei dispositivi rispetto ai geofence in Amazon Location - Servizio di posizione Amazon

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 in Amazon Location

Esistono due modi per valutare le posizioni rispetto ai geofence per generare eventi di geofence:

Inoltre, è possibile prevedere gli eventi di geofence in entrata per un dispositivo che entra, esce o rimane inattivo all'interno di un geofence. Utilizza il per prevedere gli eventi. ForecastGeofenceEventsAPI

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

I seguenti esempi utilizzano la AWS CLI, o la posizione AmazonAPIs.

API

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

Usa l'BatchEvaluateGeofencesoperazione di Amazon Location GeofencesAPIs.

L'esempio seguente utilizza una API richiesta per valutare la posizione del dispositivo 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.

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"}}]'

La valutazione delle posizioni dei dispositivi rispetto ai geofence genera eventi. Tradizionalmente è possibile reagire agli eventi utilizzando Amazon EventBridge, ma questo processo consente di reagire agli eventi solo dopo che si sono verificati. Se hai bisogno di anticipare quando un dispositivo entra o esce da un geofence, ad esempio se un dispositivo sta attraversando un confine e di conseguenza sarà soggetto a normative diverse, puoi utilizzarlo per ForecastGeofenceEventsAPIprevedere eventi di geofence futuri.

ForecastGeofenceEventsAPIUtilizza criteri quali il dispositivo, la prossimità time-to-breach, la velocità e la posizione per prevedere gli eventi. APIVerrà restituito un ForecastedBreachTime, che segnala l'ora stimata in cui si verificherà l'evento di geofence.

L'esempio seguente utilizza Amazon LocationAPIs.

API

Per prevedere gli eventi di geofence utilizzando Amazon Location APIs

Usa l' ForecastGeofenceEventsoperazione di Amazon Location GeofencesAPIs.

L'esempio seguente utilizza una API richiesta per prevedere gli eventi di geofence per un ExampleDevice relativo a un ExampleGeofence. Sostituisci questi valori con il tuo geofence e il tuo dispositivo. IDs

POST /geofencing/v0/collections/CollectionName/forecast-geofence-events HTTP/1.1 Content-type: application/json { "DeviceState": { "Position": [ number ], "Speed": number }, "DistanceUnit": "string", "MaxResults": number, "NextToken": "string", "SpeedUnit": "string", "TimeHorizonMinutes": number }