Windows.Devices.Geolocation.Geofencing Ruang nama

Geofence adalah area virtual di sekitar titik geografis. API geofencing memungkinkan aplikasi untuk memberikan pengalaman kontekstual geografis secara tepat waktu tanpa perlu aplikasi terus berjalan dan menggunakan sumber daya perangkat. Geofencing memungkinkan skenario seperti memunculkan pengingat untuk pengguna ketika mereka meninggalkan kantor atau rumah atau menampilkan kupon ketika pengguna berada dalam jangkauan toko.

Aplikasi menentukan area yang diminati (geofence) dan kondisi pemicu yang sesuai, seperti memicu saat pengguna memasuki atau keluar dari geofence. Akhirnya, aplikasi mendaftar untuk diberi tahu ketika kondisi pemicu terpenuhi. Windows dan Windows Phone mendukung ratusan geofence per aplikasi. Sistem operasi secara efisien mengelola pelacakan geofence untuk semua aplikasi. Ketika kondisi pemicu untuk satu atau beberapa geofence terpenuhi, aplikasi terkait diperingatkan bahkan ketika tidak berjalan secara aktif. Sistem pelacakan geofence adaptif berkapasitas tinggi ini memungkinkan Anda untuk dengan cepat dan mudah menambahkan fungsionalitas yang dipicu lokasi ke aplikasi Anda.

Untuk panduan lengkap tentang menggunakan geofencing, lihat Geofencing, mulai selesai.

API geofencing memungkinkan aplikasi Anda melakukan hal berikut:

• Buat satu atau beberapa geofence, atau area yang diminati.
• Permintaan untuk diberi tahu saat perangkat memasuki geofence.
• Permintaan untuk diberi tahu ketika perangkat meninggalkan geofence.
• Tentukan jendela waktu tempat geofence aktif.
• Tentukan waktu tinggal untuk setiap geofence - jumlah waktu perangkat harus masuk atau keluar dari geofence sebelum pemberitahuan dipicu.
• Tambahkan dan hapus geofence secara dinamis dari kumpulan geofence yang dipantau aplikasi Anda.
• Menerima peristiwa geofence saat aplikasi aktif.
• Daftar dengan sistem agar tugas latar belakang diluncurkan saat status salah satu geofence aplikasi Anda berubah. Aplikasi harus memanggil RequestAccessAsync sebelum tugas latar belakang apa pun akan berjalan.
• Gunakan simulator untuk mensimulasikan pergerakan perangkat dan menguji fitur geofencing aplikasi Anda.

Jika Anda ingin aplikasi diluncurkan di latar belakang saat kondisi pemicu untuk salah satu geofence-nya terpenuhi, Anda perlu menggunakan tugas latar belakang dan menyiapkan LocationTrigger untuk meluncurkannya.

Penting

Mulai dari Windows 10, panggil metode RequestAccessAsync objek Geolocator sebelum mengakses lokasi pengguna. Pada saat itu, aplikasi Anda harus berada di latar depan dan RequestAccessAsync harus dipanggil dari utas UI. Hingga pengguna memberikan izin aplikasi Anda untuk mengakses lokasi mereka, aplikasi Anda tidak dapat mengakses data lokasi.

Kelas

Geofence	Berisi fungsionalitas untuk menentukan geofence (area geografis yang menarik) untuk dipantau.
GeofenceMonitor	Berisi informasi tentang objek Geofence yang dipantau.
GeofenceStateChangeReport	Berisi informasi tentang perubahan status untuk Geofence.

Enum

GeofenceMonitorStatus	Menunjukkan status GeofenceMonitor saat ini.
GeofenceRemovalReason	Menunjukkan alasan Geofence dihapus.
GeofenceState	Menunjukkan status Geofence saat ini.
MonitoredGeofenceStates	Menunjukkan status atau status Geofence yang saat ini sedang dipantau oleh sistem.

Keterangan

Layanan lokasi harus berjalan agar geofencing berfungsi. Jika layanan ini dinonaktifkan, panggilan geofencing akan gagal dan melemparkan pengecualian.

Aplikasi Anda harus mendeklarasikan kemampuan lokasi dalam manifes aplikasi untuk menggunakan geofencing.