#include < gps.h >
Erweiterte Schnittstelle für GPS_Geofencing-Unterstützung
Definition in Zeile 1361 der Datei gps.h .
| void(* add_geofence_area)(int32_t geofence_id, doppelter Breitengrad, doppelter Längengrad, doppelter Radius_meter, int last_transition, int monitor_transitions, int notification_responsiveness_ms, int unlimited_timer_ms) |
Fügen Sie einen Geofence-Bereich hinzu. Diese API unterstützt derzeit kreisförmige Geofences. Parameter: geofence_id – Die ID für den Geofence. Wenn bereits ein Geofence mit dieser ID vorhanden ist, sollte ein Fehlerwert (GPS_GEOFENCE_ERROR_ID_EXISTS) zurückgegeben werden. Breitengrad, Längengrad, Radius_Meter – Der Breitengrad, die Länge und der Radius (in Metern) für den Geofence. last_transition – Der aktuelle Status des Geofence. Wenn das System beispielsweise bereits weiß, dass sich der Benutzer innerhalb des Geofence befindet, wird dies auf GPS_GEOFENCE_ENTERED gesetzt. In den meisten Fällen ist es GPS_GEOFENCE_UNCERTAIN. monitor_transition – Welche Übergänge überwacht werden sollen. Bitweises ODER von GPS_GEOFENCE_ENTERED, GPS_GEOFENCE_EXITED und GPS_GEOFENCE_UNCERTAIN. notification_responsiveness_ms – Definiert die Best-Effort-Beschreibung, wie schnell der Rückruf aufgerufen werden soll, wenn der mit dem Geofence verknüpfte Übergang ausgelöst wird. Wenn beispielsweise GPS_GEOFENCE_ENTERED auf 1000 Millisekunden eingestellt ist, sollte der Rückruf 1000 Millisekunden beim Betreten des Geofence aufgerufen werden. Dieser Parameter wird in Millisekunden definiert. HINWEIS: Dies ist nicht mit der Rate zu verwechseln, mit der das GPS abgefragt wird. Aus Energiespargründen ist es akzeptabel, die Abtastrate des GPS dynamisch zu variieren; Daher kann die Abtastrate schneller oder langsamer sein. unbekannter_timer_ms – Das Zeitlimit, nach dem der UNCERTAIN-Übergang ausgelöst werden soll. Dieser Parameter wird in Millisekunden definiert. Eine ausführliche Erklärung finden Sie oben.
Definition in Zeile 1400 der Datei gps.h .
Öffnet die Geofence-Schnittstelle und stellt die Rückrufroutinen für die Implementierung dieser Schnittstelle bereit.
Definition in Zeile 1369 der Datei gps.h .
| void(* pause_geofence)(int32_t geofence_id) |
Unterbrechen Sie die Überwachung eines bestimmten Geofence. Parameter: geofence_id – Die ID für den Geofence.
Definition in Zeile 1409 der Datei gps.h .
| void(* remove_geofence_area)(int32_t geofence_id) |
Entfernen Sie einen Geofence-Bereich. Nachdem die Funktion zurückgegeben wurde, sollten keine Benachrichtigungen gesendet werden. Parameter: geofence_id – Die ID für den Geofence.
Definition in Zeile 1429 der Datei gps.h .
| void(* resume_geofence)(int32_t geofence_id, int monitor_transitions) |
Setzen Sie die Überwachung eines bestimmten Geofence fort. Parameter: geofence_id – Die ID für den Geofence. monitor_transitions – Welche Übergänge überwacht werden sollen. Bitweises ODER von GPS_GEOFENCE_ENTERED, GPS_GEOFENCE_EXITED und GPS_GEOFENCE_UNCERTAIN. Dies ersetzt den zugehörigen Wert, der im Aufruf add_geofence_area bereitgestellt wird.
Definition in Zeile 1421 der Datei gps.h .
auf sizeof(GpsGeofencingInterface) setzen
Definition in Zeile 1363 der Datei gps.h .
Die Dokumentation für diese Struktur wurde aus der folgenden Datei generiert:
- hardware/libhardware/include/hardware/ gps.h
