Evalúe las posiciones de los dispositivos comparándolas con las geocercas

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

• Puede vincular los Rastreadores y las Colecciones de geocercas. Para obtener más información, consulte la sección: Vincular un rastreador a una colección de geocercas.

• Puede realizar una solicitud directa al recurso de recopilación de geocercas para evaluar una o más posiciones mediante la API. BatchEvaluateGeofences

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

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.

Los siguientes ejemplos utilizan las AWS CLI, o las API de ubicación de Amazon.

API

Para evaluar las posiciones de los dispositivos frente a la posición de las geocercas mediante las API de Amazon Location

Utilice la operación BatchEvaluateGeofences desde las API de Amazon Location Geofences.

En el siguiente ejemplo, se utiliza una solicitud de API para evaluar la posición del dispositivo ExampleDeviceen una colección de geovallas asociada. ExampleGeofenceCollection Sustituya estos valores por sus propios identificadores de geocercas y dispositivos.

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 un conjunto de geocercas asociado con ExampleDevicerespecto a él. ExampleGeofenceCollection Sustituya estos valores por sus propios identificadores de geocercas y dispositivos.

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 le 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 utilizar la ForecastGeofenceEventsAPI para predecir eventos geográficos futuros.

La ForecastGeofenceEventsAPI utiliza criterios como la proximidad time-to-breach, la velocidad y la posición del dispositivo para predecir eventos. La API devolverá un ForecastedBreachTime, que indica el tiempo estimado en que se producirá el evento de geocerca.

En el siguiente ejemplo, se utilizan las API de ubicación de Amazon.

API

Para pronosticar eventos de geocercas mediante las API de ubicación de Amazon

Utilice la operación ForecastGeofenceEvents desde las API de Amazon Location Geofences.

En el siguiente ejemplo, se utiliza una solicitud de API para pronosticar los eventos de geofence de un pariente con respecto a un ExampleDevice. ExampleGeofence Sustituya estos valores por sus propios identificadores de geocercas y dispositivos.

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
}