LocationManager.RequestLocationUpdates Método

[Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;Landroid/location/LocationRequest;Landroid/app/PendingIntent;)V", "GetRequestLocationUpdates_Ljava_lang_String_Landroid_location_LocationRequest_Landroid_app_PendingIntent_Handler", ApiSince=31)]
public virtual void RequestLocationUpdates(string provider, Android.Locations.LocationRequest locationRequest, Android.App.PendingIntent pendingIntent);

[<Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;Landroid/location/LocationRequest;Landroid/app/PendingIntent;)V", "GetRequestLocationUpdates_Ljava_lang_String_Landroid_location_LocationRequest_Landroid_app_PendingIntent_Handler", ApiSince=31)>]
abstract member RequestLocationUpdates : string * Android.Locations.LocationRequest * Android.App.PendingIntent -> unit
override this.RequestLocationUpdates : string * Android.Locations.LocationRequest * Android.App.PendingIntent -> unit

Parámetros

Atributos

RegisterAttribute

Comentarios

Regístrese para las actualizaciones de ubicación del proveedor especificado, mediante una LocationRequestdevolución de llamada y que se entregue a través del proporcionado PendingIntent.

Las intenciones pendientes entregadas contendrán extras con la información de devolución de llamada. Las claves usadas para los extras son #KEY_LOCATION_CHANGED y #KEY_PROVIDER_ENABLED. Consulte la documentación de cada clave adicional correspondiente para obtener información sobre los valores.

Para anular el registro de las actualizaciones de ubicación, use #removeUpdates(PendingIntent).

Java documentación para android.location.LocationManager.requestLocationUpdates(java.lang.String, android.location.LocationRequest, android.app.PendingIntent).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

[Android.Runtime.Register("requestLocationUpdates", "(JFLandroid/location/Criteria;Landroid/app/PendingIntent;)V", "GetRequestLocationUpdates_JFLandroid_location_Criteria_Landroid_app_PendingIntent_Handler")]
public virtual void RequestLocationUpdates(long minTimeMs, float minDistanceM, Android.Locations.Criteria criteria, Android.App.PendingIntent pendingIntent);

[<Android.Runtime.Register("requestLocationUpdates", "(JFLandroid/location/Criteria;Landroid/app/PendingIntent;)V", "GetRequestLocationUpdates_JFLandroid_location_Criteria_Landroid_app_PendingIntent_Handler")>]
abstract member RequestLocationUpdates : int64 * single * Android.Locations.Criteria * Android.App.PendingIntent -> unit
override this.RequestLocationUpdates : int64 * single * Android.Locations.Criteria * Android.App.PendingIntent -> unit

Parámetros

Atributos

RegisterAttribute

Excepciones

Comentarios

Regístrese para las actualizaciones de ubicación mediante un proveedor seleccionado a través de los criterios especificados y las devoluciones de llamada entregadas a través del proporcionado PendingIntent.

Nota: Dado que Android KitKat, las solicitudes criteria siempre darán lugar al uso de #FUSED_PROVIDER.

Consulte #requestLocationUpdates(String, long, float, PendingIntent) para obtener más información sobre cómo funciona este método.

Este miembro está en desuso. Use #requestLocationUpdates(String, long, float, PendingIntent) en su lugar para seleccionar explícitamente un proveedor.

Java documentación para android.location.LocationManager.requestLocationUpdates(long, float, android.location.Criteria, android.app.PendingIntent).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

[Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;Landroid/location/LocationRequest;Ljava/util/concurrent/Executor;Landroid/location/LocationListener;)V", "GetRequestLocationUpdates_Ljava_lang_String_Landroid_location_LocationRequest_Ljava_util_concurrent_Executor_Landroid_location_LocationListener_Handler", ApiSince=31)]
public virtual void RequestLocationUpdates(string provider, Android.Locations.LocationRequest locationRequest, Java.Util.Concurrent.IExecutor executor, Android.Locations.ILocationListener listener);

[<Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;Landroid/location/LocationRequest;Ljava/util/concurrent/Executor;Landroid/location/LocationListener;)V", "GetRequestLocationUpdates_Ljava_lang_String_Landroid_location_LocationRequest_Ljava_util_concurrent_Executor_Landroid_location_LocationListener_Handler", ApiSince=31)>]
abstract member RequestLocationUpdates : string * Android.Locations.LocationRequest * Java.Util.Concurrent.IExecutor * Android.Locations.ILocationListener -> unit
override this.RequestLocationUpdates : string * Android.Locations.LocationRequest * Java.Util.Concurrent.IExecutor * Android.Locations.ILocationListener -> unit

