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


LocationManager.GetCurrentLocation Метод

Определение

Перегрузки

GetCurrentLocation(String, LocationRequest, CancellationSignal, IExecutor, IConsumer)

Асинхронно возвращает одно текущее исправление расположения от заданного LocationRequestпоставщика.

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

обратный вызов, вызываемый либо с помощью значения NULL Location

Атрибуты

Комментарии

Асинхронно возвращает одно текущее исправление расположения от заданного LocationRequestпоставщика. Это может активировать датчики для вычисления нового расположения, в отличие #getLastKnownLocation(String)от того, что возвращает кэшированное исправление только в случае доступности. Этот обратный вызов будет вызываться один раз и только один раз, либо с допустимым расположением, либо с пустым расположением, если поставщику не удалось создать допустимое расположение.

Клиент может предоставить необязательный CancellationSignalпараметр. Если это используется для отмены операции, обратный вызов не должен ожидаться после отмены.

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

Клиенты, вызывающие этот метод из фона, могут заметить, что метод не может определить допустимое исправление расположения чаще, чем в переднем плане. Фоновые приложения могут регулироваться в их расположении в некоторой степени.

Запрос на расположение может использоваться для предоставления подсказок о том, как вычисляется новое расположение при необходимости. В частности LocationRequest#getDurationMillis() , можно использовать для предоставления максимально допустимой длительности до сбоя. Система всегда будет включать максимальное время, когда запрос текущего расположения может выполняться до некоторого разумного значения (менее минуты), прежде чем запрос завершится сбоем.

Документация по Java для android.location.LocationManager.getCurrentLocation(java.lang.String, android.location.LocationRequest, android.os.CancellationSignal, java.util.concurrent.Executor, java.util.function.Consumer<android.location.Location>).

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

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

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

обратный вызов, вызываемый либо с помощью значения NULL Location

Атрибуты

Комментарии

Асинхронно возвращает одно текущее исправление расположения от заданного поставщика.

Дополнительные сведения см. в разделе #getCurrentLocation(String, LocationRequest, CancellationSignal, Executor, Consumer).

Документация по Java для android.location.LocationManager.getCurrentLocation(java.lang.String, android.os.CancellationSignal, java.util.concurrent.Executor, java.util.function.Consumer<android.location.Location>).

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

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