Appelez GeofenceRelay.shared.start() depuis l’app delegate iOS, pour qu’une app terminée puisse quand même envoyer un POST de franchissement de région quand iOS la relance. L’accès à la localisation « Toujours » est requis pour cette relance.
File d’attente sur disque et nouvelles tentatives
Sur iOS, les transitions sont mises en file sur le disque et envoyées dans l’ordre. iOS réessaie en cas de perte de réseau, d’erreurs 5xx, 408, 429 ou 401/403. Cette file d’attente iOS conserve les 100 transitions les plus récentes, aucune ne datant de plus de sept jours. Android réessaie via WorkManager et n’utilise ni cette file ordonnée ni ces limites.
clearGeofenceQueue()
Supprimez les POST natifs non envoyés lors de la déconnexion ou du changement de compte url. La file est également vidée lorsque setupGeofencing reçoit un autre url. Sur le web, il n’y a pas de file et l’appel se résout immédiatement.
Event time
Optionnel GeofenceTransitionEvent.time indique le moment où le téléphone a détecté le franchissement, en millisecondes depuis l’epoch. Lisez cette valeur dans votre webhook, et non l’horloge du serveur, car un POST mis en file peut arriver plus tard.
Utiliser @capgo/background-geolocation lorsque votre application Capacitor a besoin de mises à jour de localisation précises au premier plan ou en arrière-plan, de geofences circulaires natives sur iOS et Android, et d'une remontée des transitions de geofence vers le backend quand la WebView est suspendue.
Fournit des mises à jour de localisation précises en premier ou en arrière-plan.
stop
Arrête les mises à jour de localisation.
openSettings
Ouvre la page des paramètres de localisation de l’appareil. Pratique pour guider les utilisateurs vers l’activation des services de localisation ou l’ajustement des autorisations.
setPlannedRoute
Joue un son natif lorsque l'utilisateur s'écarte de l'itinéraire prévu.
setupGeofencing
Configure les paramètres par défaut des geofences et l'envoi optionnel des transitions natives via POST.
addGeofence
Lance la surveillance d'une geofence circulaire sur iOS et Android.
removeGeofence
Arrête la surveillance d'une geofence via son identifiant.
removeAllGeofences
Arrête la surveillance de toutes les geofences enregistrées par ce plugin.
getMonitoredGeofences
Retourne les identifiants actuellement surveillés par la couche native.
updateHeaders
Remplace les en-têtes HTTP persistés pour la livraison native des requêtes POST. Sur iOS, cela vide également la file d’attente des géofences. Sur Android, il enregistre les en-têtes sans démarrer les tâches WorkManager en file d’attente.
clearGeofenceQueue
Supprime les transitions de géofence en file d’attente pour un POST natif et non encore envoyées. Résout immédiatement sur le web.
addListener('geofenceTransition', ...)
Reçoit les événements d’entrée et de sortie de géorepère pendant que l’app est active. Les événements peuvent inclure time.
addListener('geofenceError', ...)
Reçoit les erreurs natives de surveillance de geofence lorsque l'application est active.