Windows.Devices.Geolocation Ruang nama

Referensi

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.

Edit

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.