Windows.Devices.Geolocation Ruang nama
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan API untuk mendapatkan lokasi saat ini atau melacak lokasi perangkat dari waktu ke waktu. Informasi lokasi mungkin berasal dari memperkirakan posisi dari suar seperti Wi-Fi titik akses dan menara sel, dari alamat IP perangkat, atau mungkin berasal dari sumber lain seperti perangkat GNSS atau GPS. API Windows.Devices.Geolocation menyediakan data geolokasi yang paling tepat dari semua sumber yang tersedia.
Akurasi informasi lokasi tergantung pada sumbernya. Garis lintang dan bujur dapat bervariasi dalam rentang berikut:
- GPS : dalam jarak sekitar 10 meter
- Wi-Fi : antara sekitar 30 meter dan 500 meter
- Menara sel : antara sekitar 300 meter dan 3.000 meter
- Alamat IP : antara sekitar 1.000 meter dan 5.000 meter
Selain garis lintang dan bujur, GPS juga memberikan informasi tentang judul, kecepatan, dan ketinggian. Informasi tambahan ini bersifat opsional ketika informasi lokasi berasal dari sumber lain.
Pengguna mengatur privasi data lokasi mereka dengan pengaturan privasi lokasi di aplikasi Pengaturan . Aplikasi Anda hanya dapat mengakses lokasi pengguna saat:
- Lokasi untuk perangkat ini...diaktifkan (tidak berlaku untuk Windows 10 Mobile)
- Pengaturan layanan lokasi, Lokasi, diaktifkan
- Di bawah Pilih aplikasi yang dapat menggunakan lokasi Anda, aplikasi Anda diatur ke aktif
Untuk informasi selengkapnya tentang privasi lokasi, lihat Pernyataan Privasi Windows.
Penting
Mulai dari Windows 10, panggil RequestAccessAsync 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 ke lokasi mereka, aplikasi Anda tidak dapat mengakses data lokasi.
Arsitektur layanan lokasi
Lapisan pertama arsitektur layanan lokasi terdiri dari perangkat keras di perangkat. Ini termasuk penerima GPS, Wi-Fi, dan radio seluler. Ini semua dapat berfungsi sebagai penyedia data lokasi dengan berbagai tingkat akurasi dan konsumsi daya. Di atas perangkat keras berada lapisan kode asli. Lapisan ini berkomunikasi langsung dengan sumber data lokasi yang tersedia dan memutuskan sumber mana yang akan digunakan untuk menentukan lokasi perangkat berdasarkan ketersediaan data dan pada persyaratan performa yang ditentukan oleh aplikasi. Lapisan kode asli juga berkomunikasi melalui Internet dengan layanan web yang dihosting Microsoft untuk mencari informasi terkait lokasi dari database. Lapisan atas layanan lokasi adalah antarmuka terkelola, diekspos melalui DLL yang disertakan dengan Windows SDK. Aplikasi menggunakan antarmuka ini untuk memulai dan menghentikan permintaan lokasi, untuk mengatur tingkat akurasi yang diperlukan oleh aplikasi, dan untuk menerima data lokasi dari lapisan kode asli saat tersedia.
Kelas
| CivicAddress |
API yang tidak didukung. |
| GeoboundingBox |
Mewakili persegi panjang yang mendefinisikan area geografis. |
| Geocircle |
Menjelaskan lingkaran geografis dengan titik tengah dan radius. |
| Geocoordinate |
Berisi informasi untuk mengidentifikasi lokasi geografis. |
| GeocoordinateSatelliteData |
Menyediakan informasi tambahan tentang Geocoordinate. Informasi ini hanya berlaku untuk perkiraan posisi yang diperoleh menggunakan sinyal satelit. |
| Geolocator |
Menyediakan akses ke lokasi geografis saat ini. |
| Geopath |
Mewakili serangkaian titik geografis yang diurutkan. |
| Geopoint |
Menjelaskan titik geografis. |
| Geoposition |
Mewakili lokasi yang mungkin berisi data lintang dan bujur atau data tempat. |
| Geovisit |
Mewakili perubahan status terkait Kunjungan. Lihat Panduan untuk menggunakan pelacakan Kunjungan untuk informasi tentang cara menggunakan fitur ini. |
| GeovisitMonitor |
Menangani pemantauan Kunjungan pengguna saat aplikasi sedang digunakan (bukan di latar belakang). |
| GeovisitStateChangedEventArgs |
Berisi informasi tentang peristiwa VisitStateChanged . |
| GeovisitTriggerDetails |
Mengelola detail pemicu untuk tugas latar belakang terkait Kunjungan. |
| PositionChangedEventArgs |
Menyediakan data untuk peristiwa PositionChanged . |
| StatusChangedEventArgs |
Menyediakan informasi untuk peristiwa StatusChanged . |
| VenueData |
Mewakili tempat yang terkait dengan lokasi geografis. |
Struct
| BasicGeoposition |
Informasi dasar untuk menjelaskan posisi geografis. |
Antarmuka
| IGeoshape |
Antarmuka untuk menentukan bentuk geografis. |
Enum
| AltitudeReferenceSystem |
Menunjukkan sistem referensi ketinggian yang akan digunakan dalam menentukan bentuk geografis. |
| GeolocationAccessStatus |
Menunjukkan apakah aplikasi Anda memiliki izin untuk mengakses data lokasi. |
| GeoshapeType |
Menunjukkan bentuk wilayah geografis. |
| PositionAccuracy |
Menunjukkan tingkat akurasi yang diminta untuk data lokasi yang digunakan aplikasi. |
| PositionSource |
Menunjukkan sumber yang digunakan untuk mendapatkan Geocoordinate. |
| PositionStatus |
Menunjukkan kemampuan objek Geolocator untuk menyediakan data lokasi. |
| VisitMonitoringScope |
Berisi nilai yang menjelaskan cakupan pemantauan lokasi yang dimaksudkan untuk digunakan dengan fitur Kunjungan. |
| VisitStateChange |
Berisi nilai yang menjelaskan perubahan status terkait Kunjungan. |
Contoh
Aplikasi sampel yang menggunakan kelas dari namespace ini mencakup sampel Geolokasi dan sampel Geotag.