Bagikan melalui


Windows.Devices.Geolocation Ruang nama

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.

Lihat juga