Geolocator.GetGeopositionHistoryAsync 메서드

정의

네임스페이스:

Windows.Devices.Geolocation

오버로드

GetGeopositionHistoryAsync(DateTime)	디바이스의 위치 기록을 검색하는 비동기 작업을 시작합니다. 참고 이 API는 모든 Windows 앱에서 사용할 수 없습니다. 개발자 계정이 Microsoft에서 특별히 프로비전되지 않는 한 런타임에 이러한 API에 대한 호출이 실패합니다.
GetGeopositionHistoryAsync(DateTime, TimeSpan)	디바이스의 위치 기록을 검색하는 비동기 작업을 시작합니다. 참고 이 API는 모든 Windows 앱에서 사용할 수 없습니다. 개발자 계정이 Microsoft에서 특별히 프로비전되지 않는 한 런타임에 이러한 API에 대한 호출이 실패합니다.

GetGeopositionHistoryAsync(DateTime)

디바이스의 위치 기록을 검색하는 비동기 작업을 시작합니다.

참고

이 API는 모든 Windows 앱에서 사용할 수 없습니다. 개발자 계정이 Microsoft에서 특별히 프로비전되지 않는 한 런타임에 이러한 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

위치를 반환할 시간 범위의 시작을 나타냅니다.

반환

IAsyncOperation<IVectorView<Geoposition>>

IAsyncOperation<IReadOnlyList<Geoposition>>

지정된 시간 범위 동안 수집된 위치( 지리적 위치 형식)입니다.

특성

OverloadAttribute RemoteAsyncAttribute

Windows 요구 사항

앱 기능	locationHistory location

설명

GetGeopositionHistoryAsync 메서드를 사용하면 앱이 위치 서비스에서 수집한 위치 목록을 비동기적으로 가져올 수 있습니다. 지정된 startTime 이후 수집된 위치만 반환됩니다. 해당 시간 범위에서 사용할 수 있는 위치가 없으면 빈 목록이 반환됩니다.

이 메서드는 지난 24시간 동안 위치 서비스에서 이미 수집한 위치만 반환합니다. 새 위치를 resolve 않습니다. 이 24시간 기간을 초과하는 시간 범위를 지정해도 추가 위치는 생성되지 않습니다.

위치 서비스는 앱 또는 서비스가 사용자의 위치를 쿼리할 때만 위치를 수집하지만 초당 한 번 이상은 수집하지 않습니다. 위치 기록은 3600개 위치로 제한됩니다. 사용자가 위치 기록을 지우지 않으면 각 위치는 1~24시간 사이에 위치 기록에 저장됩니다.

참고

백그라운드 작업을 사용하여 이 메서드를 자주 호출하는 경우 배터리에 미치는 영향을 고려하는 것이 중요합니다. 이 메서드가 GPS 수신기를 트리거하지는 않지만 백그라운드 작업을 실행하려면 프로세서 리소스가 여전히 필요합니다.

추가 정보

• GetGeopositionHistoryAsync(DateTime, TimeSpan)
• 현재 위치 가져오기
• 지오펜스 설정
• 지리적 위치 샘플

GetGeopositionHistoryAsync(DateTime, TimeSpan)

디바이스의 위치 기록을 검색하는 비동기 작업을 시작합니다.

참고

이 API는 모든 Windows 앱에서 사용할 수 없습니다. 개발자 계정이 Microsoft에서 특별히 프로비전되지 않는 한 런타임에 이러한 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 이후의 시간을 나타냅니다.

반환

IAsyncOperation<IVectorView<Geoposition>>

IAsyncOperation<IReadOnlyList<Geoposition>>

지정된 시간 범위 동안 수집된 위치( 지리적 위치 형식)입니다.

특성

OverloadAttribute RemoteAsyncAttribute

Windows 요구 사항

앱 기능	locationHistory location

설명

startTime 이후 지정된 기간 동안 수집된 위치만 반환됩니다.

추가 정보

• GetGeopositionHistoryAsync(DateTime)
• 현재 위치 가져오기
• 지오펜스 설정
• 지리적 위치 샘플