LocationManager.GetCurrentLocation Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
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
обратный вызов, вызываемый либо с помощью значения NULL Location
- Атрибуты
Комментарии
Асинхронно возвращает одно текущее исправление расположения от заданного LocationRequest
поставщика. Это может активировать датчики для вычисления нового расположения, в отличие #getLastKnownLocation(String)
от того, что возвращает кэшированное исправление только в случае доступности. Этот обратный вызов будет вызываться один раз и только один раз, либо с допустимым расположением, либо с пустым расположением, если поставщику не удалось создать допустимое расположение.
Клиент может предоставить необязательный CancellationSignal
параметр. Если это используется для отмены операции, обратный вызов не должен ожидаться после отмены.
Этот метод может возвращать расположения из самого недавнего прошлого (в порядке нескольких секунд), но никогда не возвращать старые расположения (например, несколько минут старше или старше). Клиенты могут полагаться на гарантию того, что если этот метод возвращает расположение, он будет представлять лучшую оценку расположения устройства в данный момент.
Клиенты, вызывающие этот метод из фона, могут заметить, что метод не может определить допустимое исправление расположения чаще, чем в переднем плане. Фоновые приложения могут регулироваться в их расположении в некоторой степени.
Запрос на расположение может использоваться для предоставления подсказок о том, как вычисляется новое расположение при необходимости. В частности LocationRequest#getDurationMillis()
, можно использовать для предоставления максимально допустимой длительности до сбоя. Система всегда будет включать максимальное время, когда запрос текущего расположения может выполняться до некоторого разумного значения (менее минуты), прежде чем запрос завершится сбоем.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом 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)
.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.