Parámetros

Atributos

RegisterAttribute

Comentarios

Regístrese para obtener actualizaciones de ubicación del proveedor especificado, mediante un LocationRequest, y una devolución de llamada en el especificado Executor.

Solo se puede registrar una solicitud para cada par único de agente de escucha o proveedor, por lo que las solicitudes posteriores con el mismo proveedor y agente de escucha sobrescribirán todos los argumentos asociados. El mismo agente de escucha se puede usar en varios proveedores con diferentes solicitudes para cada proveedor.

Puede tardar algún tiempo en recibir la primera actualización de ubicación en función de las condiciones en las que se encuentra el dispositivo. Para aprovechar las ubicaciones almacenadas en caché, la aplicación puede considerar la posibilidad de usar #getLastKnownLocation(String) o #getCurrentLocation(String, LocationRequest, CancellationSignal, Executor, Consumer) en su lugar.

Consulte LocationRequest la documentación para obtener una explicación de varios parámetros de solicitud y cómo pueden afectar a las ubicaciones recibidas.

Si la aplicación quiere observar pasivamente las actualizaciones de ubicación de todos los proveedores, use .#PASSIVE_PROVIDER Este proveedor no activa ni modifica los proveedores de ubicaciones activas, por lo que no es necesario tener cuidado con respecto al tiempo mínimo y los parámetros de distancia mínima. Sin embargo, si la aplicación realiza un trabajo intensivo en una actualización de ubicación (como la actividad de red), debe establecer un intervalo explícito más rápido en la solicitud de ubicación en caso de que otra aplicación permita a un proveedor de ubicación con actualizaciones extremadamente rápidas.

En caso de que el proveedor seleccionado esté deshabilitado, se interrumpirán las actualizaciones de ubicación y se enviará una actualización de disponibilidad del proveedor. En cuanto el proveedor vuelva a habilitarse, se enviará otra actualización de disponibilidad del proveedor y se reanudarán las actualizaciones de ubicación.

Las ubicaciones devueltas desde #GPS_PROVIDER se refieren a la posición principal de la antena GNSS dentro del dispositivo. #getGnssAntennaInfos() se puede utilizar para determinar la posición de la antena GNSS con respecto al sistema de coordenadas Android y convertir entre ellos si es necesario. Por lo general, esto solo es necesario para aplicaciones de alta precisión.

Cuando se invocan devoluciones de llamada de ubicación, el sistema contendrá un wakelock en nombre de la aplicación durante algún período de tiempo, pero no indefinidamente. Si la aplicación requiere un wakelock de larga duración dentro de la devolución de llamada de ubicación, debe adquirirlo usted mismo.

Las solicitudes de ubicación de correo no deseado son una purga en los recursos del sistema y el sistema tiene medidas preventivas para asegurarse de que este comportamiento nunca dará lugar a más ubicaciones de las que se podría lograr con una única solicitud de ubicación con un intervalo equivalente que se deja en su lugar todo el tiempo. Como parte de esta mejora, las aplicaciones que tienen como destino Android S y versiones posteriores pueden recibir ubicaciones en caché o históricas a través de su agente de escucha. Estas ubicaciones nunca serán anteriores al intervalo de la solicitud de ubicación.

Para anular el registro de las actualizaciones de ubicación, use #removeUpdates(LocationListener).

Java documentación para android.location.LocationManager.requestLocationUpdates(java.lang.String, android.location.LocationRequest, java.util.concurrent.Executor, android.location.LocationListener).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

[Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;JFLandroid/app/PendingIntent;)V", "GetRequestLocationUpdates_Ljava_lang_String_JFLandroid_app_PendingIntent_Handler")]
public virtual void RequestLocationUpdates(string provider, long minTimeMs, float minDistanceM, Android.App.PendingIntent pendingIntent);

[<Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;JFLandroid/app/PendingIntent;)V", "GetRequestLocationUpdates_Ljava_lang_String_JFLandroid_app_PendingIntent_Handler")>]
abstract member RequestLocationUpdates : string * int64 * single * Android.App.PendingIntent -> unit
override this.RequestLocationUpdates : string * int64 * single * Android.App.PendingIntent -> unit

Parámetros

Atributos

RegisterAttribute

Excepciones

Comentarios

Regístrese para obtener actualizaciones de ubicación mediante el proveedor con nombre y las devoluciones de llamada entregadas a través del proporcionado PendingIntent.

Consulte #requestLocationUpdates(String, LocationRequest, PendingIntent) para obtener más información sobre cómo funciona este método.

