LocationSource

Interface publique LocationSource

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
activate(écouteur LocationSource.OnLocationChangedListener)
Active ce fournisseur.
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