Обзор API моментальных снимков

Уведомление об устаревании: контекстные сигналы мест и погоды

Предупреждение: контекстные сигналы Places и Weather, предоставляемые методами getPlaces() и getWeather() , устарели.

• Контекстный сигнал Places был отключен. Дальнейшее использование этого сигнала было ограничено для клиентов с существующими реализациями до 30 октября 2019 года. Новые реализации должны использовать Places SDK для Android вместо контекстного сигнала Places.
• Контекстный сигнал погоды также был отключен. Продолжение использования этого сигнала было ограничено для клиентов с существующими реализациями до 31 января 2020 года. Google не предлагает альтернативную функциональность для контекстного сигнала погоды.

Вы можете использовать API Snapshot для получения информации о текущей среде пользователя. С API Snapshot вы можете получить доступ к различным контекстным сигналам :

• Обнаруженная активность пользователя, например, когда он идет или едет на машине.
• Зарегистрированные вами маяки поблизости.
• Состояние наушников, подключены они или нет.
• Местоположение, включающее широту и долготу.

Система кэширует эти значения, чтобы их можно было быстро вернуть. Если данных нет, выполняется зондирование и вывод для возврата новых значений состояния. API Awareness возвращает существующий тип данных для типов контекста, имеющих общедоступный API.

Каждый контекстный сигнал имеет соответствующий метод API Snapshot. Например, чтобы получить текущую обнаруженную активность, вы вызываете getDetectedActivity() , используете SuccessListener для получения DetectedActivityResponse , затем вызываете getActivityRecognitionResult() чтобы вернуть ActivityRecognitionResult из которого вы можете получить фактические данные запроса.

В следующем примере показано, как получить последнюю обнаруженную активность:

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

Дополнительную информацию о том, что можно сделать с данными запроса, см. в разделе Получение данных моментального снимка .