Geolocator.GetGeopositionHistoryAsync Metodo

Riferimento

Definizione

Spazio dei nomi:: Windows.Devices.Geolocation

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Overload

GetGeopositionHistoryAsync(DateTime)	Avvia un'operazione asincrona per recuperare la cronologia della posizione del dispositivo. Nota Questa API non è disponibile per tutte le app di Windows. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.
GetGeopositionHistoryAsync(DateTime, TimeSpan)	Avvia un'operazione asincrona per recuperare la cronologia della posizione del dispositivo. Nota Questa API non è disponibile per tutte le app di Windows. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.

GetGeopositionHistoryAsync(DateTime)

Modifica

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

Nota

Questa API non è disponibile per tutte le app di Windows. A meno che il provisioning dell'account per sviluppatore non venga effettuato appositamente da Microsoft, le chiamate a queste API avranno esito negativo in fase di esecuzione.

public:
 static IAsyncOperation<IVectorView<Geoposition ^> ^> ^ GetGeopositionHistoryAsync(DateTime startTime);

/// [Windows.Foundation.Metadata.Overload("GetGeopositionHistoryAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<IVectorView<Geoposition>> GetGeopositionHistoryAsync(DateTime const& startTime);

[Windows.Foundation.Metadata.Overload("GetGeopositionHistoryAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<IReadOnlyList<Geoposition>> GetGeopositionHistoryAsync(System.DateTimeOffset startTime);

function getGeopositionHistoryAsync(startTime)

Public Shared Function GetGeopositionHistoryAsync (startTime As DateTimeOffset) As IAsyncOperation(Of IReadOnlyList(Of Geoposition))

Parametri

startTime: DateTime DateTimeOffset

Rappresenta l'inizio dell'intervallo di tempo per cui devono essere restituite le posizioni.

Restituisce

IAsyncOperation<IVectorView<Geoposition>>

IAsyncOperation<IReadOnlyList<Geoposition>>

Posizioni (di tipo Geoposition) raccolte durante l'intervallo di tempo specificato.

Attributi: OverloadAttribute RemoteAsyncAttribute

Requisiti Windows

Funzionalità dell'app

locationHistory location

Commenti

Il metodo GetGeopositionHistoryAsync consente all'app di recuperare in modo asincrono un elenco di posizioni raccolte dai servizi di posizione. Verranno restituite solo le posizioni raccolte dopo il valore startTime specificato. Se non sono disponibili posizioni da tale intervallo di tempo, verrà restituito un elenco vuoto.

Questo metodo restituisce solo le posizioni già raccolte dai servizi di posizione nelle ultime 24 ore; non risolve nuove posizioni. Se si specifica un intervallo di tempo superiore a questa finestra di 24 ore, non verranno restituite posizioni aggiuntive.

I servizi di posizione raccolgono le posizioni solo quando un'app o servizi esegue query sulla posizione dell'utente, ma non più di una volta al secondo. La cronologia delle posizioni è limitata a 3600 posizioni; se la cronologia della posizione non viene cancellata dall'utente, ogni posizione verrà archiviata nella cronologia delle posizioni tra 1 e 24 ore.

Nota

Se si usa un'attività in background per chiamare spesso questo metodo, è importante considerare l'impatto che avrà sulla batteria. Anche se questo metodo non attiva il ricevitore GPS, le risorse del processore sono ancora necessarie per eseguire l'attività in background.

Vedi anche

Si applica a

GetGeopositionHistoryAsync(DateTime, TimeSpan)

Modifica

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

Nota

public:
 static IAsyncOperation<IVectorView<Geoposition ^> ^> ^ GetGeopositionHistoryAsync(DateTime startTime, TimeSpan duration);

/// [Windows.Foundation.Metadata.Overload("GetGeopositionHistoryWithDurationAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<IVectorView<Geoposition>> GetGeopositionHistoryAsync(DateTime const& startTime, TimeSpan const& duration);

[Windows.Foundation.Metadata.Overload("GetGeopositionHistoryWithDurationAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<IReadOnlyList<Geoposition>> GetGeopositionHistoryAsync(System.DateTimeOffset startTime, System.TimeSpan duration);

function getGeopositionHistoryAsync(startTime, duration)

Public Shared Function GetGeopositionHistoryAsync (startTime As DateTimeOffset, duration As TimeSpan) As IAsyncOperation(Of IReadOnlyList(Of Geoposition))