Java documentación para android.location.LocationManager.requestLocationUpdates(java.lang.String, long, float, android.app.PendingIntent).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

[Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;JFLandroid/location/LocationListener;)V", "GetRequestLocationUpdates_Ljava_lang_String_JFLandroid_location_LocationListener_Handler")]
public virtual void RequestLocationUpdates(string provider, long minTimeMs, float minDistanceM, Android.Locations.ILocationListener listener);

[<Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;JFLandroid/location/LocationListener;)V", "GetRequestLocationUpdates_Ljava_lang_String_JFLandroid_location_LocationListener_Handler")>]
abstract member RequestLocationUpdates : string * int64 * single * Android.Locations.ILocationListener -> unit
override this.RequestLocationUpdates : string * int64 * single * Android.Locations.ILocationListener -> unit

Parámetros

Atributos

RegisterAttribute

Excepciones

Comentarios

Regístrese para obtener actualizaciones de ubicación del proveedor especificado con los argumentos especificados y una devolución de llamada en del Looper subproceso que realiza la llamada.

Consulte #requestLocationUpdates(String, LocationRequest, Executor, LocationListener) para obtener más información sobre cómo funciona este método.

Antes de Jellybean, el parámetro minTime era solo una sugerencia y algunas implementaciones del proveedor de ubicación la ignoraban. Sin embargo, para Jellybean y versiones posteriores, es obligatorio que los dispositivos compatibles con Android observen los parámetros minTime y minDistance.

Java documentación para android.location.LocationManager.requestLocationUpdates(java.lang.String, long, float, android.location.LocationListener).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

[Android.Runtime.Register("requestLocationUpdates", "(JFLandroid/location/Criteria;Landroid/location/LocationListener;Landroid/os/Looper;)V", "GetRequestLocationUpdates_JFLandroid_location_Criteria_Landroid_location_LocationListener_Landroid_os_Looper_Handler")]
public virtual void RequestLocationUpdates(long minTimeMs, float minDistanceM, Android.Locations.Criteria criteria, Android.Locations.ILocationListener listener, Android.OS.Looper? looper);

[<Android.Runtime.Register("requestLocationUpdates", "(JFLandroid/location/Criteria;Landroid/location/LocationListener;Landroid/os/Looper;)V", "GetRequestLocationUpdates_JFLandroid_location_Criteria_Landroid_location_LocationListener_Landroid_os_Looper_Handler")>]
abstract member RequestLocationUpdates : int64 * single * Android.Locations.Criteria * Android.Locations.ILocationListener * Android.OS.Looper -> unit
override this.RequestLocationUpdates : int64 * single * Android.Locations.Criteria * Android.Locations.ILocationListener * Android.OS.Looper -> unit

Parámetros

Atributos

RegisterAttribute

Excepciones

Comentarios

Regístrese para las actualizaciones de ubicación mediante un proveedor seleccionado a través de los criterios especificados y una devolución de llamada en el especificado Looper.

Nota: Dado que Android KitKat, las solicitudes criteria siempre darán lugar al uso de #FUSED_PROVIDER.

Consulte #requestLocationUpdates(String, LocationRequest, Executor, LocationListener) para obtener más información sobre cómo funciona este método.

Este miembro está en desuso. Use #requestLocationUpdates(String, long, float, LocationListener, Looper) en su lugar para seleccionar explícitamente un proveedor.

Java documentación para android.location.LocationManager.requestLocationUpdates(long, float, android.location.Criteria, android.location.LocationListener, android.os.Looper).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

[Android.Runtime.Register("requestLocationUpdates", "(JFLandroid/location/Criteria;Ljava/util/concurrent/Executor;Landroid/location/LocationListener;)V", "GetRequestLocationUpdates_JFLandroid_location_Criteria_Ljava_util_concurrent_Executor_Landroid_location_LocationListener_Handler", ApiSince=30)]
public virtual void RequestLocationUpdates(long minTimeMs, float minDistanceM, Android.Locations.Criteria criteria, Java.Util.Concurrent.IExecutor executor, Android.Locations.ILocationListener listener);

[<Android.Runtime.Register("requestLocationUpdates", "(JFLandroid/location/Criteria;Ljava/util/concurrent/Executor;Landroid/location/LocationListener;)V", "GetRequestLocationUpdates_JFLandroid_location_Criteria_Ljava_util_concurrent_Executor_Landroid_location_LocationListener_Handler", ApiSince=30)>]
abstract member RequestLocationUpdates : int64 * single * Android.Locations.Criteria * Java.Util.Concurrent.IExecutor * Android.Locations.ILocationListener -> unit
override this.RequestLocationUpdates : int64 * single * Android.Locations.Criteria * Java.Util.Concurrent.IExecutor * Android.Locations.ILocationListener -> unit

