LocationManager.GetCurrentLocation 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
GetCurrentLocation(String, LocationRequest, CancellationSignal, IExecutor, IConsumer) |
지정된 |
GetCurrentLocation(String, CancellationSignal, IExecutor, IConsumer) |
지정된 공급자에서 단일 현재 위치 수정을 비동기적으로 반환합니다. |
GetCurrentLocation(String, LocationRequest, CancellationSignal, IExecutor, IConsumer)
지정된 LocationRequest
공급자를 기준으로 지정된 공급자에서 단일 현재 위치 수정을 비동기적으로 반환합니다.
[Android.Runtime.Register("getCurrentLocation", "(Ljava/lang/String;Landroid/location/LocationRequest;Landroid/os/CancellationSignal;Ljava/util/concurrent/Executor;Ljava/util/function/Consumer;)V", "GetGetCurrentLocation_Ljava_lang_String_Landroid_location_LocationRequest_Landroid_os_CancellationSignal_Ljava_util_concurrent_Executor_Ljava_util_function_Consumer_Handler", ApiSince=31)]
public virtual void GetCurrentLocation (string provider, Android.Locations.LocationRequest locationRequest, Android.OS.CancellationSignal? cancellationSignal, Java.Util.Concurrent.IExecutor executor, Java.Util.Functions.IConsumer consumer);
[<Android.Runtime.Register("getCurrentLocation", "(Ljava/lang/String;Landroid/location/LocationRequest;Landroid/os/CancellationSignal;Ljava/util/concurrent/Executor;Ljava/util/function/Consumer;)V", "GetGetCurrentLocation_Ljava_lang_String_Landroid_location_LocationRequest_Landroid_os_CancellationSignal_Ljava_util_concurrent_Executor_Ljava_util_function_Consumer_Handler", ApiSince=31)>]
abstract member GetCurrentLocation : string * Android.Locations.LocationRequest * Android.OS.CancellationSignal * Java.Util.Concurrent.IExecutor * Java.Util.Functions.IConsumer -> unit
override this.GetCurrentLocation : string * Android.Locations.LocationRequest * Android.OS.CancellationSignal * Java.Util.Concurrent.IExecutor * Java.Util.Functions.IConsumer -> unit
매개 변수
- provider
- String
다음을 통해 나열된 공급자 #getAllProviders()
- locationRequest
- LocationRequest
위치 매개 변수를 포함하는 위치 요청
- cancellationSignal
- CancellationSignal
이 호출을 취소할 수 있는 선택적 신호
- executor
- IExecutor
콜백은 이에 대해 수행됩니다. Executor
- consumer
- IConsumer
a Location
또는 null을 사용하여 호출된 콜백
- 특성
설명
지정된 LocationRequest
공급자를 기준으로 지정된 공급자에서 단일 현재 위치 수정을 비동기적으로 반환합니다. 이렇게 하면 새 위치를 계산하기 위해 센서를 활성화할 수 있으며, #getLastKnownLocation(String)
사용 가능한 경우에만 캐시된 수정 사항을 반환합니다. 지정된 콜백은 공급자가 유효한 위치를 생성할 수 없는 경우 유효한 위치 또는 null 위치로 한 번만 호출됩니다.
클라이언트는 선택적 CancellationSignal
을 제공할 수 있습니다. 작업을 취소하는 데 사용되는 경우 취소 후에는 콜백이 필요하지 않습니다.
이 메서드는 최근 과거의 위치(몇 초 단위)를 반환할 수 있지만 이전 위치(예: 몇 분 이전 또는 이전 위치)를 반환하지 않습니다. 클라이언트는 이 메서드가 위치를 반환하는 경우 현재 디바이스의 위치를 가장 잘 예측한다는 보장을 사용할 수 있습니다.
백그라운드에서 이 메서드를 호출하는 클라이언트는 메서드가 포그라운드에 있는 동안보다 더 자주 유효한 위치 수정을 확인하지 못하는 것을 알 수 있습니다. 백그라운드 애플리케이션은 위치 액세스에서 어느 정도 제한될 수 있습니다.
지정된 위치 요청을 사용하여 필요한 경우 새 위치를 계산하는 방법에 대한 힌트를 제공할 수 있습니다. 특히 LocationRequest#getDurationMillis()
실패하기 전에 허용되는 최대 기간을 제공하는 데 사용할 수 있습니다. 시스템은 요청이 실패하기 전에 항상 현재 위치에 대한 요청이 적절한 값(예: 1분 미만)으로 실행될 수 있는 최대 시간을 제한합니다.
이 페이지의 일부는 Android 오픈 소스 프로젝트에서 만들고 공유하고 Creative Commons 2.5 특성 라이선스에 설명된 용어에 따라 사용되는 작업을 기반으로 하는 수정 사항입니다.
적용 대상
GetCurrentLocation(String, CancellationSignal, IExecutor, IConsumer)
지정된 공급자에서 단일 현재 위치 수정을 비동기적으로 반환합니다.
[Android.Runtime.Register("getCurrentLocation", "(Ljava/lang/String;Landroid/os/CancellationSignal;Ljava/util/concurrent/Executor;Ljava/util/function/Consumer;)V", "GetGetCurrentLocation_Ljava_lang_String_Landroid_os_CancellationSignal_Ljava_util_concurrent_Executor_Ljava_util_function_Consumer_Handler", ApiSince=30)]
public virtual void GetCurrentLocation (string provider, Android.OS.CancellationSignal? cancellationSignal, Java.Util.Concurrent.IExecutor executor, Java.Util.Functions.IConsumer consumer);
[<Android.Runtime.Register("getCurrentLocation", "(Ljava/lang/String;Landroid/os/CancellationSignal;Ljava/util/concurrent/Executor;Ljava/util/function/Consumer;)V", "GetGetCurrentLocation_Ljava_lang_String_Landroid_os_CancellationSignal_Ljava_util_concurrent_Executor_Ljava_util_function_Consumer_Handler", ApiSince=30)>]
abstract member GetCurrentLocation : string * Android.OS.CancellationSignal * Java.Util.Concurrent.IExecutor * Java.Util.Functions.IConsumer -> unit
override this.GetCurrentLocation : string * Android.OS.CancellationSignal * Java.Util.Concurrent.IExecutor * Java.Util.Functions.IConsumer -> unit
매개 변수
- provider
- String
다음을 통해 나열된 공급자 #getAllProviders()
- cancellationSignal
- CancellationSignal
이 호출을 취소할 수 있는 선택적 신호
- executor
- IExecutor
콜백은 이에 대해 수행됩니다. Executor
- consumer
- IConsumer
a Location
또는 null을 사용하여 호출된 콜백
- 특성
설명
지정된 공급자에서 단일 현재 위치 수정을 비동기적으로 반환합니다.
자세한 내용은 #getCurrentLocation(String, LocationRequest, CancellationSignal, Executor, Consumer)
를 참조하세요.
이 페이지의 일부는 Android 오픈 소스 프로젝트에서 만들고 공유하고 Creative Commons 2.5 특성 라이선스에 설명된 용어에 따라 사용되는 작업을 기반으로 하는 수정 사항입니다.