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. # Crear un rastreador Cree un recurso de rastreador para almacenar y procesar las actualizaciones de posición de sus dispositivos. Puedes usar la consola de Amazon Location Service AWS CLI, o Amazon Location APIs. Cada actualización de posición almacenada en los recursos de su rastreador puede incluir una medida de la precisión de la posición y hasta tres campos de metadatos sobre la posición o el dispositivo que desee almacenar. Los metadatos se almacenan como pares clave-valor y pueden almacenar información como la velocidad, la dirección, la presión de los neumáticos o la temperatura del motor. Los rastreadores filtran las actualizaciones de posición a medida que se reciben. Esto reduce el ruido visual en las rutas de los dispositivos (lo que se denomina *fluctuación*) y reduce el número de eventos de entrada y salida falsos de la geocerca. Esto también ayuda a administrar los costos al reducir la cantidad de evaluaciones de geocercas iniciadas. Los rastreadores ofrecen tres opciones de filtrado de posición para ayudar a gestionar los costos y reducir las interrupciones en las actualizaciones de ubicación. + **Basado en la precisión:** *utilícelo con cualquier dispositivo que proporcione una medición de la precisión. La mayoría de los dispositivos móviles proporcionan esta información.* La precisión de cada medición de posición se ve afectada por muchos factores ambientales, como la recepción de los satélites GPS, el paisaje y la proximidad de dispositivos Wi-Fi y Bluetooth. La mayoría de los dispositivos, incluidos la mayoría de los dispositivos móviles, pueden proporcionar una estimación de la precisión de la medición junto con la medición. Mediante el filtrado `AccuracyBased`, Amazon Location ignora las actualizaciones de ubicación si el dispositivo se ha movido menos de la precisión medida. Por ejemplo, si dos actualizaciones consecutivas de un dispositivo tienen un rango de precisión de 5 m y 10 m, Amazon Location ignora la segunda actualización si el dispositivo se ha movido menos de 15 m. Amazon Location no evalúa las actualizaciones ignoradas comparándolas con las geocercas ni las almacena. Si no se proporciona la precisión, se trata como cero y la medición se considera perfectamente precisa. **nota** También puede utilizar un filtrado basado en la precisión para eliminar todos los filtros. Si selecciona un filtrado basado en la precisión, pero sobrescribe todos los datos de precisión a cero u omite la precisión por completo, Amazon Location no filtrará ninguna actualización. + **Basado en la distancia**: *utilícelo cuando sus dispositivos no proporcionen una medición precisa, pero aun así desee aprovechar las ventajas del filtrado para reducir las fluctuaciones y gestionar los costos*. El filtrado `DistanceBased` ignora las actualizaciones de ubicación en las que los dispositivos se han movido menos de 30 m (98,4 pies). Cuando utiliza el filtrado de posición `DistanceBased`, Amazon Location no evalúa estas actualizaciones ignoradas comparándolas con las geocercas ni las almacena. La precisión de la mayoría de los dispositivos móviles, incluida la precisión media de los dispositivos iOS y Android, está dentro de los 15 m. En la mayoría de las aplicaciones, el filtrado `DistanceBased` puede reducir el efecto de las imprecisiones de ubicación al mostrar la trayectoria del dispositivo en un mapa, y el efecto rebote de varios eventos consecutivos de entrada y salida cuando los dispositivos se encuentran cerca del borde de una geocerca. También puede ayudar a reducir el coste de la aplicación, ya que realiza menos llamadas para evaluar las geocercas asociadas o recuperar la posición de los dispositivos. + **Basado en el tiempo**: (predeterminado) *úselo cuando sus dispositivos envíen actualizaciones de posición con mucha frecuencia (más de una vez cada 30 segundos) y desee realizar evaluaciones de la geocerca prácticamente en tiempo real sin almacenar todas las actualizaciones.*Durante el filtrado `TimeBased`, las actualizaciones de ubicación se evalúan con las recopilaciones de geocercas asociadas, pero no se almacenan todas las actualizaciones de ubicación. Si la frecuencia de actualización es superior a 30 segundos, solo se almacenará una actualización cada 30 segundos por cada ID de dispositivo único. **nota** Tenga en cuenta los costos de su aplicación de rastreo a la hora de decidir el método de filtrado y la frecuencia de las actualizaciones de posición. Se le facturará por cada actualización de ubicación y una vez por la evaluación de la actualización de posición con respecto a cada colección de geocercas vinculadas. Por ejemplo, si utiliza un filtrado basado en el tiempo, si su rastreador está vinculado a dos colecciones de geocercas, cada actualización de posición contará como una solicitud de actualización de ubicación y dos evaluaciones de la colección de geocercas. Si informa de las actualizaciones de posición de sus dispositivos cada 5 segundos y utiliza un filtrado basado en el tiempo, se le facturarán 720 actualizaciones de ubicación y 1440 evaluaciones de geocercas por hora para cada dispositivo. La cantidad de geocercas de cada colección no afecta a su factura. Dado que cada colección de geocercas puede contener hasta 50 000 geocercas, tal vez desee combinar sus geocercas en un menor número de colecciones, siempre que sea posible, para reducir el costo de las evaluaciones de las geocercas. De forma predeterminada, recibirá EventBridge los eventos cada vez que un dispositivo rastreado entre o salga de una geocerca vinculada. Para obtener más información, consulte [Vincular un rastreador a una colección de geocercas](associate-consumer.md). Puede activar los eventos para todas las actualizaciones de posición filtradas de un recurso de rastreo. Para obtener más información, consulte [Habilitar los eventos de actualización para un rastreador](location-events.md#enable-update-events). **nota** Si deseas cifrar tus datos con tu propia clave gestionada por el AWS KMS cliente, la función de consultas a polígonos delimitadores estará desactivada de forma predeterminada. Esto se debe a que, al utilizar esta función de consultas de polígonos delimitadores, una representación de las posiciones de los dispositivos no se cifrará con la clave gestionada. AWS KMS Sin embargo, la posición exacta del dispositivo se sigue cifrando con la clave gestionada. Puede optar por activar la característica de consultas de polígonos delimitadores configurando el parámetro `KmsKeyEnableGeospatialQueries` en «verdadero» al crear o actualizar un rastreador. ------ #### [ Console ] **Para crear un rastreador mediante la consola de Amazon Location** 1. Abre la consola de Amazon Location Service en [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. En el panel de navegación izquierdo, elija **Rastreadores**. 1. Seleccione **Crear rastreador**. 1. Cumplimente los siguientes campos: + ****Nombre****: escriba un nombre único. Por ejemplo, *ExampleTracker*. 100 caracteres como máximo. Entre las entradas válidas se incluyen caracteres alfanuméricos, guiones, puntos y guiones bajos. + ****Descripción****: escriba una descripción opcional. 1. En **Filtrado de posición**, elija la opción que mejor se adapte a la forma en que piensa utilizar el recurso de rastreo. Si no configura el **Filtrado de posición**, el ajuste predeterminado es `TimeBased`. Para obtener más información, consulte [Rastreadores de Amazon Location Service](trackers.md) en esta guía y `[PositionFiltering](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html#location-WaypointTracking_CreateTracker-request-PositionFiltering)` en la referencia de la API de Amazon Location Service Trackers. 1. (Opcional) En **Etiquetas**, escriba una **clave** y un **valor** de etiqueta. Esto añade una etiqueta a su nueva colección de geocercas. Para obtener más información, consulte [Cómo utilizar etiquetas](manage-resources.md#manage-resources_how-to). 1. (Opcional) En **Cifrado de claves gestionadas por el cliente**, puede optar por **agregar una clave gestionada por el cliente**. Esto añade una clave simétrica gestionada por el cliente que usted crea, posee y administra mediante el cifrado de AWS propiedad predeterminada. Para obtener más información, consulte [Cifrado de datos en reposo](encryption-at-rest.md). 1. (Opcional) En **KmsKeyEnableGeospatialQueries**, puede optar por habilitar las consultas **geoespaciales**. Esto le permite utilizar la función de consultas de polígonos delimitadores y, al mismo tiempo, cifrar sus datos con una clave gestionada por el KMS del cliente AWS . **nota** Al utilizar la función de consultas de polígonos delimitadores, no se cifra una representación de las posiciones de los dispositivos con la clave gestionada. AWS KMS Sin embargo, la posición exacta del dispositivo se sigue cifrando con la clave gestionada. 1. (Opcional) En la **EventBridge configuración**, puede optar por habilitar los EventBridge eventos para las actualizaciones de posición filtradas. Esto enviará un evento cada vez que una actualización de posición de un dispositivo de este rastreador cumpla con la evaluación del filtrado de posición. 1. Seleccione **Crear rastreador**. ------ #### [ API ] **Para crear un rastreador mediante la ubicación de Amazon APIs** Usa la `[CreateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html)` operación de Amazon Location Trackers. APIs En el siguiente ejemplo, se utiliza una solicitud de API para crear un rastreador llamado*ExampleTracker*. El recurso de seguimiento está asociado a una [AWS KMS clave administrada por el cliente para cifrar los datos del cliente](encryption-at-rest.md) y no [permite la entrada de actualizaciones de posición](location-events.md#enable-update-events). EventBridge ``` POST /tracking/v0/trackers Content-type: application/json { "TrackerName": "ExampleTracker", "Description": "string", "KmsKeyEnableGeospatialQueries": false, "EventBridgeEnabled": false, "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "PositionFiltering": "AccuracyBased", "Tags": { "string" : "string" } } ``` **Crear un rastreador con la opción `KmsKeyEnableGeospatialQueries` activada** El siguiente ejemplo tiene el parámetro `KmsKeyEnableGeospatialQueries` establecido en «verdadero». Esto le permite utilizar la función de consultas de polígonos delimitadores y, al mismo tiempo, cifrar los datos con una clave gestionada por el cliente. AWS KMS Para obtener información sobre el uso de la característica Consultas de polígonos delimitadores, consulte [Enumerar las posiciones de sus dispositivos](list-device-positions.md) **nota** Al utilizar la función de consultas de polígonos delimitadores, no se cifra una representación de las posiciones de los dispositivos con la clave gestionada. AWS KMS Sin embargo, la posición exacta del dispositivo se sigue cifrando con la clave gestionada. ``` POST /tracking/v0/trackers Content-type: application/json { "TrackerName": "ExampleTracker", "Description": "string", "KmsKeyEnableGeospatialQueries": true, "EventBridgeEnabled": false, "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "PositionFiltering": "AccuracyBased", "Tags": { "string" : "string" } } ``` ------ #### [ AWS CLI ] **Para crear un rastreador mediante comandos de AWS CLI ** Utilice el comando `[create-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/create-tracker.html)`. En el siguiente ejemplo, se utiliza AWS CLI para crear un rastreador llamado. *ExampleTracker* El recurso de seguimiento está asociado a una [AWS KMS clave gestionada por el cliente para cifrar los datos del cliente](encryption-at-rest.md) y no [permite la entrada de actualizaciones de posición](location-events.md#enable-update-events). EventBridge ``` aws location \ create-tracker \ --tracker-name "ExampleTracker" \ --position-filtering "AccuracyBased" \ --event-bridge-enabled false \ --kms-key-enable-geospatial-queries false \ --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab" ``` **Crear un rastreador con la opción `KmsKeyEnableGeospatialQueries` activada** El siguiente ejemplo tiene el parámetro `KmsKeyEnableGeospatialQueries` establecido en «verdadero». Esto le permite utilizar la función de consultas de polígonos delimitadores y, al mismo tiempo, cifrar los datos con una clave gestionada por el cliente. AWS KMS Para obtener información sobre el uso de la característica Consultas de polígonos delimitadores, consulte [Enumerar las posiciones de sus dispositivos](list-device-positions.md) **nota** Al utilizar la función de consultas de polígonos delimitadores, no se cifra una representación de las posiciones de los dispositivos con la clave gestionada. AWS KMS Sin embargo, la posición exacta del dispositivo se sigue cifrando con la clave gestionada. ``` aws location \ create-tracker \ --tracker-name "ExampleTracker" \ --position-filtering "AccuracyBased" \ --event-bridge-enabled false \ --kms-key-enable-geospatial-queries true \ --kms-key-id "1234abcd-12ab-34cd-56ef-1234567890ab" ``` ------ **nota** La facturación depende del uso. Puede incurrir en cargos por el uso de otros servicios de AWS . Para obtener más información, consulte los [precios de Amazon Location Service](https://aws.amazon.com/location/pricing/). Puede editar la **descripción**, el **filtrado de posición** y la **EventBridge configuración** una vez creado el rastreador seleccionando **Editar** rastreador.