Visão geral da API Snapshot

Aviso de descontinuação: sinais contextuais de lugares e clima

Aviso:os indicadores contextuais de lugares e clima, expostos pelos métodos getPlaces() e getWeather(), foram descontinuados.

• O indicador de contexto do Places foi desativado. O uso contínuo desse indicador foi restrito a clientes com implementações existentes até 30 de outubro de 2019. As novas implementações precisam usar o SDK do Places para Android em vez do indicador contextual do Places.
• O indicador de contexto do clima também foi desativado. O uso contínuo desse indicador foi restrito a clientes com implementações existentes até 31 de janeiro de 2020. O Google não oferece funcionalidade alternativa para o indicador contextual do clima.

É possível usar a API Snapshot para receber informações sobre o ambiente atual do usuário. Com a API Snapshot, é possível acessar vários sinais de contexto:

• Atividade do usuário detectada, como quando ele caminha ou dirige.
• Beacons por perto que você registrou.
• Estado do fone de ouvido, conectado ou não.
• Localização, que inclui latitude e longitude.

O sistema armazena em cache esses valores para que eles possam ser retornados rapidamente. Se não houver dados, a detecção e a inferência serão realizadas para retornar valores de estado novos. A API Awareness retorna o tipo de dados atual para tipos de contexto que têm uma API pública.

Cada indicador de contexto tem um método correspondente da API Snapshot. Por exemplo, para receber a atividade detectada atual, chame getDetectedActivity(), use um SuccessListener para receber um DetectedActivityResponse e chame getActivityRecognitionResult() para retornar um ActivityRecognitionResult em que você pode receber os dados reais da solicitação.

O exemplo a seguir mostra como receber a atividade detectada mais recente:

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

Para mais informações sobre o que você pode fazer com os dados de solicitação, consulte Receber dados de snapshot.