Geolocator.GetGeopositionAsync Metodo

Definizione

Overload

GetGeopositionAsync()

Avvia un'operazione asincrona per recuperare la posizione corrente del dispositivo.

GetGeopositionAsync(TimeSpan, TimeSpan)

Avvia un'operazione asincrona per recuperare la posizione corrente del dispositivo.

GetGeopositionAsync()

Avvia un'operazione asincrona per recuperare la posizione corrente del dispositivo.

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)

Restituisce

Un'operazione asincrona che, al completamento, restituisce un oggetto Geoposition che contrassegna la posizione trovata.

Attributi

Requisiti Windows

Funzionalità dell'app
location ID_CAP_LOCATION [Windows Phone]

Commenti

Questo metodo genera un'eccezione se l'app non dispone delle autorizzazioni di posizione o se si verifica il timeout senza dati di posizione recuperati. Pertanto, il metodo deve essere chiamato all'interno di un'istruzione try/catch in modo che questi casi di eccezione comuni possano essere gestiti.

Questo metodo si verifica il timeout dopo 60 secondi, tranne quando è in standby connesso. Durante lo standby connesso, è possibile creare un'istanza degli oggetti Geolocator , ma l'oggetto Geolocator non troverà sensori da aggregare e le chiamate a GetGeopositionAsync si verificaranno dopo 7 secondi. Al timeout, i listener di eventi StatusChanged verranno chiamati una volta con lo stato NoData e i listener di eventi PositionChanged non verranno mai chiamati.

L'utente imposta la privacy dei dati relativi alla posizione tramite le impostazioni di privacy per la posizione nell'app Impostazioni. La tua app può accedere alla posizione dell'utente solo quando:

  • Posizione per questo dispositivo... è attivato (non applicabile a Windows 10 Mobile)
  • L’impostazione dei servizi di posizione, Posizione, è attivata
  • In Scegli le app che possono usare la tua posizione, la tua app è attivata

Importante

A partire da Windows 10, chiamare il metodo RequestAccessAsync prima di accedere alla posizione dell'utente. A questo punto, l’app deve essere in primo piano e RequestAccessAsync deve essere chiamato dal thread dell’interfaccia utente. L'app può quindi gestire il caso senza autorizzazioni senza generare un'eccezione.

Vedi anche

Si applica a

GetGeopositionAsync(TimeSpan, TimeSpan)

Avvia un'operazione asincrona per recuperare la posizione corrente del dispositivo.

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)

Parametri

maximumAge
TimeSpan TimeSpan

Validità massima accettabile dei dati di posizione memorizzati nella cache. TimeSpan è un periodo di tempo espresso in unità di 100 nanosecondi.

timeout
TimeSpan TimeSpan

Timeout. TimeSpan è un periodo di tempo espresso in unità di 100 nanosecondi.

Restituisce

Un'operazione asincrona che, al completamento, restituisce un oggetto Geoposition che contrassegna la posizione trovata.

Attributi

Requisiti Windows

Funzionalità dell'app
location ID_CAP_LOCATION [Windows Phone]

Commenti

Una posizione verrà restituita immediatamente se la posizione più recente rientra in un'età accettabile. In caso contrario, non verrà restituita una posizione fino alla modifica successiva. In alcuni casi, l'app può ricevere dati sulla posizione precedenti al valore maximumAge specificato. Questo perché verrà calcolato un valore di età aggiuntivo in base all'impostazione di accuratezza desiderata e l'app userà qualsiasi delle due età sia maggiore. Ad esempio, si supponga che un'accuratezza predefinita di 500 metri corrisponda a un'età massima di 30 secondi. In questo caso, l'app potrebbe ricevere 20 secondi di dati precedenti anche se si imposta maximumAge su 10 secondi.

Vedi anche

Si applica a