GpsGeofencingInterface-Strukturreferenz

Datenfelder
GpsGeofencingInterface-Strukturreferenz

#include < gps.h >

Datenfelder

size_t  size
 
void(*  init )( GpsGeofenceCallbacks *callbacks)
 
void(*  add_geofence_area )(int32_t geofence_id, double latitude, double longitude, double radius_meters, int last_transition, int monitor_transitions, int notification_responsiveness_ms, int unknown_timer_ms)
 
void(*  pause_geofence )(int32_t geofence_id)
 
void(*  resume_geofence )(int32_t geofence_id, int monitor_transitions)
 
void(*  remove_geofence_area )(int32_t geofence_id)
 

Detaillierte Beschreibung

Erweiterte Schnittstelle für die Unterstützung von GPS-Geofencing

Definition in Zeile 1361 der Datei gps.h .

Felddokumentation

void(* add_geofence_area)(int32_t geofence_id, double latitude, double longitude, double radius_meters, int last_transition, int monitor_transitions, int notification_responsiveness_ms, int unknown_timer_ms)

Fügen Sie einen Geofence-Bereich hinzu. Diese API unterstützt derzeit kreisförmige Geofences. Parameter: geofence_id – die ID für das Geofence. Wenn ein Geofence mit dieser ID bereits vorhanden ist, sollte ein Fehlerwert (GPS_GEOFENCE_ERROR_ID_EXISTS) zurückgegeben werden. latitude, longtitude, radius_meters – Breiten- und Längengrad sowie Radius (in Metern) des Geofences last_transition – Der aktuelle Status des Geofences Wenn das System beispielsweise bereits weiß, dass sich der Nutzer innerhalb des Geofences befindet, wird dieser auf „GPS_GEOFENCE_ENTERED“ gesetzt. In den meisten Fällen ist das GPS_GEOFENCE_UNCERTAIN. Bitweises OR von GPS_GEOFENCE_ENTERED, GPS_GEOFENCE_EXITED und GPS_GEOFENCE_UNCERTAIN. „notification_responsiveness_ms“ gibt an, wie schnell der Rückruf aufgerufen werden sollte, wenn der mit dem Geofence verbundenen Übergang ausgelöst wird. Wenn beispielsweise bei GPS_GEOFENCE_ENTERED 1.000 Millisekunden festgelegt sind, sollte der Rückruf 1.000 Millisekunden nach dem Betreten des Geofences aufgerufen werden. Dieser Parameter wird in Millisekunden definiert. HINWEIS: Dies ist nicht mit der Rate zu verwechseln, mit der das GPS abgefragt wird. Aus Gründen der Energieeinsparung ist es zulässig, die GPS-Abtastrate dynamisch zu variieren. Die Abtastrate kann also schneller oder langsamer sein. „unknown_timer_ms“ ist das Zeitlimit, nach dem der Übergang „UNCERTAIN“ ausgelöst werden soll. Dieser Parameter wird in Millisekunden definiert. Eine ausführliche Erläuterung finden Sie oben.

Definition in Zeile 1400 der Datei gps.h .

void(* init)( GpsGeofenceCallbacks *callbacks)

Öffnet die Geofence-Benutzeroberfläche und stellt die Callback-Routinen für die Implementierung dieser Benutzeroberfläche bereit.

Definition in Zeile 1369 der Datei gps.h .

void(* pause_geofence)(int32_t geofence_id)

Überwachung eines bestimmten Geofences pausieren Parameter: geofence_id – die ID für das Geofence.

Definition in Zeile 1409 der Datei gps.h .

void(* remove_geofence_area)(int32_t geofence_id)

Geofence-Bereich entfernen Nach der Rückgabe der Funktion sollten keine Benachrichtigungen gesendet werden. Parameter: „geofence_id“ – die ID für das Geofence.

Definition in Zeile 1429 der Datei gps.h .

void(* resume_geofence)(int32_t geofence_id, int monitor_transitions)

Überwachung eines bestimmten Geofence fortsetzen Parameter: geofence_id – Die ID für den Geofence. monitor_transitions – Welche Übergänge überwacht werden sollen. Bitweises OR von GPS_GEOFENCE_ENTERED, GPS_GEOFENCE_EXITED und GPS_GEOFENCE_UNCERTAIN. Dadurch wird der Wert ersetzt, der im Aufruf „add_geofence_area“ angegeben wurde.

Definition in Zeile 1421 der Datei gps.h .

size_t-Größe

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