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ú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](associate-consumer.md). + Puede hacer una solicitud directa al recurso de colección de geocercas para evaluar una o más posiciones. 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](https://docs.aws.amazon.com/location/latest/developerguide/location-events.html). 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](location-events.md#example-event). En los siguientes ejemplos se utiliza AWS CLI la ubicación de Amazon o Amazon APIs. ------ #### [ 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](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchEvaluateGeofences.html)` operación desde Amazon Location Geofences APIs. En el siguiente ejemplo, se utiliza una solicitud de API para evaluar la posición del dispositivo en relación con una colección *ExampleDevice* 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](https://docs.aws.amazon.com/cli/latest/reference/location/batch-evaluate-geofences.html)`. En el siguiente ejemplo, se utiliza una AWS CLI para evaluar la posición de un conjunto de geocercas asociado con *ExampleDevice* respecto a él. *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"}}]' ``` ------