Geolocator.GetGeopositionHistoryAsync Método

Referencia

Definición

Espacio de nombres:: Windows.Devices.Geolocation

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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)

Editar

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

IAsyncOperation<IVectorView<Geoposition>>

IAsyncOperation<IReadOnlyList<Geoposition>>

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

Atributos: OverloadAttribute RemoteAsyncAttribute

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)

Editar

Inicia una operación asincrónica para recuperar el historial de ubicación 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))