Parámetros

Atributos

RegisterAttribute

Comentarios

Regístrese para las actualizaciones de ubicación mediante un proveedor seleccionado a través de los criterios especificados y una devolución de llamada en el especificado Executor.

Nota: Dado que Android KitKat, las solicitudes criteria siempre darán lugar al uso de #FUSED_PROVIDER.

Consulte #requestLocationUpdates(String, LocationRequest, Executor, LocationListener) para obtener más información sobre cómo funciona este método.

Este miembro está en desuso. Use #requestLocationUpdates(String, long, float, Executor, LocationListener) en su lugar para seleccionar explícitamente un proveedor.

Java documentación para android.location.LocationManager.requestLocationUpdates(long, float, android.location.Criteria, java.util.concurrent.Executor, android.location.LocationListener).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

[Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;JFLandroid/location/LocationListener;Landroid/os/Looper;)V", "GetRequestLocationUpdates_Ljava_lang_String_JFLandroid_location_LocationListener_Landroid_os_Looper_Handler")]
public virtual void RequestLocationUpdates(string provider, long minTimeMs, float minDistanceM, Android.Locations.ILocationListener listener, Android.OS.Looper? looper);

[<Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;JFLandroid/location/LocationListener;Landroid/os/Looper;)V", "GetRequestLocationUpdates_Ljava_lang_String_JFLandroid_location_LocationListener_Landroid_os_Looper_Handler")>]
abstract member RequestLocationUpdates : string * int64 * single * Android.Locations.ILocationListener * Android.OS.Looper -> unit
override this.RequestLocationUpdates : string * int64 * single * Android.Locations.ILocationListener * Android.OS.Looper -> unit

Parámetros

Atributos

RegisterAttribute

Excepciones

Comentarios

Regístrese para obtener actualizaciones de ubicación del proveedor especificado con los argumentos especificados y una devolución de llamada en el especificado Looper.

Consulte #requestLocationUpdates(String, LocationRequest, Executor, LocationListener) para obtener más información sobre cómo funciona este método.

Antes de Jellybean, el parámetro minTime era solo una sugerencia y algunas implementaciones del proveedor de ubicación la ignoraban. Sin embargo, para Jellybean y versiones posteriores, es obligatorio que los dispositivos compatibles con Android observen los parámetros minTime y minDistance.

Java documentación para android.location.LocationManager.requestLocationUpdates(java.lang.String, long, float, android.location.LocationListener, android.os.Looper).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

[Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;JFLjava/util/concurrent/Executor;Landroid/location/LocationListener;)V", "GetRequestLocationUpdates_Ljava_lang_String_JFLjava_util_concurrent_Executor_Landroid_location_LocationListener_Handler", ApiSince=30)]
public virtual void RequestLocationUpdates(string provider, long minTimeMs, float minDistanceM, Java.Util.Concurrent.IExecutor executor, Android.Locations.ILocationListener listener);

[<Android.Runtime.Register("requestLocationUpdates", "(Ljava/lang/String;JFLjava/util/concurrent/Executor;Landroid/location/LocationListener;)V", "GetRequestLocationUpdates_Ljava_lang_String_JFLjava_util_concurrent_Executor_Landroid_location_LocationListener_Handler", ApiSince=30)>]
abstract member RequestLocationUpdates : string * int64 * single * Java.Util.Concurrent.IExecutor * Android.Locations.ILocationListener -> unit
override this.RequestLocationUpdates : string * int64 * single * Java.Util.Concurrent.IExecutor * Android.Locations.ILocationListener -> unit

Parámetros

Atributos

RegisterAttribute

Comentarios

Regístrese para las actualizaciones de ubicación mediante el proveedor con nombre y una devolución de llamada en el especificado Executor.

Consulte #requestLocationUpdates(String, LocationRequest, Executor, LocationListener) para obtener más información sobre cómo funciona este método.

Antes de Jellybean, el parámetro minTime era solo una sugerencia y algunas implementaciones del proveedor de ubicación la ignoraban. Sin embargo, para Jellybean y versiones posteriores, es obligatorio que los dispositivos compatibles con Android observen los parámetros minTime y minDistance.

Java documentación para android.location.LocationManager.requestLocationUpdates(java.lang.String, long, float, java.util.concurrent.Executor, android.location.LocationListener).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.