LocationManager.RequestLocationUpdates Méthode

[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

Paramètres

Attributs

RegisterAttribute

Remarques

Inscrivez-vous aux mises à jour d’emplacement à partir du fournisseur spécifié, à l’aide d’un LocationRequestrappel remis via le fournisseur fourni PendingIntent.

Les intentions en attente fournies contiennent des extras avec les informations de rappel. Les clés utilisées pour les extras sont #KEY_LOCATION_CHANGED et #KEY_PROVIDER_ENABLED. Consultez la documentation de chaque clé supplémentaire respective pour plus d’informations sur les valeurs.

Pour annuler l’inscription pour les mises à jour d’emplacement, utilisez #removeUpdates(PendingIntent).

Java documentation pour android.location.LocationManager.requestLocationUpdates(java.lang.String, android.location.LocationRequest, android.app.PendingIntent).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la 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

Paramètres

Attributs

RegisterAttribute

Exceptions

Remarques

Inscrivez-vous aux mises à jour d’emplacement à l’aide d’un fournisseur sélectionné via les critères donnés et rappels remis via le fournisseur fourni PendingIntent.

Remarque : Étant donné qu’Android KitKat, les demandes de critères entraînent toujours l’utilisation du #FUSED_PROVIDER.

Pour plus d’informations sur le fonctionnement de cette méthode, voir #requestLocationUpdates(String, long, float, PendingIntent) plus en détail.

Ce membre est déconseillé. Utilisez #requestLocationUpdates(String, long, float, PendingIntent) plutôt pour sélectionner explicitement un fournisseur.

Java documentation pour android.location.LocationManager.requestLocationUpdates(long, float, android.location.Criteria, android.app.PendingIntent).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la 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

Paramètres

Attributs

RegisterAttribute

Remarques

Inscrivez-vous aux mises à jour d’emplacement à partir du fournisseur spécifié, à l’aide d’un LocationRequestrappel et d’un rappel sur le fournisseur spécifié Executor.

Une seule requête peut être inscrite pour chaque paire d’écouteurs/fournisseur unique. Par conséquent, toutes les demandes suivantes avec le même fournisseur et l’écouteur remplacent tous les arguments associés. Le même écouteur peut être utilisé sur plusieurs fournisseurs avec des demandes différentes pour chaque fournisseur.

La réception de la première mise à jour de l’emplacement peut prendre un certain temps en fonction des conditions dans lesquelles l’appareil se trouve. Pour tirer parti des emplacements mis en cache, l’application peut envisager d’utiliser #getLastKnownLocation(String) ou #getCurrentLocation(String, LocationRequest, CancellationSignal, Executor, Consumer) non.

Consultez LocationRequest la documentation pour obtenir une explication des différents paramètres de requête et comment ils peuvent affecter les emplacements reçus.

Si votre application souhaite observer passivement les mises à jour d’emplacement de tous les fournisseurs, utilisez le #PASSIVE_PROVIDER. Ce fournisseur n’active pas ou ne modifie pas les fournisseurs d’emplacements actifs. Vous n’avez donc pas besoin d’être aussi prudent au sujet des paramètres de durée minimale et de distance minimale. Toutefois, si votre application effectue un travail lourd sur une mise à jour d’emplacement (par exemple, l’activité réseau), vous devez définir un intervalle le plus rapide explicite sur votre demande d’emplacement si une autre application active un fournisseur d’emplacement avec des mises à jour extrêmement rapides.

Si le fournisseur que vous avez sélectionné est désactivé, les mises à jour d’emplacement cesseront et une mise à jour de disponibilité du fournisseur sera envoyée. Dès que le fournisseur est à nouveau activé, une autre mise à jour de disponibilité du fournisseur sera envoyée et les mises à jour de localisation reprendront.

Les emplacements retournés #GPS_PROVIDER par l’appareil sont liés à la position d’antenne principale de l’AUTHENTIFICATION au sein de l’appareil. #getGnssAntennaInfos() peut être utilisé pour déterminer la position de l’antenne HAB par rapport au système de coordonnées Android, et convertir entre eux si nécessaire. Cela est généralement nécessaire uniquement pour les applications à haute précision.

Lorsque les rappels d’emplacement sont appelés, le système conserve un blocage de veille au nom de votre application pendant une certaine période, mais pas indéfiniment. Si votre application nécessite un blocage de veille long dans le rappel d’emplacement, vous devez l’acquérir vous-même.

Les demandes d’emplacement de courrier indésirable sont un drain sur les ressources système, et le système a des mesures préventives en place pour s’assurer que ce comportement n’entraîne jamais plus d’emplacements que possible avec une demande d’emplacement unique avec un intervalle équivalent qui est laissé en place tout le temps. Dans le cadre de cette amélioration, les applications qui ciblent Android S et versions ultérieures peuvent recevoir des emplacements mis en cache ou historiques via leur écouteur. Ces emplacements ne seront jamais plus anciens que l’intervalle de la demande d’emplacement.

Pour annuler l’inscription pour les mises à jour d’emplacement, utilisez #removeUpdates(LocationListener).

Java documentation pour android.location.LocationManager.requestLocationUpdates(java.lang.String, android.location.LocationRequest, java.util.concurrent.Executor, android.location.LocationListener).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la 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

Paramètres

Attributs

RegisterAttribute

Exceptions

Remarques

Inscrivez-vous aux mises à jour d’emplacement à l’aide du fournisseur nommé et rappels remis via le fournisseur fourni PendingIntent.

Pour plus d’informations sur le fonctionnement de cette méthode, voir #requestLocationUpdates(String, LocationRequest, PendingIntent) plus en détail.

Java documentation pour android.location.LocationManager.requestLocationUpdates(java.lang.String, long, float, android.app.PendingIntent).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la 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

Paramètres

Attributs

RegisterAttribute

Exceptions

Remarques

Inscrivez-vous aux mises à jour d’emplacement à partir du fournisseur donné avec les arguments donnés et un rappel sur le Looper thread appelant.

Pour plus d’informations sur le fonctionnement de cette méthode, voir #requestLocationUpdates(String, LocationRequest, Executor, LocationListener) plus en détail.

Avant Jellybean, le paramètre minTime n’était qu’un indicateur, et certaines implémentations du fournisseur d’emplacement l’ont ignorée. Pour Jellybean et les versions ultérieures, il est toutefois obligatoire pour les appareils compatibles Android d’observer les paramètres minTime et minDistance.

Java documentation pour android.location.LocationManager.requestLocationUpdates(java.lang.String, long, float, android.location.LocationListener).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la 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

Paramètres

Attributs

RegisterAttribute

Exceptions

Remarques

Inscrivez-vous aux mises à jour d’emplacement à l’aide d’un fournisseur sélectionné par le biais des critères donnés et d’un rappel sur le paramètre spécifié Looper.

Remarque : Étant donné qu’Android KitKat, les demandes de critères entraînent toujours l’utilisation du #FUSED_PROVIDER.

Pour plus d’informations sur le fonctionnement de cette méthode, voir #requestLocationUpdates(String, LocationRequest, Executor, LocationListener) plus en détail.

Ce membre est déconseillé. Utilisez #requestLocationUpdates(String, long, float, LocationListener, Looper) plutôt pour sélectionner explicitement un fournisseur.

Java documentation pour android.location.LocationManager.requestLocationUpdates(long, float, android.location.Criteria, android.location.LocationListener, android.os.Looper).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la 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

Paramètres

Attributs

RegisterAttribute

Remarques

Inscrivez-vous aux mises à jour d’emplacement à l’aide d’un fournisseur sélectionné par le biais des critères donnés et d’un rappel sur le paramètre spécifié Executor.

Remarque : Étant donné qu’Android KitKat, les demandes de critères entraînent toujours l’utilisation du #FUSED_PROVIDER.

Pour plus d’informations sur le fonctionnement de cette méthode, voir #requestLocationUpdates(String, LocationRequest, Executor, LocationListener) plus en détail.

Ce membre est déconseillé. Utilisez #requestLocationUpdates(String, long, float, Executor, LocationListener) plutôt pour sélectionner explicitement un fournisseur.

Java documentation pour android.location.LocationManager.requestLocationUpdates(long, float, android.location.Criteria, java.util.concurrent.Executor, android.location.LocationListener).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la 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

Paramètres

Attributs

RegisterAttribute

Exceptions

Remarques

Inscrivez-vous aux mises à jour d’emplacement à partir du fournisseur donné avec les arguments donnés et un rappel sur le fournisseur spécifié Looper.

Pour plus d’informations sur le fonctionnement de cette méthode, voir #requestLocationUpdates(String, LocationRequest, Executor, LocationListener) plus en détail.

Avant Jellybean, le paramètre minTime n’était qu’un indicateur, et certaines implémentations du fournisseur d’emplacement l’ont ignorée. Pour Jellybean et les versions ultérieures, il est toutefois obligatoire pour les appareils compatibles Android d’observer les paramètres minTime et minDistance.

Java documentation pour android.location.LocationManager.requestLocationUpdates(java.lang.String, long, float, android.location.LocationListener, android.os.Looper).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la 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

Paramètres

Attributs

RegisterAttribute

Remarques

Inscrivez-vous aux mises à jour d’emplacement à l’aide du fournisseur nommé et d’un rappel sur le serveur spécifié Executor.

Pour plus d’informations sur le fonctionnement de cette méthode, voir #requestLocationUpdates(String, LocationRequest, Executor, LocationListener) plus en détail.

Avant Jellybean, le paramètre minTime n’était qu’un indicateur, et certaines implémentations du fournisseur d’emplacement l’ont ignorée. Pour Jellybean et les versions ultérieures, il est toutefois obligatoire pour les appareils compatibles Android d’observer les paramètres minTime et minDistance.

Java documentation pour android.location.LocationManager.requestLocationUpdates(java.lang.String, long, float, java.util.concurrent.Executor, android.location.LocationListener).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.