Geolocator.GetGeopositionHistoryAsync Метод

Ссылка

Определение

Пространство имен:: Windows.Devices.Geolocation

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Перегрузки

GetGeopositionHistoryAsync(DateTime)

Запускает асинхронную операцию для получения журнала расположения устройства.

Примечание

Этот API доступен не для всех приложений Windows. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.

GetGeopositionHistoryAsync(DateTime, TimeSpan)

Запускает асинхронную операцию для получения журнала расположения устройства.

Примечание

GetGeopositionHistoryAsync(DateTime)

Изменить

Запускает асинхронную операцию для получения журнала расположения устройства.

Примечание

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

Параметры

startTime: DateTime DateTimeOffset

Представляет начало интервала времени, для которого должны быть возвращены позиции.

Возвращаемое значение

IAsyncOperation<IVectorView<Geoposition>>

IAsyncOperation<IReadOnlyList<Geoposition>>

Позиции (типа Geoposition), собранные в течение указанного периода времени.

Атрибуты: OverloadAttribute RemoteAsyncAttribute

Требования к Windows

Возможности приложения

locationHistory location

Метод GetGeopositionHistoryAsync позволяет приложению асинхронно получать список позиций, собранных службами определения местоположения. Будут возвращены только позиции, собранные с момента указанного startTime . Если за этот период времени нет доступных позиций, возвращается пустой список.

Этот метод возвращает только те позиции, которые уже были собраны службами определения местоположения за последние 24 часа; он не разрешает новые позиции. Указание интервала времени, превышающего этот 24-часовой период, не приведет к получению дополнительных позиций.

Службы определения местоположения собирают позиции только в том случае, если приложение или службы запрашивают расположение пользователя, но не более одного раза в секунду. Журнал расположения ограничен 3600 позициями; Если пользователь не очищает журнал расположения, каждая позиция будет храниться в журнале расположения от 1 до 24 часов.

Примечание

Если вы используете фоновую задачу для частого вызова этого метода, важно учитывать влияние, которое окажет на батарею. Хотя этот метод не активирует приемник GPS, ресурсы процессора по-прежнему необходимы для выполнения фоновой задачи.

См. также раздел

Применяется к

GetGeopositionHistoryAsync(DateTime, TimeSpan)

Изменить

Запускает асинхронную операцию для получения журнала расположения устройства.

Примечание

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