Descripción general de la API de Snapshot

Aviso de baja: Indicadores contextuales de Places y Weather

Advertencia: Se dejaron de usar los indicadores contextuales de Places y Weather, expuestos por los métodos getPlaces() y getWeather().

• Se desactivó el indicador contextual de Places. El uso continuo de este indicador se restringió a los clientes con implementaciones existentes hasta el 30 de octubre de 2019. Las implementaciones nuevas deben usar el SDK de Places para Android en lugar de el indicador contextual de Places.
• También se desactivó el indicador contextual de Weather. El uso continuo de este indicador se restringió a los clientes con implementaciones existentes hasta el 31 de enero de 2020. Google no ofrece una funcionalidad alternativa para el indicador contextual de Weather.

Puedes usar la API de Snapshot para obtener información sobre el entorno actual del usuario. Con la API de Snapshot, puedes acceder a una variedad de indicadores de contexto:

• Actividad detectada del usuario, como cuando camina o conduce
• Beacons cercanos que registraste
• Estado de los auriculares, conectados o no
• Ubicación, que incluye latitud y longitud

El sistema almacena en caché estos valores para que se puedan mostrar rápidamente. Si no hay datos, se realizan la detección y la inferencia para mostrar valores de estado nuevos. La API de Awareness muestra el tipo de datos existente para los tipos de contexto que tienen una API pública.

Cada indicador de contexto tiene un método de API de Snapshot correspondiente. Por ejemplo, para obtener la actividad detectada actual, llamas a getDetectedActivity(), usas un SuccessListener para obtener un DetectedActivityResponse y, luego, llamas a getActivityRecognitionResult() para mostrar un ActivityRecognitionResult desde el que puedes obtener los datos de solicitud reales.

En el siguiente ejemplo, se muestra cómo obtener la actividad detectada más reciente:

        Awareness.getSnapshotClient(this).getDetectedActivity()
            .addOnSuccessListener(new OnSuccessListener<DetectedActivityResponse>() {
                @Override
                public void onSuccess(DetectedActivityResponse dar) {
                    ActivityRecognitionResult arr = dar.getActivityRecognitionResult();
                }
            })

Para obtener más información sobre lo que puedes hacer con los datos de la solicitud, consulta Obtén datos de instantáneas.