Geolocator.GetGeopositionAsync Metode

Definisi

Ruang nama:

Windows.Devices.Geolocation

Overload

GetGeopositionAsync()	Memulai operasi asinkron untuk mengambil lokasi perangkat saat ini.
GetGeopositionAsync(TimeSpan, TimeSpan)	Memulai operasi asinkron untuk mengambil lokasi perangkat saat ini.

GetGeopositionAsync()

Memulai operasi asinkron untuk mengambil lokasi perangkat saat ini.

public:
 virtual IAsyncOperation<Geoposition ^> ^ GetGeopositionAsync() = GetGeopositionAsync;

/// [Windows.Foundation.Metadata.Overload("GetGeopositionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<Geoposition> GetGeopositionAsync();

[Windows.Foundation.Metadata.Overload("GetGeopositionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<Geoposition> GetGeopositionAsync();

function getGeopositionAsync()

Public Function GetGeopositionAsync () As IAsyncOperation(Of Geoposition)

Mengembalikan

IAsyncOperation<Geoposition>

Operasi asinkron yang, setelah selesai, mengembalikan Geoposisi yang menandai lokasi yang ditemukan.

Atribut

OverloadAttribute RemoteAsyncAttribute

Persyaratan Windows

Kemampuan aplikasi

location ID_CAP_LOCATION [Windows Phone]

Keterangan

Metode ini memberikan pengecualian jika aplikasi tidak memiliki izin lokasi atau jika waktunya habis tanpa data lokasi yang diambil. Oleh karena itu, metode harus dipanggil dalam pernyataan try/catch sehingga kasus pengecualian umum ini dapat ditangani.

Metode ini kehabisan waktu setelah 60 detik, kecuali saat dalam Siaga Tersambung. Selama Siaga Terhubung, objek Geolocator dapat dibuat tetapi objek Geolocator tidak akan menemukan sensor apa pun untuk diagregasi dan panggilan ke GetGeopositionAsync akan kehabisan waktu setelah 7 detik. Setelah waktu habis, pendengar peristiwa StatusChanged akan dipanggil sekali dengan status NoData , dan listener peristiwa PositionChanged tidak akan pernah dipanggil.

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

Penting

Mulai dari Windows 10, panggil metode RequestAccessAsync sebelum mengakses lokasi pengguna. Pada saat itu, aplikasi Anda harus berada di latar depan dan RequestAccessAsync harus dipanggil dari utas UI. Aplikasi Anda kemudian dapat menangani kasus tanpa izin tanpa melemparkan pengecualian.

Lihat juga

• Geoposition
• Geocoordinate
• GetGeopositionAsync(TimeSpan, TimeSpan)
• Dapatkan lokasi saat ini
• sampel geolokasi

GetGeopositionAsync(TimeSpan, TimeSpan)

Memulai operasi asinkron untuk mengambil lokasi perangkat saat ini.

public:
 virtual IAsyncOperation<Geoposition ^> ^ GetGeopositionAsync(TimeSpan maximumAge, TimeSpan timeout) = GetGeopositionAsync;

/// [Windows.Foundation.Metadata.Overload("GetGeopositionAsyncWithAgeAndTimeout")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<Geoposition> GetGeopositionAsync(TimeSpan const& maximumAge, TimeSpan const& timeout);

[Windows.Foundation.Metadata.Overload("GetGeopositionAsyncWithAgeAndTimeout")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<Geoposition> GetGeopositionAsync(System.TimeSpan maximumAge, System.TimeSpan timeout);

function getGeopositionAsync(maximumAge, timeout)

Public Function GetGeopositionAsync (maximumAge As TimeSpan, timeout As TimeSpan) As IAsyncOperation(Of Geoposition)

Parameter

maximumAge

TimeSpan TimeSpan

Usia maksimum data lokasi cache yang dapat diterima. TimeSpan adalah periode waktu yang dinyatakan dalam unit 100 nanodetik.

timeout

TimeSpan TimeSpan

Waktu habis. TimeSpan adalah periode waktu yang dinyatakan dalam unit 100 nanodetik.

Mengembalikan

IAsyncOperation<Geoposition>

Operasi asinkron yang, setelah selesai, mengembalikan Geoposisi yang menandai lokasi yang ditemukan.

Atribut

OverloadAttribute RemoteAsyncAttribute

Persyaratan Windows

Kemampuan aplikasi

location ID_CAP_LOCATION [Windows Phone]

Keterangan

Lokasi akan segera dikembalikan jika lokasi terbaru berada dalam usia yang dapat diterima. Jika tidak, lokasi tidak akan dikembalikan hingga perubahan berikutnya. Dalam beberapa kasus, aplikasi Anda mungkin menerima data lokasi yang lebih lama dari nilai maximumAge yang ditentukan. Ini karena nilai usia tambahan akan dihitung berdasarkan pengaturan akurasi yang diinginkan, dan aplikasi Anda akan menggunakan mana pun dari dua usia yang lebih besar. Misalnya, katakanlah akurasi default 500 meter sesuai dengan usia maksimum 30 detik. Dalam hal ini, aplikasi Anda dapat menerima data lama 20 detik meskipun Anda mengatur maximumAge menjadi 10 detik.

Lihat juga

• Geoposition
• Geocoordinate
• GetGeopositionAsync()
• Dapatkan lokasi saat ini
• Menyiapkan geofence
• sampel geolokasi