نمای کلی API Snapshot

اطلاعیه منسوخ شدن: مکان ها و سیگنال های متنی آب و هوا

هشدار: سیگنال‌های متنی Places و Weather که توسط متدهای getPlaces() و getWeather() در معرض نمایش قرار می‌گرفتند، منسوخ شدند.

• سیگنال متنی Places خاموش شد. ادامه استفاده از این سیگنال تا 30 اکتبر 2019 به مشتریان دارای پیاده‌سازی‌های موجود محدود شد. پیاده‌سازی‌های جدید باید از Places SDK برای Android به جای سیگنال متنی Places استفاده کنند.
• سیگنال متنی آب و هوا نیز خاموش شده است. استفاده مستمر از این سیگنال تا 31 ژانویه 2020 به مشتریانی که پیاده‌سازی‌های موجود را دارند محدود شده است. Google عملکرد جایگزینی برای سیگنال متنی Weather ارائه نمی‌کند.

می توانید از Snapshot API برای دریافت اطلاعات در مورد محیط فعلی کاربر استفاده کنید. با Snapshot API، می توانید به انواع سیگنال های زمینه دسترسی داشته باشید:

• فعالیت کاربر شناسایی شده، مانند زمانی که آنها راه می روند یا رانندگی می کنند.
• چراغ‌های نزدیکی که ثبت کرده‌اید.
• وضعیت هدفون، وصل شده یا نه.
• موقعیت مکانی که شامل طول و عرض جغرافیایی می شود.

سیستم این مقادیر را در حافظه پنهان ذخیره می کند تا بتوان آنها را به سرعت بازگرداند. اگر داده ای وجود نداشته باشد، سنجش و استنتاج برای برگرداندن مقادیر حالت تازه انجام می شود. Awareness API نوع داده موجود را برای انواع زمینه که دارای API عمومی هستند، برمی گرداند.

هر سیگنال زمینه دارای یک روش Snapshot API مربوطه است. به عنوان مثال، برای دریافت اکتیویتی شناسایی شده فعلی، getDetectedActivity() را فراخوانی کنید، از SuccessListener برای دریافت DetectedActivityResponse استفاده کنید، سپس getActivityRecognitionResult() را فراخوانی کنید تا یک ActivityRecognitionResult که از آن می توانید داده های درخواست واقعی را دریافت کنید.

مثال زیر نحوه دریافت آخرین فعالیت شناسایی شده را نشان می دهد:

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

برای اطلاعات بیشتر در مورد آنچه که می‌توانید با داده‌های درخواست انجام دهید، به دریافت داده‌های عکس فوری مراجعه کنید.