Поделиться через


Geolocator.GetGeopositionHistoryAsync Метод

Определение

Перегрузки

GetGeopositionHistoryAsync(DateTime)

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

Примечание

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

GetGeopositionHistoryAsync(DateTime, TimeSpan)

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

Примечание

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

GetGeopositionHistoryAsync(DateTime)

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

Примечание

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

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

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

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

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

Атрибуты

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

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

Комментарии

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

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

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

Примечание

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

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

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

GetGeopositionHistoryAsync(DateTime, TimeSpan)

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

Примечание

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

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

Параметры

startTime
DateTime DateTimeOffset

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

duration
TimeSpan TimeSpan

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

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

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

Атрибуты

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

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

Комментарии

Будут возвращены только те позиции, которые были собраны в течение указанного периода послеstartTime .

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

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