Compartir a través de


Geolocator.GetGeopositionHistoryAsync Método

Definición

Sobrecargas

GetGeopositionHistoryAsync(DateTime)

Inicia una operación asincrónica para recuperar el historial de ubicación del dispositivo.

Nota:

Esta API no está disponible para todas las aplicaciones de Windows. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.

GetGeopositionHistoryAsync(DateTime, TimeSpan)

Inicia una operación asincrónica para recuperar el historial de ubicación del dispositivo.

Nota:

Esta API no está disponible para todas las aplicaciones de Windows. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.

GetGeopositionHistoryAsync(DateTime)

Inicia una operación asincrónica para recuperar el historial de ubicación del dispositivo.

Nota:

Esta API no está disponible para todas las aplicaciones de Windows. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.

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))

Parámetros

startTime
DateTime DateTimeOffset

Representa el principio del intervalo de tiempo para el que se devolverán las posiciones.

Devoluciones

Posiciones (de tipo Geoposition) que se recopilaron durante el intervalo de tiempo especificado.

Atributos

Requisitos de Windows

Características de aplicaciones
locationHistory location

Comentarios

El método GetGeopositionHistoryAsync permite a la aplicación capturar de forma asincrónica una lista de posiciones recopiladas por los servicios de ubicación. Solo se devolverán las posiciones recopiladas desde el valor de startTime especificado. Si no hay ninguna posición disponible desde ese intervalo de tiempo, se devolverá una lista vacía.

Este método devuelve solo las posiciones que ya han sido recopiladas por los servicios de ubicación en las últimas 24 horas; no resuelve nuevas posiciones. Si se especifica un intervalo de tiempo que supere esta ventana de 24 horas, no se producirán posiciones adicionales.

Los servicios de ubicación recopilan posiciones solo cuando una aplicación o servicios consulta la ubicación del usuario, pero no más de una vez por segundo. El historial de ubicaciones está limitado a 3600 posiciones; Si el usuario no borra el historial de ubicaciones, cada posición se almacenará en el historial de ubicaciones entre 1 y 24 horas.

Nota:

Si usa una tarea en segundo plano para llamar a este método con frecuencia, es importante tener en cuenta el impacto que tendrá en la batería. Aunque este método no desencadena el receptor GPS, los recursos del procesador siguen siendo necesarios para ejecutar la tarea en segundo plano.

Consulte también

Se aplica a

GetGeopositionHistoryAsync(DateTime, TimeSpan)

Inicia una operación asincrónica para recuperar el historial de ubicación del dispositivo.

Nota:

Esta API no está disponible para todas las aplicaciones de Windows. A menos que Microsoft aprovisione especialmente la cuenta de desarrollador, se producirá un error en las llamadas a estas API en tiempo de ejecución.

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))

Parámetros

startTime
DateTime DateTimeOffset

Representa el principio del intervalo de tiempo para el que se devolverán las posiciones.

duration
TimeSpan TimeSpan

Representa el período de tiempo después de startTime para el que se devolverán las posiciones.

Devoluciones

Posiciones (de tipo Geoposition) que se recopilaron durante el intervalo de tiempo especificado.

Atributos

Requisitos de Windows

Características de aplicaciones
locationHistory location

Comentarios

Solo se devolverán las posiciones recopiladas durante la duración especificada después de startTime .

Consulte también

Se aplica a