Geolocator.GetGeopositionHistoryAsync Método

Referência

Definição

Namespace:: Windows.Devices.Geolocation

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

GetGeopositionHistoryAsync(DateTime)	Inicia uma operação assíncrona para recuperar o histórico de localização do dispositivo. Observação Essa API não está disponível para todos os aplicativos do Windows. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.
GetGeopositionHistoryAsync(DateTime, TimeSpan)	Inicia uma operação assíncrona para recuperar o histórico de localização do dispositivo. Observação Essa API não está disponível para todos os aplicativos do Windows. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.

GetGeopositionHistoryAsync(DateTime)

Editar

Inicia uma operação assíncrona para recuperar o histórico de localização do dispositivo.

Observação

Essa API não está disponível para todos os aplicativos do Windows. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime.

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 o início do período de tempo para o qual as posições devem ser retornadas.

Retornos

IAsyncOperation<IVectorView<Geoposition>>

IAsyncOperation<IReadOnlyList<Geoposition>>

Posições (do tipo Geoposition) que foram coletadas durante o período de tempo especificado.

Atributos: OverloadAttribute RemoteAsyncAttribute

Requisitos do Windows

Funcionalidades do aplicativo

locationHistory location

Comentários

O método GetGeopositionHistoryAsync permite que seu aplicativo busque de forma assíncrona uma lista de posições que foram coletadas pelos serviços de localização. Somente as posições coletadas desde o startTime especificado serão retornadas. Se nenhuma posição estiver disponível nesse período de tempo, uma lista vazia será retornada.

Esse método retorna apenas as posições que já foram coletadas pelos serviços de localização nas últimas 24 horas; ele não resolve novas posições. Especificar um período de tempo que exceda essa janela de 24 horas não produzirá nenhuma posição adicional.

Os serviços de localização coletam posições somente quando um aplicativo ou serviços consulta a localização do usuário , mas não mais de uma vez por segundo. O histórico de localização é limitado a 3600 posições; se o histórico de localização não for limpo pelo usuário, cada posição será armazenada no histórico de localização entre 1 e 24 horas.

Observação

Se você usar uma tarefa em segundo plano para chamar esse método com frequência, é importante considerar o impacto que terá na bateria. Embora esse método não dispare o receptor GPS, os recursos do processador ainda são necessários para executar a tarefa em segundo plano.

Confira também

Aplica-se a

GetGeopositionHistoryAsync(DateTime, TimeSpan)

Editar

Inicia uma operação assíncrona para recuperar o histórico de localização do dispositivo.

Observação

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