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. # Rastreadores de Amazon Location Service ![\[Este diagrama le muestra cómo crear y utilizar recursos de rastreadores.\]](http://docs.aws.amazon.com/es_es/location/latest/developerguide/images/illustration-trackers.PNG) **nota** El almacenamiento del rastreador se cifra automáticamente con las claves propias de AWS. Puede agregar otra capa de cifrado mediante las claves de KMS que administre, para garantizar que solo usted pueda acceder a sus datos. Para obtener más información, consulte [Cifrado de datos en reposo para Amazon Location Service](encryption-at-rest.md). Un rastreador almacena las actualizaciones de posición de un conjunto de dispositivos. El rastreador se puede utilizar para consultar la ubicación actual o el historial de ubicaciones de los dispositivos. Almacena las actualizaciones, pero reduce el espacio de almacenamiento y el ruido visual al filtrar las ubicaciones antes de almacenarlas. Cada actualización de posición almacenada en los recursos del 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. El filtrado y la consulta de la posición de los rastreadores son útiles por sí solos, pero los rastreadores son especialmente útiles cuando se combinan con geocercas. Puede vincular los rastreadores a uno o varios de sus recursos de recolección de geocercas, y las actualizaciones de posición se evalúan automáticamente comparándolas con las geocercas de esas colecciones. El uso adecuado del filtrado también puede reducir considerablemente los costos de las evaluaciones de las geocercas. 1. En primer lugar, cree un recurso de seguimiento en su cuenta AWS. 1. A continuación, decida cómo vas a enviar las actualizaciones de ubicación a los recursos de su rastreador. Use los [SDK de AWS](dev-sdks.md) para integrar las capacidades de rastreo en sus aplicaciones móviles. Como alternativa, puede utilizar MQTT siguiendo las instrucciones paso a paso sobre el [seguimiento mediante MQTT](tracking-using-mqtt.md). 1. Ahora puede usar su recurso de rastreo para registrar el historial de ubicaciones y visualizarlo en un mapa. 1. También puede vincular su recurso de rastreo a una o más colecciones de geocercas para que cada actualización de posición que se envíe a su recurso de rastreo se evalúe automáticamente comparándola con todas las geocercas de todas las colecciones de geocercas vinculadas. Puede vincular el recurso en la página de detalles de recursos del rastreador de la consola de ubicaciones de Amazon o mediante la API de Amazon Location Trackers. 1. A continuación, puede integrar la supervisión mediante servicios como Amazon CloudWatch y AWS CloudTrail. Para obtener más información, consulte [Monitoriza con Amazon CloudWatch](cloudwatch.md) y [Supervise e inicie sesión con AWS CloudTrail](cloudtrail.md). ## Características + **Filtrado de posición**: los rastreadores pueden filtrar automáticamente las posiciones que se les envían. Existen varios motivos por los que es posible que desee filtrar algunas de las actualizaciones de ubicación de su dispositivo. Si tiene un sistema que solo envía informes cada minuto más o menos, quizás quiera filtrar los dispositivos por tiempo, almacenando y evaluando las posiciones solo cada 30 segundos. Incluso si supervisa con más frecuencia, es posible que desee filtrar las actualizaciones de posición para eliminar los ruidos inherentes asociados al hardware del GPS e informes de posiciones. Su precisión no es perfecta al 100 %, por lo que incluso un dispositivo estacionario parece moverse ligeramente. A bajas velocidades, esta *fluctuación* provoca confusión visual y puede provocar entradas y salidas falsas si el dispositivo se encuentra cerca del borde de una geocerca. El filtrado de posición funciona a medida que un rastreador recibe las actualizaciones de posición, lo que reduce el ruido visual en las rutas del dispositivo (fluctuación), reduce el número de eventos de entrada y salida falsos de la geocerca y ayuda a gestionar los costos al reducir el número de actualizaciones de posición almacenadas y de las evaluaciones de geocerca activadas. 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 GPS y 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 los dispositivos wifi 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 precisión, se trata como cero y la medición se considera perfectamente precisa, y no se aplicará ningún filtro a las actualizaciones. **nota** 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 los dispositivos no proporcionen una medición precisa, pero aun así desee aprovechar las ventajas del filtrado para reducir las fluctuaciones y administrar los costos.* El filtrado de `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. El filtrado basado en la distancia es útil si quiere filtrar, pero su dispositivo no proporciona mediciones de precisión o si desea filtrar un mayor número de actualizaciones que con el filtrado basado en la precisión. + **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. El filtrado basado en el tiempo resulta especialmente útil si desea almacenar menos posiciones, pero desea que cada actualización de posición se evalúe comparándola con los conjuntos de geocercas asociados. **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. ## Casos de uso para rastreadores de Amazon Location Service A continuación, se muestran algunos usos habituales de los rastreadores de Amazon Location Service. **Uso de rastreadores con geocercas** Los rastreadores proporcionan una funcionalidad adicional cuando se combinan con geocercas. Para evaluar automáticamente las ubicaciones de los rastreadores, asocie un rastreador a una colección de geocercas, ya sea a través de la consola de Amazon Location o de la API. Cada vez que el rastreador reciba una ubicación actualizada, esa ubicación se evaluará comparándola con cada geocerca de la colección y se generarán los eventos `ENTER` y `EXIT` correspondientes en Amazon EventBridge. También puede aplicar filtros al rastreador y, en función del filtrado, reducir los costos de las evaluaciones de la geocerca evaluando únicamente las actualizaciones de ubicación significativas. Si asocia el rastreador a un conjunto de geocercas después de que ya haya recibido algunas actualizaciones de posición, la primera actualización de posición tras la asociación se considerará una actualización inicial para las evaluaciones de geocercas. Si se encuentra dentro de una geocerca, recibirá un evento `ENTER`. Si no está dentro de ninguna geocerca, no recibirá ningún evento `EXIT`, independientemente del estado anterior. **Mejora de las operaciones del servicio de campo** Manténgase al tanto de su fuerza laboral móvil con el seguimiento en tiempo real. Establezca geocercas alrededor de los sitios de los clientes y las áreas de servicio para recibir alertas cuando el personal llegue y se vaya. Utilice los datos de ubicación para optimizar la programación, enviar al técnico disponible más cercano y reducir los tiempos de respuesta. Capacite a los equipos de campo (como su empresa de reparación de fontanería o HVAC) para que trabajen de manera más eficiente y, al mismo tiempo, mejore la experiencia del cliente. **Supervisión y control de los activos críticos** Utilice Amazon Location Service para rastrear la ubicación y el estado en tiempo real de sus valiosos equipos, inventario y otros activos móviles. Configure geocercas para recibir alertas sobre movimientos o retiradas no autorizados, lo que mejorará la seguridad y el cumplimiento. Utilice esta visibilidad de la ubicación para mejorar la utilización de los activos, optimizar los programas de mantenimiento y asegurarse de que los recursos críticos estén contabilizados en todo momento. Supervise siempre con precisión la maquinaria pesada, el hardware de TI o el inventario minorista, reduzca las pérdidas y tome decisiones operativas más fundamentadas. **Mejora de la visibilidad de la cadena de suministro** Aproveche Amazon Location Service para realizar un seguimiento de los envíos y las entregas en toda la cadena de suministro. Defina geocercas alrededor de los centros de distribución, las tiendas y otras instalaciones clave para supervisar el movimiento del inventario y los activos. Utilice datos de ubicación en tiempo real para mejorar la administración del inventario, optimizar la planificación logística y ofrecer una experiencia de cliente superior. Obtenga una visibilidad integral de las operaciones de la cadena de suministro, identifique los cuellos de botella y tome decisiones basadas en datos que impulsen la eficiencia y la capacidad de respuesta. **Marketing basado en la ubicación** Libere el poder de los datos de ubicación para potenciar sus esfuerzos de geomarketing. Utilice Amazon Location Service para establecer límites virtuales en torno a las ubicaciones, los eventos y las áreas de alto tráfico de la competencia. Desencadene anuncios, ofertas y notificaciones personalizados cuando los clientes ingresen en estas zonas geocercadas. Analice los patrones de tráfico peatonal para optimizar las ubicaciones de los anuncios y descubrir los sitios principales para nuevas ubicaciones comerciales. Supervise los movimientos de los clientes dentro de sus propios espacios geocercados para obtener información más detallada sobre los comportamientos de navegación y la ruta de compra. Combine el seguimiento de la ubicación en tiempo real con una geolocalización precisa para ofrecer una interacción contextual y muy segmentada que impulse las ventas y la fidelización en el mundo físico. # Conceptos de rastreadores En esta sección se detallan los conceptos comunes de los rastreadores. ## Terminología común de rastreadores de Amazon Location Service **Recurso de seguimiento** Un recurso AWS que recibe actualizaciones de ubicación de los dispositivos. El recurso de seguimiento proporciona soporte para consultas de ubicación, como la ubicación actual e histórica del dispositivo. Al vincular un recurso de rastreo a una colección de geocercas, se evalúan automáticamente las actualizaciones de ubicación comparándolas con todas las geocercas de la colección de geocercas vinculada. **Datos de posición rastreados** Un recurso de seguimiento almacena información sobre sus dispositivos a lo largo del tiempo. La información incluye una serie de actualizaciones de posición, en las que cada actualización incluye la ubicación, la hora y los metadatos opcionales. Los metadatos pueden incluir la precisión de una posición y hasta tres pares de valores clave para ayudarte a rastrear la información clave sobre cada posición, como la velocidad, la dirección, la presión de los neumáticos, el combustible restante o la temperatura del motor del vehículo que estás rastreando. Los rastreadores mantienen el historial de ubicación del dispositivo durante 30 días. **Filtrado de posición** El filtrado de posiciones puede ayudarle a controlar los costos y mejorar la calidad de su aplicación de rastreo, ya que filtra las actualizaciones de posición que no proporcionan información valiosa antes de almacenarlas o evaluarlas comparándolas con las geocercas. Puede elegir entre los filtros `AccuracyBased`, `DistanceBased` o `TimeBased`. De forma predeterminada, el filtrado de posición está establecido en `TimeBased`. Puede configurar el filtrado de posición al crear o actualizar los recursos del rastreador. **Formato de marca de tiempo RFC 3339 ** Los ratreadores de Amazon Location Service utilizan el formato [RFC 3339](https://tools.ietf.org/html/rfc3339), que sigue el formato [8601 de la Organización Internacional de Normalización (ISO)](https://www.iso.org/iso-8601-date-and-time-format.html) para las fechas y las horas. El formato es “YYYY-MM-DDThh:mm:ss.sssZ\$100:00”: + `YYYY-MM-DD`: representa el formato de fecha. + `T`: indica que seguirán los valores de hora. + `hh:mm:ss.sss`: representa la hora en formato de 24 horas. + `Z`: indica que la zona horaria utilizada es UTC, que puede ir seguida de desviaciones con respecto a la zona horaria UTC. + `+00:00`: indica de forma opcional las desviaciones de la zona horaria UTC. Por ejemplo, \$1 01:00 indica UTC \$1 1 hora. **Ejemplo** Para el 2 de julio de 2020, a las 12:15:20 de la tarde, con un ajuste de 1 hora adicional a la zona horaria UTC. ``` 2020-07-02T12:15:20.000Z+01:00 ``` # Introducción a rastreadores de Amazon Location Service Esta sección proporciona una guía completa para crear y usar rastreadores con Amazon Location. Los rastreadores le permiten almacenar, procesar y evaluar las posiciones de los dispositivos, además de filtrar las actualizaciones de ubicación para reducir el ruido y administrar los costos. Con opciones avanzadas de filtrado de posición, compatibilidad con recopilaciones de geocercas vinculadas e integración con servicios de AWS como EventBridge e IoT Core, los rastreadores permiten aplicaciones precisas de seguimiento y geocercado en tiempo real adaptadas a sus necesidades específicas. **Topics** + [Crear un rastreador](start-create-tracker.md) + [Autenticación de sus solicitudes](tracking-identity-pool.md) + [Actualizar el rastreador con la posición del dispositivo](send-location-updates.md) + [Obtener el historial de ubicaciones de un dispositivo a partir de un rastreador](get-location-history.md) + [Enumerar las posiciones de sus dispositivos](list-device-positions.md) # 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. # Autenticación de sus solicitudes Una vez que haya creado un recurso de rastreo y esté listo para empezar a evaluar las posiciones de los dispositivos comparándolas con las geocercas, elija cómo autenticaría sus solicitudes: + Para explorar las formas en las que puede acceder a los servicios, consulte [Autenticación con Amazon Location Service](access.md). + Si desea publicar las posiciones de los dispositivos con solicitudes no autenticadas, puede utilizar Amazon Cognito. **Ejemplo** En el siguiente ejemplo, se muestra el uso de un grupo de identidades de Amazon Cognito para la autorización, mediante [AWS JavaScript SDK v3](https://aws.amazon.com/sdk-for-javascript/) y el [Web](how-to-auth-helper.md#loc-sdk-auth-web) de Amazon Location. ``` import { LocationClient, BatchUpdateDevicePositionCommand } from "@aws-sdk/client-location"; import { withIdentityPoolId } from "@aws/amazon-location-utilities-auth-helper"; // Unauthenticated identity pool you created const identityPoolId = "us-east-1:1234abcd-5678-9012-abcd-sample-id"; // Create an authentication helper instance using credentials from Cognito const authHelper = await withIdentityPoolId(identityPoolId); const client = new LocationClient({ region: "us-east-1", // The region containing both the identity pool and tracker resource ...authHelper.getLocationClientConfig(), // Provides configuration required to make requests to Amazon Location }); const input = { TrackerName: "ExampleTracker", Updates: [ { DeviceId: "ExampleDevice-1", Position: [-123.4567, 45.6789], SampleTime: new Date("2020-10-02T19:09:07.327Z"), }, { DeviceId: "ExampleDevice-2", Position: [-123.123, 45.123], SampleTime: new Date("2020-10-02T19:10:32Z"), }, ], }; const command = new BatchUpdateDevicePositionCommand(input); // Send device position updates const response = await client.send(command); ``` # Actualizar el rastreador con la posición del dispositivo Para rastrear sus dispositivos, puede publicar actualizaciones de la posición del dispositivo en su rastreador. Más adelante, puede recuperar estas posiciones de los dispositivos o el historial de posiciones del dispositivo desde su recurso de rastreador. Cada actualización de posición debe incluir el ID del dispositivo, una marca de tiempo y una posición. Si lo desea, puede incluir otros metadatos, como la precisión y hasta 3 pares clave-valor para su propio uso. Si su rastreador está asociado a una o más colecciones de geocercas, las actualizaciones se evaluarán en función de esas geocercas (siguiendo las reglas de filtrado que especificó para el rastreador). Si un dispositivo entra en una zona geovallada (moviéndose desde el interior de la zona hacia el exterior o viceversa), recibirás eventos en su interior. EventBridge Estos eventos `ENTER` o `EXIT` incluyen los detalles de la actualización de la posición, como el ID del dispositivo, la marca de tiempo y cualquier metadato asociado. **nota** Para obtener más información sobre cómo filtrar posiciones, consulte [Crear un rastreador](start-create-tracker.md). Para obtener más información sobre los eventos de geocercas, consulte [Reaccione a los eventos de Amazon Location Service con Amazon EventBridge](location-events.md). Use uno de estos métodos para enviar las actualizaciones del dispositivo: + [Envía actualizaciones de MQTT](tracking-using-mqtt.md) a un recurso de AWS IoT Core y vincúlalo a tu recurso de seguimiento. + Envía actualizaciones de ubicación mediante la API de Amazon Location Trackers, mediante la AWS CLI ubicación APIs de Amazon o Amazon. Puedes usar el [AWS SDKs](dev-sdks.md)para llamar APIs desde tu aplicación iOS o Android. ------ #### [ API ] **Para enviar una actualización de posición a través de la sucursal de Amazon APIs** Usa la `[BatchUpdateDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchUpdateDevicePosition.html)` operación de Amazon Location Trackers. APIs En el siguiente ejemplo, se utiliza una solicitud de API para publicar una actualización de la posición del dispositivo en un rastreador*ExampleTracker*. *ExampleDevice* ``` POST /tracking/v0/trackers/ExampleTracker/positions Content-type: application/json { "Updates": [ { "DeviceId": "1", "Position": [ -123.12245146162303, 49.27521118043802 ], "SampleTime": "2022-10-24T19:09:07.327Z", "PositionProperties": { "name" : "device1" }, "Accuracy": { "Horizontal": 10 } }, { "DeviceId": "2", "Position": [ -123.1230104928471, 49.27752402723152 ], "SampleTime": "2022-10-02T19:09:07.327Z" }, { "DeviceId": "3", "Position": [ -123.12325592118916, 49.27340530543111 ], "SampleTime": "2022-10-02T19:09:07.327Z" }, { "DeviceId": "4", "Position": [ -123.11958813096311, 49.27774641063121 ], "SampleTime": "2022-10-02T19:09:07.327Z" }, { "DeviceId": "5", "Position": [ -123.1277418058896, 49.2765989015285 ], "SampleTime": "2022-10-02T19:09:07.327Z" }, { "DeviceId": "6", "Position": [ -123.11964267059481, 49.274188155916534 ], "SampleTime": "2022-10-02T19:09:07.327Z" } ] } ``` ------ #### [ AWS CLI ] **Para enviar una actualización de posición mediante comandos de AWS CLI ** Utilice el comando `[batch-update-device-position](https://docs.aws.amazon.com/cli/latest/reference/location/batch-update-device-position.html)`. En el siguiente ejemplo, se utiliza una AWS CLI para publicar una actualización de la posición del dispositivo *ExampleDevice-2* para *ExampleDevice-1* y en un rastreador*ExampleTracker*. ``` aws location batch-update-device-position \ --tracker-name ExampleTracker \ --updates '[{"DeviceId":"ExampleDevice-1","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z"},{"DeviceId":"ExampleDevice-2","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z","Accuracy":{"Horizontal":10.30},"PositionProperties":{"field1":"value1","field2":"value2"}}]' ``` ------ # Obtener el historial de ubicaciones de un dispositivo a partir de un rastreador Su recurso de rastreador de ubicaciones de Amazon conserva el historial de ubicaciones de todos tus dispositivos rastreados durante un período de 30 días. Puedes recuperar el historial de ubicaciones del dispositivo, incluidos todos los metadatos asociados, desde su recurso de rastreador. En los siguientes ejemplos se utiliza AWS CLI la ubicación de Amazon o Amazon APIs. ------ #### [ API ] **Para obtener el historial de ubicaciones del dispositivo desde un rastreador utilizando Amazon Location APIs** Usa la `[GetDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePositionHistory.html)` operación de Amazon Location Trackers. APIs En el siguiente ejemplo, se utiliza una solicitud de URI a la API para obtener el historial de ubicaciones del dispositivo *ExampleDevice* a *ExampleTracker* partir de un rastreador llamado que comienza desde `19:05:07` (inclusive) y termina en `19:20:07` (exclusivo) el`2020–10–02`. ``` POST /tracking/v0/trackers/ExampleTracker/devices/ExampleDevice/list-positions Content-type: application/json { "StartTimeInclusive": "2020-10-02T19:05:07.327Z", "EndTimeExclusive": "2020-10-02T19:20:07.327Z" } ``` ------ #### [ AWS CLI ] **Para obtener el historial de ubicaciones del dispositivo desde un rastreador mediante AWS CLI comandos** Utilice el comando `[get-device-position-history](https://docs.aws.amazon.com/cli/latest/reference/location/get-device-position-history.html)`. En el siguiente ejemplo, se utiliza un AWS CLI para obtener el historial de ubicaciones del dispositivo *ExampleDevice* desde un rastreador llamado que *ExampleTracker* comienza desde `19:05:07` (inclusive) y termina en `19:20:07` (exclusivo)`2020–10–02`. ``` aws location \ get-device-position-history \ --device-id "ExampleDevice" \ --start-time-inclusive "2020-10-02T19:05:07.327Z" \ --end-time-exclusive "2020-10-02T19:20:07.327Z" \ --tracker-name "ExampleTracker" ``` ------ # Enumerar las posiciones de sus dispositivos Puedes ver una lista de las posiciones de los dispositivos de un rastreador utilizando la AWS CLI ubicación de Amazon o la ubicación APIs de Amazon con la ListDevicePositions API. Cuando llamas a la ListDevicePositions API, se muestra una lista de las últimas posiciones de todos los dispositivos asociados a un rastreador determinado. De forma predeterminada, esta API devuelve 100 de las últimas posiciones de los dispositivos por página de resultados de un rastreador determinado. Para devolver solo los dispositivos de una región específica, use el parámetro `FilterGeometry` para crear una consulta de polígonos delimitadores. De esta forma, cuando llames ListDevicePositions, solo se devolverán los dispositivos que se encuentren dentro del polígono. **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, una representación de las posiciones de sus dispositivos no se cifrará con su AWS KMS clave gestionada. Sin embargo, la posición exacta del dispositivo sigue cifrada con su clave gestionada. Puede optar por activar la característica Consultas de polígonos delimitadores. Esto se hace configurando el parámetro `KmsKeyEnableGeospatialQueries` en «verdadero» al crear o actualizar un rastreador. ------ #### [ API ] Usa la `[ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html)` operación de Amazon Location Trackers. APIs El siguiente ejemplo es una solicitud de API para obtener una lista de las posiciones de los dispositivos en un área poligonal mediante el parámetro opcional `[FilterGeometry](https://docs.aws.amazon.com/)`. El ejemplo devuelve 3 ubicaciones de dispositivos presentes en el área definida por la matriz `Polygon`. ``` POST /tracking/v0/trackers/TrackerName/list-positions HTTP/1.1 Content-type: application/json { "FilterGeometry": { "Polygon": [ [ [ -123.12003339442259, 49.27425121147397 ], [ -123.1176984148229, 49.277063620879744 ], [ -123.12389509145294, 49.277954183760926 ], [ -123.12755921328647, 49.27554025235713 ], [ -123.12330236586217, 49.27211836076236 ], [ -123.12003339442259, 49.27425121147397 ] ] ] }, "MaxResults": 3, "NextToken": "1234-5678-9012" } ``` A continuación se muestra un ejemplo de respuesta para `[ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html)`: ``` { "Entries": [ { "DeviceId": "1", "SampleTime": "2022-10-24T19:09:07.327Z", "Position": [ -123.12245146162303, 49.27521118043802 ], "Accuracy": { "Horizontal": 10 }, "PositionProperties": { "name": "device1" } }, { "DeviceId": "3", "SampleTime": "2022-10-02T19:09:07.327Z", "Position": [ -123.12325592118916, 49.27340530543111 ] }, { "DeviceId": "2", "SampleTime": "2022-10-02T19:09:07.327Z", "Position": [ -123.1230104928471, 49.27752402723152 ] } ], "NextToken": "1234-5678-9012" } ``` ------ #### [ CLI ] Utilice el comando `[list-trackers](https://docs.aws.amazon.com/cli/latest/reference/location/list-trackers.html)`. El siguiente ejemplo es AWS CLI para obtener una lista de dispositivos en un área poligonal. ``` aws location list-device-positions TODO: add arguments add props for filter geo ``` ------ # Cómo funcionan los rastreadores de Amazon Location Service En esta sección se proporcionan instrucciones para utilizar con rastreadores de Amazon Location. Obtenga información sobre cómo verificar las posiciones de los dispositivos, vincular los rastreadores a las recopilaciones de geocercas y rastrear las ubicaciones mediante AWS IoT y MQTT. Además, obtenga información sobre cómo administrar los rastreadores de forma eficaz para respaldar las aplicaciones basadas en la ubicación y garantizar un seguimiento preciso y en tiempo real. **Topics** + [Verificación de las posiciones de los dispositivos](verify-device-positions.md) + [Vincular un rastreador a una colección de geocercas](associate-consumer.md) + [Rastreo mediante AWS IoT y MQTT con Amazon Location Service](tracking-using-mqtt.md) + [Administración del seguimiento de Amazon Location Service](managing-trackers.md) # Verificación de las posiciones de los dispositivos Para comprobar la integridad de la posición de un dispositivo, utilice la [VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)API. Esta API devuelve información sobre la integridad de la posición del dispositivo mediante la evaluación de propiedades como la señal del móvil del dispositivo, el punto de acceso de la Wi-Fi, la dirección Ipv4 y si se está utilizando un proxy. ## Requisitos previos Antes de poder utilizar lo que aparece en la lista APIs para la verificación del dispositivo, asegúrate de cumplir con los siguientes requisitos: + Ha creado un rastreador para el dispositivo o los dispositivos que desea comprobar. Para obtener más información, consulte [Introducción a rastreadores de Amazon Location Service](start-tracking.md). En el siguiente ejemplo, se muestra una solicitud para la [VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)API de Amazon Location. ------ #### [ API ] **Para verificar las posiciones de los dispositivos mediante la ubicación de Amazon APIs** Utiliza la `[VerifyDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_VerifyDevicePosition.html)` operación del seguimiento de ubicaciones de Amazon APIs. En el siguiente ejemplo se muestra una solicitud de API para evaluar la integridad de la posición de un dispositivo. Sustituya estos valores por su propio dispositivo IDs. ``` POST /tracking/v0/trackers/TrackerName/positions/verify HTTP/1.1 Content-type: application/json { "DeviceState": { "Accuracy": { "Horizontal": number }, "CellSignals": { "LteCellDetails": [ { "CellId": number, "LocalId": { "Earfcn": number, "Pci": number }, "Mcc": number, "Mnc": number, "NetworkMeasurements": [ { "CellId": number, "Earfcn": number, "Pci": number, "Rsrp": number, "Rsrq": number } ], "NrCapable": boolean, "Rsrp": number, "Rsrq": number, "Tac": number, "TimingAdvance": number } ] }, "DeviceId": "ExampleDevice", "Ipv4Address": "string", "Position": [ number ], "SampleTime": "string", "WiFiAccessPoints": [ { "MacAddress": "string", "Rss": number } ] }, "DistanceUnit": "string" } ``` ------ **nota** El **SDK de Integrity** proporciona características mejoradas relacionadas con la verificación de dispositivos y está disponible para su uso previa solicitud. Para acceder al SDK, póngase en contacto con el [Soporte de ventas](https://aws.amazon.com/contact-us/sales-support/?pg=locationprice&cta=herobtn). # Vincular un rastreador a una colección de geocercas Ahora que tiene un conjunto de geocercas y un rastreador, puede vincularlos entre sí para que las actualizaciones de ubicación se evalúen automáticamente comparándolas con todas sus geocercas. Si no quiere evaluar todas las actualizaciones de ubicación o, si no va a almacenar algunas de sus ubicaciones en un recurso de rastreo, puede [comparar las posiciones de los dispositivos con respecto a las geocercas](https://docs.aws.amazon.com/location/latest/developerguide/evaluate-geofences.html) cuando lo desee. Cuando las posiciones de los dispositivos se comparan con las geocercas, se generan eventos. Puede establecer una acción para estos eventos. Para obtener más información sobre las acciones que puede configurar para los 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 y 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). Los siguientes ejemplos vinculan un recurso de rastreo a una colección de geovallas mediante la consola AWS CLI, la ubicación de Amazon o Amazon. APIs ------ #### [ Console ] **Para vincular un recurso de rastreo a una colección de geocercas mediante la consola de Amazon Location Service** 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. En **Rastreadores de dispositivos**, seleccione el enlace con el nombre del rastreador objetivo. 1. En **Colecciones de geocercas vinculadas**, elija **Vincular colección de geocercas**. 1. En la ventana **Colección de geocercas vinculadas**, seleccione una colección de geocercas en el menú desplegable. 1. Elija **Vincular**. Tras vincular el recurso de rastreador, se le asignará el estado **Activo**. ------ #### [ API ] **Para vincular un recurso de rastreo a una colección de geovallas mediante la ubicación de Amazon APIs** Usa la `[AsssociateTrackerConsumer](https://docs.aws.amazon.com/location-trackers/latest/APIReference/API_AssociateTrackerConsumer.html)` operación de Amazon Location Trackers. APIs En el siguiente ejemplo, se utiliza una solicitud de API que se *ExampleTracker* asocia a una colección de geovallas mediante [su nombre de recurso de Amazon](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) (ARN). ``` POST /tracking/v0/trackers/ExampleTracker/consumers Content-type: application/json { "ConsumerArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection" } ``` ------ #### [ AWS CLI ] **Para vincular un recurso de rastreo a una colección de geovallas mediante comandos AWS CLI ** Utilice el comando `[associate-tracker-consumer](https://docs.aws.amazon.com/cli/latest/reference/location/associate-tracker-consumer.html)`. En el siguiente ejemplo, se utiliza un AWS CLI para crear una colección de geovallas llamada. *ExampleGeofenceCollection* ``` aws location \ associate-tracker-consumer \ --consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection" \ --tracker-name "ExampleTracker" ``` ------ # Rastreo mediante AWS IoT y MQTT con Amazon Location Service [MQTT](http://mqtt.org/) es un protocolo de mensajería ligero y ampliamente adoptado diseñado para dispositivos restringidos. AWS IoT Core admite conexiones de dispositivos que utilizan el protocolo MQTT y el protocolo MQTT over WebSocket Secure (WSS). [AWS IoT Core](https://aws.amazon.com/iot-core/) conecta dispositivos a AWS y le permite enviar y recibir mensajes entre ellos. El motor de reglas AWS IoT Core almacena las consultas sobre los temas de los mensajes de sus dispositivos y le permite definir acciones para enviar mensajes a otros servicios de AWS, como Amazon Location Service. A los dispositivos que conocen su ubicación como coordenadas se les puede reenviar su ubicación a Amazon Location a través del motor de reglas. **nota** Los dispositivos pueden conocer su propia posición, por ejemplo, a través del GPS incorporado. AWS IoT también es compatible con el rastreo de la ubicación de dispositivos de terceros. Para obtener más información, consulte [AWS IoT Core Device Location](https://docs.aws.amazon.com/iot/latest/developerguide/device-location.html) en la *Guía para desarrolladores de núcleo de AWS IoT*. En el siguiente tutorial se describe el rastreo mediante reglas de AWS IoT Core. También puede enviar la información del dispositivo a su propia función de AWS Lambda si necesita procesarla antes de enviarla a Amazon Location. Para obtener más información sobre el uso de Lambda para procesar las ubicaciones de sus dispositivos, consulte [Uso AWS Lambda con MQTT](tracking-using-mqtt-with-lambda.md). **Topics** + [Requisito previo](#mqtt-prerequisite) + [Crear una regla de AWS IoT Core](#mqtt-create-iot-rule) + [Pruebe su regla de AWS IoT Core en la consola](#mqtt-test-iot-rule) + [Uso AWS Lambda con MQTT](tracking-using-mqtt-with-lambda.md) ## Requisito previo Antes de comenzar el rastreo, debe completar los siguientes requisitos previos: + [Crear un recurso de rastreo](start-create-tracker.md) al que enviar los datos de ubicación del dispositivo. + [Crear un rol de IAM](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-role.html) para conceder a AWS IoT Core acceso a su rastreador. Cuando siga estos pasos, use la siguiente política para dar acceso a su rastreador: ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "WriteDevicePosition", "Effect": "Allow", "Action": "geo:BatchUpdateDevicePosition", "Resource": "arn:aws:geo:*:*:tracker/*" } ] } ``` ## Crear una regla de AWS IoT Core A continuación, cree una regla de AWS IoT Core para reenviar la telemetría posicional de sus dispositivos a Amazon Location Service. Para obtener más información sobre la creación de reglas, consulte los siguientes temas en la *Guía para desarrolladores de AWS IoT Core*: + [Crear una regla de AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-rule.html) para obtener información sobre cómo crear una nueva regla. + [Acción de ubicación](https://docs.aws.amazon.com/iot/latest/developerguide/location-rule-action.html) para obtener información específica sobre la creación de una regla para publicar en Amazon Location ## Pruebe su regla de AWS IoT Core en la consola Si actualmente ningún dispositivo publica telemetría que incluya la ubicación, puede probar su regla con la consola de AWS IoT Core. La consola tiene un cliente de prueba en el que puede publicar un mensaje de muestra para comprobar los resultados de la solución. 1. Inicie sesión en la consola de AWS IoT Core en [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home). 1. En el menú de navegación de la izquierda, expanda **Pruebas** y elija **Cliente de pruebas de MQTT**. 1. En **Publicar en un tema**, defina el **Nombre del tema** como *iot/topic* (o el nombre del tema que haya configurado en su regla de AWS IoT Core, si es diferente) y proporcione lo siguiente para la **Carga de mensajes**. Sustituya la marca de tiempo *1604940328* por una marca de tiempo válida de los últimos 30 días (los rastreadores de Amazon Location Service ignoran las marcas de tiempo de más de 30 días). ``` { "payload": { "deviceid": "thing123", "timestamp": 1604940328, "location": { "lat": 49.2819, "long": -123.1187 }, "accuracy": { "Horizontal": 20.5 }, "positionProperties": { "field1": "value1", "field2": "value2" } } } ``` 1. Seleccione **Publicar** en un tema para enviar el mensaje de prueba. 1. Para validar que Amazon Location Service recibió el mensaje, use el siguiente comando AWS CLI. Si lo modificó durante la configuración, sustituya el nombre del rastreador por el que utilizó. ``` aws location batch-get-device-position --tracker-name MyTracker --device-ids thing123 ``` # Uso AWS Lambda con MQTT Si bien su uso ya no AWS Lambda es obligatorio para enviar datos de ubicación del dispositivo a Amazon Location para su seguimiento, es posible que desee utilizar Lambda en algunos casos. Por ejemplo, si desea procesar usted mismo los datos de ubicación de su dispositivo antes de enviarlos a Amazon Location. En los temas siguientes se describe cómo utilizar Lambda para procesar los mensajes antes de enviarlos al rastreador. Para obtener más información sobre este patrón, consulte la [arquitectura de referencia](https://d1.awsstatic.com/architecture-diagrams/ArchitectureDiagrams/amazon-location-service-ra.pdf). **Topics** + [Requisito previo](#mqtt-prerequisite-with-lambda) + [Crear una función de Lambda](#mqtt-with-lambda-create-lambda) + [Crea una AWS IoT Core regla](#mqtt-create-iot-rule-with-lambda) + [Pon a prueba tu AWS IoT Core regla en la consola](#mqtt-test-iot-rule-with-lambda) ## Requisito previo Antes de empezar a realizar el rastreo, debe [crear un recurso de rastreo](start-tracking.md). Para crear un recurso de seguimiento, puedes usar la consola de Amazon Location AWS CLI, la o Amazon Location APIs. En el siguiente ejemplo, se utiliza la consola de Amazon Location Service para crear el recurso de rastreo: 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. Complete las casillas siguientes: + **Nombre**: introduzca un nombre único que tenga un máximo de 100 caracteres. Entre las entradas válidas se incluyen caracteres alfanuméricos, guiones y guiones bajos. Por ejemplo, *MyTracker*. + **Descripción**: escriba una descripción opcional. Por ejemplo, *Tracker for storing AWS IoT Core device positions*. + **Filtrado de posición**: seleccione el filtro que desee usar para las actualizaciones de posición. Por ejemplo, **filtrado basado en la precisión**. 1. Seleccione **Crear rastreador**. ## Crear una función de Lambda Para crear una conexión entre Amazon Location Service AWS IoT Core y Amazon, necesitas una AWS Lambda función que procese los mensajes reenviados AWS IoT Core. Esta función extraerá todos los datos posicionales, los formateará para Amazon Location Service y los enviará a través de la API de Amazon Location Tracker. Puede crear esta función a través de la AWS Lambda consola, o puede usar AWS Command Line Interface (AWS CLI) o AWS Lambda APIs. Para crear una función de Lambda que publique actualizaciones de posición en Amazon Location mediante la consola: 1. Abra la AWS Lambda consola en [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/home). 1. En el panel de navegación izquierdo, elija **Funciones**. 1. Elija **Crear función** y asegúrese de que esté seleccionada la opción **Autor desde cero**. 1. Complete las casillas siguientes: + **Nombre de función**: introduzca un nombre único para su función. Las entradas válidas incluyen caracteres alfanuméricos, guiones y guiones bajos sin espacios. Por ejemplo, *MyLambda*. + **Tiempo de ejecución**: elija*Python 3.8*. 1. Seleccione **Creación de función**. 1. Elija la pestaña **Código** para abrir el editor. 1. Sobrescriba el código del marcador de posición `lambda_function.py` con lo siguiente y sustituya el valor asignado a `TRACKER_NAME` por el nombre del rastreador que creó como [requisito previo](#mqtt-prerequisite-with-lambda). ``` from datetime import datetime import json import os import boto3 # Update this to match the name of your Tracker resource TRACKER_NAME = "MyTracker" """ This Lambda function receives a payload from AWS IoT Core and publishes device updates to Amazon Location Service via the BatchUpdateDevicePosition API. Parameter 'event' is the payload delivered from AWS IoT Core. In this sample, we assume that the payload has a single top-level key 'payload' and a nested key 'location' with keys 'lat' and 'long'. We also assume that the name of the device is nested in the payload as 'deviceid'. Finally, the timestamp of the payload is present as 'timestamp'. For example: >>> event { 'payload': { 'deviceid': 'thing123', 'timestamp': 1604940328, 'location': { 'lat': 49.2819, 'long': -123.1187 }, 'accuracy': {'Horizontal': 20.5 }, 'positionProperties': {'field1':'value1','field2':'value2'} } } If your data doesn't match this schema, you can either use the AWS IoT Core rules engine to format the data before delivering it to this Lambda function, or you can modify the code below to match it. """ def lambda_handler(event, context): update = { "DeviceId": event["payload"]["deviceid"], "SampleTime": datetime.fromtimestamp(event["payload"]["timestamp"]).strftime("%Y-%m-%dT%H:%M:%SZ"), "Position": [ event["payload"]["location"]["long"], event["payload"]["location"]["lat"] ] } if "accuracy" in event["payload"]: update["Accuracy"] = event["payload"]['accuracy'] if "positionProperties" in event["payload"]: update["PositionProperties"] = event["payload"]['positionProperties'] client = boto3.client("location") response = client.batch_update_device_position(TrackerName=TRACKER_NAME, Updates=[update]) return { "statusCode": 200, "body": json.dumps(response) } ``` 1. Seleccione **Implementar** para almacenar la función actualizada. 1. Elija la pestaña **Configuración**. 1. En la sección **Permisos**, elija el nombre del rol con el hipervínculo para conceder permisos de Amazon Location Service a su función de Lambda. 1. En la página **Resumen** de su rol, seleccione **Agregar permisos** y, a continuación, en la lista desplegable, seleccione **Crear política integrada**. 1. Elija la pestaña **JSON** y sobrescriba la política con el siguiente documento. Esto permite que la función de Lambda actualice las posiciones de los dispositivos gestionadas por todos los recursos de rastreo en todas las regiones. ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "WriteDevicePosition", "Effect": "Allow", "Action": "geo:BatchUpdateDevicePosition", "Resource": "arn:aws:geo:*:*:tracker/*" } ] } ``` 1. Elija **Revisar política**. 1. Escriba un nombre para la política. Por ejemplo, *AmazonLocationTrackerWriteOnly*. 1. Elija **Crear política**. Puede modificar el código de esta función, según sea necesario, para adaptarlo al esquema de mensajes de su propio dispositivo. ## Crea una AWS IoT Core regla A continuación, cree una AWS IoT Core regla para reenviar la telemetría posicional de sus dispositivos a la AWS Lambda función para su transformación y publicación en Amazon Location Service. La regla de ejemplo proporcionada asume que cualquier transformación necesaria de las cargas útiles del dispositivo es gestionada por la función de Lambda. Puede crear esta regla a través de la AWS IoT Core consola, el AWS Command Line Interface ()AWS CLI o el. AWS IoT Core APIs **nota** Si bien la AWS IoT consola gestiona los permisos necesarios para poder AWS IoT Core invocar la función Lambda, si va a crear la regla a partir del SDK o AWS CLI del SDK, [debe configurar una política a la que conceder](https://docs.aws.amazon.com/iot/latest/developerguide/lambda-rule-action.html#lambda-rule-action-requirements) el permiso. AWS IoT **Para crear y AWS IoT Core usar la consola** 1. Inicie sesión en la AWS IoT Core consola en [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home). 1. En el panel de navegación izquierdo, expanda **Actuar** y, a continuación, elija **Reglas**. 1. Elija **Crear una regla** para iniciar el asistente de nueva regla. 1. Escriba un nombre y la descripción de la regla. 1. Para la **declaración de consulta de la regla**, actualice el atributo `FROM` para que haga referencia a un tema en el que al menos un dispositivo publique telemetría que incluya la ubicación. Si está probando la solución, no es necesario modificarla. ``` SELECT * FROM 'iot/topic' ``` 1. En **Definir una o varias acciones**, elija **Agregar acción**. 1. Seleccione **Enviar un mensaje a una función de Lambda.** 1. Elija **Configurar acción**. 1. Busque y seleccione su función de Lambda de la lista. 1. Seleccione **Agregar acción**. 1. Elija **Crear regla**. ## Pon a prueba tu AWS IoT Core regla en la consola Si actualmente ningún dispositivo publica telemetría que incluya la ubicación, puede probar la regla y esta solución mediante la AWS IoT Core consola. La consola tiene un cliente de prueba en el que puede publicar un mensaje de muestra para comprobar los resultados de la solución. 1. Inicie sesión en la AWS IoT Core consola en. [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/home) 1. En el menú de navegación de la izquierda, expanda **Pruebas** y elija **Cliente de pruebas de MQTT**. 1. En **Publicar en un tema**, establece el **nombre del tema** en *iot/topic* (o el nombre del tema que hayas configurado en la AWS IoT Core regla, si es diferente) y proporciona lo siguiente para la **carga del mensaje**. Sustituya la marca de tiempo por una marca *1604940328* de tiempo válida de los últimos 30 días (se omiten las marcas de tiempo que tengan más de 30 días). ``` { "payload": { "deviceid": "thing123", "timestamp": 1604940328, "location": { "lat": 49.2819, "long": -123.1187 }, "accuracy": { "Horizontal": 20.5 }, "positionProperties": { "field1": "value1", "field2": "value2" } } } ``` 1. Seleccione **Publicar** en un tema para enviar el mensaje de prueba. 1. Para validar que Amazon Location Service recibió el mensaje, use el siguiente comando AWS CLI . Si los modificó durante la configuración, sustituya el nombre del rastreador y el identificador del dispositivo por los que utilizó. ``` aws location batch-get-device-position --tracker-name MyTracker --device-ids thing123 ``` # Administración del seguimiento de Amazon Location Service Puedes gestionar tus rastreadores mediante la consola de Amazon Location AWS CLI, la o Amazon Location APIs. ## Enumerar sus rastreadores Puedes ver tu lista de rastreadores utilizando la consola de Amazon Location AWS CLI, la o la ubicación de Amazon: APIs ------ #### [ Console ] **Para ver una lista de los rastreadores existentes mediante la consola de Amazon Location** 1. Abre la consola de Amazon Location en [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. En la navegación izquierda, elija **Rastreadores**. 1. Consulte una lista de los recursos de su rastreador desde **Mis rastreadores**. ------ #### [ API ] Usa la `[ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html)` operación de Amazon Location Trackers. APIs El siguiente ejemplo es una solicitud de API para obtener una lista de los rastreadores de tu AWS cuenta. ``` POST /tracking/v0/list-trackers ``` A continuación, se muestra un ejemplo de respuesta para `[ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html)`: ``` { "Entries": [ { "CreateTime": 2020-10-02T19:09:07.327Z, "Description": "string", "TrackerName": "ExampleTracker", "UpdateTime": 2020-10-02T19:10:07.327Z } ], "NextToken": "1234-5678-9012" } ``` ------ #### [ CLI ] Utilice el comando `[list-trackers](https://docs.aws.amazon.com/cli/latest/reference/location/list-trackers.html)`. El siguiente ejemplo es AWS CLI para obtener una lista de los rastreadores de tu AWS cuenta. ``` aws location list-trackers ``` ------ ## Desconectar un rastreador de una colección de geocercas Puedes desconectar un rastreador de una colección de geovallas mediante la consola de ubicación de Amazon AWS CLI, la o la ubicación de Amazon: APIs ------ #### [ Console ] **Para desasociar un rastreador de una colección de geocercas asociada mediante la consola de Amazon Location** 1. Abre la consola de Amazon Location en [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. Desde el panel de navegación izquierdo, elija **Rastreadores**. 1. En **Mis rastreadores**, seleccione el enlace con el nombre del rastreador objetivo. 1. En **Colecciones de geocercas vinculadas**, seleccione una colección de geocercas con el estado **vinculado**. 1. Elija **Desvincular**. ------ #### [ API ] Usa la `[DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html)` operación de Amazon Location Trackers. APIs El siguiente ejemplo es una solicitud de API para desasociar un rastreador de una colección de geocercas asociada. ``` DELETE /tracking/v0/trackers/ExampleTracker/consumers/arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleCollection ``` A continuación, se muestra un ejemplo de respuesta para `[DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html)`: ``` HTTP/1.1 200 ``` ------ #### [ CLI ] Utilice el comando `[disassociate-tracker-consumer](https://docs.aws.amazon.com/cli/latest/reference/location/disassociate-tracker-consumer.html)`. El siguiente ejemplo es un AWS CLI comando para desasociar un rastreador de una colección de geovallas asociada. ``` aws location disassociate-tracker-consumer \ --consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleCollection" \ --tracker-name "ExampleTracker" ``` ------ ## Obtenga información acerca de su rastreador Puedes obtener detalles sobre cualquier rastreador de tu AWS cuenta mediante la consola de ubicaciones de Amazon AWS CLI, la o la ubicación de Amazon APIs. ------ #### [ Console ] **Para ver los detalles del rastreador mediante la consola de Amazon Location** 1. Abre la consola de Amazon Location en [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. En la navegación izquierda, elija **Rastreadores**. 1. En **Mis rastreadores**, seleccione el enlace con el nombre del rastreador objetivo. 1. Consulte los detalles del rastreador en **Información**. ------ #### [ API ] Usa la `[DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html)` operación del Amazon Location Tracker APIs. El siguiente ejemplo es una solicitud de API para obtener los detalles del rastreador*ExampleTracker*. ``` GET /tracking/v0/trackers/ExampleTracker ``` A continuación, se muestra un ejemplo de respuesta para `[DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html)`: ``` { "CreateTime": 2020-10-02T19:09:07.327Z, "Description": "string", "EventBridgeEnabled": false, "KmsKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab", "PositionFiltering": "TimeBased", "Tags": { "Tag1" : "Value1" }, "TrackerArn": "arn:aws:geo:us-west-2:123456789012:tracker/ExampleTracker", "TrackerName": "ExampleTracker", "UpdateTime": 2020-10-02T19:10:07.327Z } ``` ------ #### [ CLI ] Utilice el comando `[describe-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/describe-tracker.html)`. El siguiente ejemplo es un AWS CLI comando para obtener los detalles del rastreador*ExampleTracker*. ``` aws location describe-tracker \ --tracker-name "ExampleTracker" ``` ------ ## Eliminar un rastreador Puedes eliminar un rastreador de tu AWS cuenta mediante la consola de ubicaciones de Amazon AWS CLI, la o la ubicación de Amazon APIs: ------ #### [ Console ] **Para eliminar un recurso de mapa existente mediante la consola de Amazon Location** **aviso** Esta operación elimina el recurso de forma permanente. Si el recurso del rastreador está en uso, es posible que se produzca un error. Asegúrese de que el recurso de destino no sea una dependencia de sus aplicaciones. 1. Abre la consola de Amazon Location en [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home). 1. Desde el panel de navegación izquierdo, elija **Rastreadores**. 1. En **Mis rastreadores**, seleccione el rastreador de destino. 1. Seleccione **Eliminar rastreador**. ------ #### [ API ] Usa la `[DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html)` operación del Amazon Location Tracker APIs. El siguiente ejemplo es una solicitud de API para eliminar el rastreador*ExampleTracker*. ``` DELETE /tracking/v0/trackers/ExampleTracker ``` A continuación, se muestra un ejemplo de respuesta para `[DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html)`: ``` HTTP/1.1 200 ``` ------ #### [ CLI ] Utilice el comando `[delete-tracker](https://docs.aws.amazon.com/cli/latest/reference/location/delete-tracker.html)`. El siguiente ejemplo es un AWS CLI comando para eliminar el rastreador*ExampleTracker*. ``` aws location delete-tracker \ --tracker-name "ExampleTracker" ``` ------ # Administración de costos y uso A medida que siga obteniendo información sobre los rastreadores de ubicación de Amazon, es importante que sepa cómo administrar la capacidad del servicio, asegurarse de cumplir con los límites de uso y obtener los mejores resultados mediante las optimizaciones de cuotas y API. Al aplicar las prácticas recomendadas para garantizar el rendimiento y la precisión, puede personalizar la aplicación para gestionar las consultas relacionadas con el lugar de forma eficiente y maximizar las solicitudes de la API. **Topics** + [Precio de los rastreadores](trackers-pricing.md) + [Cuota y uso de los rastreadores](trackers-quotas.md) # Precio de los rastreadores Para obtener información sobre los precios de seguimiento y geocercado de las API, consulte la [página de precios de Amazon Location Service](https://aws.amazon.com/location/pricing/). **Posición escrita** Puede utilizar `BatchUpdateDevicePosition` para cargar los datos de actualización de posición de uno o más dispositivos en un recurso de seguimiento (hasta diez dispositivos por lote). El precio se basa en el número de posiciones del dispositivo en la solicitud de la API. El precio unitario por actualización de posición del dispositivo se basa en el volumen total de uso mensual. Consulte la [página de precios de Amazon Location Service](https://aws.amazon.com/location/pricing/) para obtener más información sobre el precio unitario y los niveles de volumen. Puede optimizar el costo por posición escrita configurando la frecuencia de actualización de la posición del dispositivo (también conocida como tasa de ping) desde los dispositivos de rastreo y, si lo prefiere, utilizar un filtro local para cargar solo las actualizaciones de posición relevantes del dispositivo a Amazon Location Service. **Posición leída** Puede utilizar `BatchGetDevicePosition` para mostrar las posiciones más recientes de los dispositivos solicitados, hasta 100 dispositivos por solicitud. También se puede utilizar `GetDevicePosition` para recuperar la posición más reciente de un dispositivo en función del tiempo de ejemplo. El precio se basa en la cantidad de solicitudes de la API. **Posición eliminada** Se puede utilizar `BatchDeleteDevicePositionHistory` para eliminar el historial de posiciones de uno o más dispositivos de un recurso de seguimiento, hasta 100 dispositivos por solicitud. El precio se basa en el número de dispositivos en la solicitud de la API. **Evaluación de la integridad de la posición** Puede utilizar `VerifyDevicePosition` para verificar la integridad de la posición del dispositivo determinando si se registró detrás de un proxy y comparándola con una posición inferida estimada en función del estado del dispositivo. El precio se basa en la cantidad de solicitudes de la API. # Cuota y uso de los rastreadores En este tema se proporciona un resumen de los límites de tarifas y las cuotas de rastreadores de Amazon Location Service. **nota** Si requiere una cuota más alta, Puede utilizar la consola de Service Quotas para [solicitar aumentos de cuota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) para las cuotas ajustables. Cuando solicites un aumento de cuota, selecciona la región en la que deseas el aumento de cuota, ya que la mayoría de las cuotas son específicas de la AWS región. Puede solicitar hasta el doble del límite predeterminado para cada API. En el caso de las solicitudes que superen el doble del límite predeterminado, la solicitud enviará un ticket de soporte. Puede también contactar con el equipo de soporte prémium. No se cobran cargos directos por las solicitudes de aumento de cuota, pero los niveles de uso más altos pueden conllevar un aumento de los costos del servicio en función de los recursos adicionales consumidos. Para obtener más información, consulte [Administración de cuotas con Service Quotas](manage-quotas.md). Service Quotas es la cantidad máxima de recursos que puede tener por AWS cuenta y AWS región. Amazon Location Service deniega las solicitudes adicionales que superen la service quota. ## Recursos | Nombre de API | Predeterminado | Límite ajustable máximo | | --- | --- | --- | | Recursos de seguimiento por cuenta | 500 | 1 000 Si necesita más que esto, [solicite aumentos de cuota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o contacte con el equipo de soporte. | | Rastrea a los consumidores por rastreador | 5 | No se aplica el límite máximo ajustable. Contacte con el equipo de soporte. | ## API de CRUD **nota** Si necesitas un límite superior para alguna de estas opciones APIs, [solicita un aumento de la cuota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o ponte en contacto con el equipo de asistencia. | Nombre de API | Predeterminado | Límite ajustable máximo | | --- | --- | --- | | [AssociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_AssociateTrackerConsumer.html) | 10 | 20 | | [CreateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_CreateTracker.html) | 10 | 20 | | [DeleteTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DeleteTracker.html) | 10 | 20 | | [DescribeTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DescribeTracker.html) | 10 | 20 | | [DisassociateTrackerConsumer](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_DisassociateTrackerConsumer.html) | 10 | 20 | | [ListTrackerConsumers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackerConsumers.html) | 10 | 20 | | [ListTrackers](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListTrackers.html) | 10 | 20 | | [UpdateTracker](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_UpdateTracker.html) | 10 | 20 | ## Data API (API de datos) **nota** Si necesitas un límite superior para alguno de estos requisitos APIs, [solicita un aumento de cuota](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o ponte en contacto con el equipo de asistencia. | Nombre de API | Predeterminado | Límite ajustable máximo | | --- | --- | --- | | [BatchGetDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchGetDevicePosition.html) | 50 | 100 | | [BatchUpdateDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchUpdateDevicePosition.html) | 50 | 100 | | [GetDevicePosition](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePosition.html) | 50 | 100 | | [GetDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_GetDevicePositionHistory.html) | 50 | 100 | | [BatchDeleteDevicePositionHistory](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_BatchDeleteDevicePositionHistory.html) | 50 | 100 | | [ListDevicePositions](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointTracking_ListDevicePositions.html) | 50 | 100 | ## Otros límites de uso