Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Avec l'API Google Awareness, vous pouvez permettre à votre application de réagir intelligemment à la situation actuelle de l'utilisateur. L'API Awareness expose cinq types de contextes différents, y compris l'activité de l'utilisateur et les balises à proximité. Ces types permettent à votre application d'affiner l'expérience utilisateur de manières nouvelles qui n'étaient pas possibles auparavant. Votre application peut combiner ces signaux contextuels pour déduire la situation actuelle de l'utilisateur et utiliser ces informations pour fournir des expériences personnalisées, comme une suggestion de playlist lorsque l'utilisateur branche ses écouteurs et commence à faire du jogging.
Avantages de l'API Awareness
L'API Awareness présente plusieurs avantages:
Facilité d'implémentation:vous n'avez besoin d'ajouter qu'une seule API à votre application, ce qui simplifie grandement l'intégration et améliore votre productivité.
Meilleures données contextuelles:les signaux bruts sont traités pour améliorer la qualité. Par exemple, des algorithmes avancés sont utilisés pour déterminer l'activité de l'utilisateur avec un niveau de précision élevé.
État de santé optimal du système:l'API Awareness gère automatiquement son impact sur l'autonomie de la batterie et la consommation de données, ce qui n'est pas le cas de votre application.
Clôtures et instantanés
L'API Awareness se compose de deux API distinctes que votre application peut utiliser pour obtenir des signaux contextuels afin de déterminer la situation actuelle de l'utilisateur:
API Fence:cette API permet à votre application de réagir à la situation actuelle de l'utilisateur et envoie une notification lorsqu'une combinaison de conditions de contexte est remplie. Par exemple, chaque fois que l'utilisateur se promène et que ses écouteurs sont branchés. Une fois une barrière enregistrée, l'API Fence peut envoyer des rappels à votre application même lorsqu'elle n'est pas en cours d'exécution.
API Snapshot:cette API permet à votre application de demander des informations sur le contexte actuel de l'utilisateur, telles que sa position et les conditions météorologiques actuelles.
Types de contexte
Le contexte est au cœur de l'API Awareness. Les données contextuelles incluent les données dérivées des capteurs, telles que la position (latitude et longitude), le type de lieu (par exemple, un parc ou un café) et l'activité (par exemple, une marche ou une conduite). Ces types de base, ou signaux, peuvent être combinés pour extrapoler la situation de l'utilisateur de manière plus précise. Développez la notification suivante pour voir les signaux contextuels obsolètes.
Avis d'abandon: signaux contextuels Places et Météo
Le tableau suivant décrit les types de contexte de base actuellement proposés par l'API Awareness:
Type de contexte
Exemple
Temps
Heure locale actuelle
Emplacement
Latitude et longitude
Activité
Activité détectée de l'utilisateur, comme la marche, la course à pied ou le vélo
Balises
Balise à proximité correspondant à l'espace de noms spécifié
Écouteurs
État du casque (branché ou non)
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (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 |"]]
