Evalúa las posiciones de los dispositivos comparándolas con las geovallas en Amazon Location - Amazon Location Service

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Evalúa las posiciones de los dispositivos comparándolas con las geovallas en Amazon Location

Hay dos formas de evaluar las posiciones frente a las geocercas para generar eventos de geocercas:

Además, puede pronosticar los eventos de geocerca entrantes para un dispositivo que entre, salga o permanezca inactivo dentro de una geocerca. Utilice el para pronosticar eventos. ForecastGeofenceEventsAPI

Si también quiere rastrear el historial de ubicaciones de su dispositivo o mostrar las ubicaciones en un mapa, vincule el rastreador a una colección de geocercas. Como alternativa, es posible que no desee evaluar todas las actualizaciones de ubicación o que no tenga intención de almacenar los datos de ubicación en un recurso de rastreo. En cualquiera de estos casos, puede hacer una solicitud directa a la colección de geocercas y evaluar las posiciones de uno o más dispositivos comparándolas con sus geocercas.

La evaluación de las posiciones de los dispositivos con respecto a las geocercas genera eventos. Puede reaccionar ante estos eventos y enviarlos a otros AWS servicios. Para obtener más información sobre las acciones que puede realizar al recibir eventos de geocerca, consulte Reaccionar ante los eventos de Amazon Location Service con Amazon. EventBridge

Un evento de Amazon Location incluye los atributos de la actualización de posición del dispositivo que lo genera, como la hora, la posición, la precisión y los metadatos clave-valor, además de algunos atributos de la geocerca por la que se entra o se sale. Para obtener más información sobre los datos incluidos en un evento de geocercas, consulte Ejemplos de EventBridge eventos de Amazon para Amazon Location Service.

En los siguientes ejemplos se utiliza AWS CLI la ubicación de Amazon o AmazonAPIs.

API

Para evaluar las posiciones de los dispositivos con respecto a la posición de las geocercas utilizando la ubicación de Amazon APIs

Usa la BatchEvaluateGeofences operación desde Amazon Location GeofencesAPIs.

En el siguiente ejemplo, se utiliza una API solicitud para evaluar la posición del dispositivo ExampleDevice a una colección de geocercas asociada ExampleGeofenceCollection. Sustituya estos valores por su propia geocerca y 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

Para evaluar las posiciones de los dispositivos con respecto a la posición de las geocercas mediante comandos AWS CLI

Utilice el comando batch-evaluate-geofences.

En el siguiente ejemplo se utiliza una AWS CLI para evaluar la posición de ExampleDevice con respecto a una colección de geocercas asociada ExampleGeofenceCollection. Sustituya estos valores por su propia geocerca y 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 evaluación de las posiciones de los dispositivos con respecto a las geocercas genera eventos. Tradicionalmente, se puede reaccionar ante los eventos utilizando Amazon EventBridge, pero este proceso solo permite reaccionar ante los eventos después de que hayan ocurrido. Si necesita anticipar cuándo un dispositivo entra o sale de una geocerca, por ejemplo, si un dispositivo cruza una frontera y, en consecuencia, estará sujeto a una normativa diferente, puede utilizarla para ForecastGeofenceEventsAPIpredecir futuros eventos de geofence.

ForecastGeofenceEventsAPIUtiliza criterios como la proximidad time-to-breach, la velocidad y la posición del dispositivo para predecir eventos. APIVolverá a ForecastedBreachTime, que indica el tiempo estimado en que ocurrirá el evento de geocerca.

En el siguiente ejemplo, se utiliza la ubicación de AmazonAPIs.

API

Para pronosticar eventos de geocercas utilizando la ubicación de Amazon APIs

Usa la ForecastGeofenceEvents operación desde Amazon Location GeofencesAPIs.

En el siguiente ejemplo, se utiliza una API solicitud para pronosticar los eventos de geocerca para un ExampleDevice relativo a un ExampleGeofence. Sustituya estos valores por su propia geocerca y 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 }