Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Mit der Google Awareness API können Sie Ihre App so konfigurieren, dass sie intelligent auf die aktuelle Situation des Nutzers reagiert. Die Awareness API bietet fünf verschiedene Kontexttypen, darunter Nutzeraktivitäten und Beacons in der Nähe. Mit diesen Typen können Sie die Nutzerfreundlichkeit Ihrer App auf neue Weise optimieren, die zuvor nicht möglich war. Ihre App kann diese Kontextsignale kombinieren, um Rückschlüsse auf die aktuelle Situation des Nutzers zu ziehen. Diese Informationen können dann verwendet werden, um personalisierte Funktionen bereitzustellen, z. B. eine Playlist-Empfehlung, wenn der Nutzer seine Kopfhörer anschließt und mit dem Joggen beginnt.
Vorteile der Awareness API
Die Awareness API bietet mehrere Vorteile:
Einfache Implementierung:Sie müssen Ihrer App nur eine einzige API hinzufügen. Das vereinfacht die Integration erheblich und steigert die Produktivität.
Bessere Kontextdaten:Rohsignale werden verarbeitet, um die Qualität zu verbessern. So werden beispielsweise mithilfe von fortschrittlichen Algorithmen die Aktivitäten des Nutzers mit hoher Genauigkeit ermittelt.
Optimaler Systemzustand:Die Awareness API verwaltet automatisch die Auswirkungen auf die Akkulaufzeit und die Datennutzung, sodass Ihre App dies nicht tun muss.
Zäune und Snapshots
Die Awareness API besteht aus zwei separaten APIs, mit denen Ihre App Kontextsignale abrufen kann, um die aktuelle Situation des Nutzers zu ermitteln:
Fence API:Mit dieser API kann Ihre App auf die aktuelle Situation des Nutzers reagieren. Sie liefert Benachrichtigungen, wenn eine Kombination von Kontextbedingungen erfüllt ist. Zum Beispiel, wenn der Nutzer einen Spaziergang macht und seine Kopfhörer angeschlossen sind. Sobald ein Fence registriert ist, kann die Fence API Callbacks an Ihre App senden, auch wenn sie nicht ausgeführt wird.
Snapshot API:Mit dieser API kann Ihre App Informationen zum aktuellen Kontext des Nutzers anfordern, z. B. den aktuellen Standort des Nutzers und die aktuellen Wetterbedingungen.
Kontexttypen
Kontext ist das Herzstück der Awareness API. Zu den Kontextdaten gehören sensorgenerierte Daten wie Standort (Breiten- und Längengrad), Ortstyp (z. B. Park oder Café) und Aktivität (z. B. Spaziergang oder Autofahrt). Diese grundlegenden Typen oder Signale können kombiniert werden, um die Situation des Nutzers genauer zu erfassen. Maximieren Sie die folgende Mitteilung, um zu sehen, welche Kontextsignale eingestellt wurden.
Hinweis zur Einstellung: Kontextsignale für Orte und Wetter
In der folgenden Tabelle werden die grundlegenden Kontexttypen beschrieben, die derzeit von der Awareness API angeboten werden:
Kontexttyp
Beispiel
Zeit
Aktuelle Ortszeit
Standort
Breiten- und Längengrad
Aktivität
Erkannte Nutzeraktivitäten wie Gehen, Laufen oder Radfahren
Beacons
Beacons in der Nähe, die dem angegebenen Namespace entsprechen
[null,null,["Zuletzt aktualisiert: 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 |"]]
