Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Con la API de Google Awareness, puedes permitir que tu app reaccione de forma inteligente ante la situación actual del usuario. La API de Awareness expone cinco tipos de contexto diferentes, que incluyen la actividad del usuario y las balizas cercanas. Estos tipos permiten que tu app defina mejor la experiencia del usuario de nuevas maneras que antes no eran posibles. Tu app puede combinar estas señales de contexto para hacer inferencias sobre la situación actual del usuario y usar esta información para brindar experiencias personalizadas, como una sugerencia de playlist cuando el usuario conecta sus auriculares y comienza a correr.
Beneficios de la API de Awareness
La API de Awareness ofrece varios beneficios:
Facilidad de implementación: Solo necesitas agregar una API a tu app, lo que simplifica en gran medida la integración y mejora tu productividad.
Mejores datos de contexto: Los indicadores sin procesar se procesan para mejorar la calidad. Por ejemplo, se usan algoritmos avanzados para determinar la actividad del usuario con un alto nivel de precisión.
Estado óptimo del sistema: La API de Awareness administra automáticamente su impacto en la duración de la batería y el uso de datos para que tu app no tenga que hacerlo.
Cercas y instantáneas
La API de Awareness consta de dos APIs distintas que tu app puede usar para obtener indicadores de contexto y determinar la situación actual del usuario:
API de Fence: Esta API permite que tu app reaccione ante la situación actual del usuario y proporciona notificaciones cuando se cumple una combinación de condiciones de contexto. Por ejemplo, cada vez que el usuario sale a caminar y tiene los auriculares conectados. Una vez que se registra una barrera, la API de Fence puede enviar devoluciones de llamada a tu app incluso cuando no se está ejecutando.
API de Snapshot: Esta API le permite a tu app solicitar información sobre el contexto actual del usuario, como su ubicación y las condiciones climáticas actuales.
Tipos de contexto
El contexto es el elemento central de la API de Awareness. Los datos contextuales incluyen datos derivados de sensores, como la ubicación (latitud y longitud), el tipo de lugar (por ejemplo, un parque o una cafetería) y la actividad (por ejemplo, caminar o conducir). Estos tipos básicos, o indicadores, se pueden combinar para extrapolar la situación del usuario con más detalle. Expande el siguiente aviso para ver qué indicadores contextuales dejaron de estar disponibles.
Aviso de baja: Indicadores contextuales de Clima y Lugares
En la siguiente tabla, se describen los tipos de contexto básicos que ofrece actualmente la API de Awareness:
Tipo de contexto
Ejemplo
Hora
Hora local actual
Ubicación
Latitud y longitud
Actividad
Actividad del usuario detectada, como caminar, correr o andar en bicicleta
Beacons
Balizas cercanas que coinciden con el espacio de nombres especificado
Auriculares
Estado de si los auriculares están conectados o no
[null,null,["Última actualización: 2025-09-05 (UTC)"],[[["\u003cp\u003eThe Google Awareness API lets your app intelligently respond to the user's context, such as their activity, location, and nearby beacons.\u003c/p\u003e\n"],["\u003cp\u003eIt offers benefits like easy implementation, improved context data quality, and automatic management of system resources.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides two ways to access context: the Fence API for reacting to situations and the Snapshot API for requesting current information.\u003c/p\u003e\n"],["\u003cp\u003eSupported context types include time, location, activity, beacons, and headphone status, while places and weather signals are deprecated.\u003c/p\u003e\n"]]],[],null,["# What's the Awareness API?\n\nWith the Google Awareness API, you can enable your app to intelligently react to the\nuser's current situation. The Awareness API exposes five different\n[context types](#context-types), which include user activity,\nand nearby beacons. These types enable your app to refine the user experience in\nnew ways that weren't possible before. Your app can combine these context\nsignals to make inferences about the user's current situation, and use this\ninformation to provide customized experiences, such as a playlist suggestion\nwhen the user plugs in their headphones and starts to jog.\n\nAwareness API benefits\n----------------------\n\nThe Awareness API provides several benefits:\n\n- **Ease of implementation:** You only need to add a single API to your app, which greatly simplifies integration and improves your productivity.\n- **Better context data:** Raw signals are processed for improved quality. For example, advanced algorithms are used to determine the user's activity with a high level of accuracy.\n- **Optimal system health:** The Awareness API automatically manages its impact on battery life and data usage so that your app doesn't have to.\n\nFences and snapshots\n--------------------\n\nThe Awareness API consists of two distinct APIs that your app can use to\nget context signals in order to determine the user's current situation:\n\n- [**Fence API:**](/awareness/android-api/fence-api-overview) This API lets your app react to the user's current situation, and provides notification when a combination of context conditions are met. For example, whenever the user takes a walk and their headphones are plugged in. Once a fence is registered, the Fence API can send callbacks to your app even when it's not running.\n- [**Snapshot API:**](/awareness/android-api/snapshot-api-overview) This API lets your app request information about the user's current context, such as the user's current location and the current weather conditions.\n\nContext types\n-------------\n\nContext is at the heart of the Awareness API. Contextual data includes\nsensor-derived data such as location (latitude and longitude), place type,\nlike a park or coffee shop, and activity, such as a walk or drive. These basic\ntypes, or signals, can be combined to extrapolate the user's situation in more\nspecific detail. Expand the following notice to see which contextual signals\nhave been deprecated.\n**Deprecation notice: Places and Weather contextual signals** **Warning:**\n| The Places and Weather contextual signals, exposed by the\n| [`getPlaces()`](/android/reference/com/google/android/gms/awareness/SnapshotClient#getPlaces()), and\n| [`getWeather()`](/android/reference/com/google/android/gms/awareness/SnapshotClient#getWeather())\n| methods, were deprecated.\n|\n| - The Places contextual signal was turned off. Continued use of this signal was restricted to customers with existing implementations, through October 30, 2019. New implementations must use the [Places SDK for Android](/places/android-sdk) instead of the Places contextual signal.\n| - The Weather contextual signal has also been turned off. Continued use of this signal has been restricted to customers with existing implementations, through January 31, 2020. Google doesn't offer alternative functionality for the Weather contextual signal.\n\nThe following table describes the basic context types currently offered by\nthe Awareness API:\n\n| Context type | Example |\n|--------------|----------------------------------------------------------|\n| Time | Current local time |\n| Location | Latitude and longitude |\n| Activity | Detected user activity, like walking, running, or biking |\n| Beacons | Nearby beacons that match the specified namespace |\n| Headphones | Status of whether headphones are plugged in, or not |"]]
