다음을 통해 공유

Geolocator.GetGeopositionAsync 메서드

  • 참조

정의

네임스페이스:
Windows.Devices.Geolocation

오버로드

GetGeopositionAsync()

디바이스의 현재 위치를 검색하는 비동기 작업을 시작합니다.
GetGeopositionAsync(TimeSpan, TimeSpan)

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

GetGeopositionAsync()

편집

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

public:
 virtual IAsyncOperation<Geoposition ^> ^ GetGeopositionAsync() = GetGeopositionAsync;
/// [Windows.Foundation.Metadata.Overload("GetGeopositionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<Geoposition> GetGeopositionAsync();
[Windows.Foundation.Metadata.Overload("GetGeopositionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<Geoposition> GetGeopositionAsync();
function getGeopositionAsync()
Public Function GetGeopositionAsync () As IAsyncOperation(Of Geoposition)

반환

IAsyncOperation<Geoposition>

완료 시 찾은 위치를 표시하는 지리적 위치를 반환하는 비동기 작업입니다.

특성
OverloadAttribute RemoteAsyncAttribute

Windows 요구 사항

앱 기능
location ID_CAP_LOCATION [Windows Phone]

설명

이 메서드는 앱에 위치 권한이 없거나 위치 데이터를 검색하지 않고 시간 초과된 경우 예외를 throw합니다. 따라서 이러한 일반적인 예외 사례를 처리할 수 있도록 try/catch 문 내에서 메서드를 호출해야 합니다.

이 메서드는 연결된 대기 상태인 경우를 제외하고 60초 후에 시간 초과됩니다. 연결된 대기 중에 Geolocator 개체를 인스턴스화할 수 있지만 Geolocator 개체는 집계할 센서를 찾을 수 없으며 GetGeopositionAsync에 대한 호출은 7초 후에 시간이 초과됩니다. 시간이 초과되면 NoData 상태 StatusChanged 이벤트 수신기가 한 번 호출되고 PositionChanged 이벤트 수신기는 호출되지 않습니다.

사용자는 설정 앱의 위치 개인 정보 설정에서 자신의 위치 데이터 개인 정보를 설정합니다. 앱은 다음 경우에만 사용자의 위치에 액세스할 수 있습니다.

  • 이 디바이스의 위치... 가 켜져 있습니다(Windows 10 Mobile 적용할 수 없음)
  • 위치 서비스 설정 위치가 켜짐 상태임
  • 사용자의 위치를 사용할 수 있는 앱 선택에서 앱이 on 상태임

중요

Windows 10 사용자의 위치에 액세스하기 전에 RequestAccessAsync 메서드를 호출합니다. 이때 앱이 포그라운드에 있어야 하고 RequestAccessAsync가 UI 스레드에서 호출되어야 합니다. 그러면 앱에서 예외를 throw하지 않고 사용 권한 없는 사례를 처리할 수 있습니다.

추가 정보

적용 대상

GetGeopositionAsync(TimeSpan, TimeSpan)

편집

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

public:
 virtual IAsyncOperation<Geoposition ^> ^ GetGeopositionAsync(TimeSpan maximumAge, TimeSpan timeout) = GetGeopositionAsync;
/// [Windows.Foundation.Metadata.Overload("GetGeopositionAsyncWithAgeAndTimeout")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<Geoposition> GetGeopositionAsync(TimeSpan const& maximumAge, TimeSpan const& timeout);
[Windows.Foundation.Metadata.Overload("GetGeopositionAsyncWithAgeAndTimeout")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<Geoposition> GetGeopositionAsync(System.TimeSpan maximumAge, System.TimeSpan timeout);
function getGeopositionAsync(maximumAge, timeout)
Public Function GetGeopositionAsync (maximumAge As TimeSpan, timeout As TimeSpan) As IAsyncOperation(Of Geoposition)

매개 변수

maximumAge
TimeSpan TimeSpan

캐시된 위치 데이터의 최대 허용 기간입니다. TimeSpan은 100나노초 단위로 표현된 기간입니다.

timeout
TimeSpan TimeSpan

시간 초과입니다. TimeSpan은 100나노초 단위로 표현된 기간입니다.

반환

IAsyncOperation<Geoposition>

완료 시 찾은 위치를 표시하는 지리적 위치를 반환하는 비동기 작업입니다.

특성
OverloadAttribute RemoteAsyncAttribute

Windows 요구 사항

앱 기능
location ID_CAP_LOCATION [Windows Phone]

설명

최신 위치가 허용 가능한 기간 내에 있는 경우 위치가 즉시 반환됩니다. 그렇지 않으면 다음 변경까지 위치가 반환되지 않습니다. 경우에 따라 앱이 지정된 maximumAge 값보다 오래된 위치 데이터를 받을 수 있습니다. 이는 원하는 정확도 설정에 따라 추가 연령 값이 계산되고 앱에서 두 연령 중 더 큰 연령을 사용하기 때문입니다. 예를 들어 500미터의 기본 정확도는 최대 30초에 해당한다고 가정합니다. 이 경우 maximumAge 를 10초로 설정하더라도 앱에서 20초 이전 데이터를 받을 수 있습니다.

추가 정보

적용 대상