Définit une interface permettant de fournir des données de localisation, généralement à un objet GoogleMap
.
Un objet GoogleMap
dispose d'un fournisseur de localisation intégré pour son calque "Ma position", mais il peut être replaced
avec un autre qui implémente cette interface.
Un objet GoogleMap
active son fournisseur de localisation à l'aide de activate(OnLocationChangedListener)
. Lorsqu'il est actif (entre activate(OnLocationChangedListener)
et deactivate()
), un fournisseur de localisation doit envoyer régulièrement des mises à jour de position à l'écouteur enregistré dans activate(OnLocationChangedListener)
. Il appartient au fournisseur d'utiliser les services de localisation à bon escient en fonction de l'état du cycle de vie de la carte. Par exemple, il ne doit utiliser les services qui consomment beaucoup de batterie (comme le GPS) qu'occasionnellement ou uniquement lorsqu'une activité est exécutée au premier plan.
Récapitulatif des classes imbriquées
interface | LocationSource.OnLocationChangedListener | gère les mises à jour de la position ; |
Récapitulatif des méthodes publiques
vide abstrait | |
vide abstrait |
deactivate()
Désactive ce fournisseur.
|
Méthodes publiques
public abstrait vide activate (écouteur LocationSource.OnLocationChangedListener)
Active ce fournisseur. Ce fournisseur notifiera régulièrement l'écouteur fourni, jusqu'à ce que vous appelez deactivate()
. Les notifications seront diffusées sur le thread principal.
Paramètres
écouteur | écouteur appelé lorsqu'un nouvel emplacement est disponible |
---|
Génère
IllegalStateException | si ce fournisseur est déjà actif |
---|---|
IllegalArgumentException | si listener est null
|
public abstract void deactivate ()
Désactive ce fournisseur. Le rappel précédemment enregistré n'est pas informé des nouvelles mises à jour.
Génère
IllegalStateException | si ce fournisseur est déjà inactif |
---|