#include < gps.h >

שדות נתונים
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)

תיאור מפורט

ממשק מורחב לתמיכה ב-GPS_Geofencing

ההגדרה מופיעה בשורה 1361 בקובץ gps.h .

מסמכי תיעוד של שדה

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)

מוסיפים אזור גדר גיאוגרפית. בשלב הזה, ה-API הזה תומך במתחמים גיאוגרפיים עגולים. פרמטרים: geofence_id – המזהה של הגדרת הגבול הווירטואלי. אם כבר קיים גדר גיאוגרפית עם המזהה הזה, צריך להחזיר ערך שגיאה (GPS_GEOFENCE_ERROR_ID_EXISTS). latitude, longtitude, radius_meters – קו הרוחב, קו האורך והרדיוס (במטרים) של הגדר הגיאוגרפית. last_transition – המצב הנוכחי של הגדר הגיאוגרפית. לדוגמה, אם המערכת כבר יודעת שהמשתמש נמצא בתוך הגדרת ה-Geofence, הערך יהיה GPS_GEOFENCE_ENTERED. ברוב המקרים, הערך יהיה GPS_GEOFENCE_UNCERTAIN. ‏ monitor_transition – אילו מעברים צריך לעקוב אחריהם. או בינארי של GPS_GEOFENCE_ENTERED, ‏ GPS_GEOFENCE_EXITED ו-GPS_GEOFENCE_UNCERTAIN. notification_responsiveness_ms – מגדיר את התיאור של המאמץ הטוב ביותר לגבי המועד שבו צריך להפעיל את הקריאה החוזרת (callback) כשמתרחש המעבר שמשויך ל Geofence . לדוגמה, אם מגדירים 1,000 אלפיות השנייה עם GPS_GEOFENCE_ENTERED, צריך להפעיל את הפונקציה החוזרת 1,000 אלפיות השנייה לאחר הכניסה למתחם הגיאופוני. הפרמטר הזה מוגדר באלפיות שנייה. הערה: אין לבלבל בין התדירות הזו לבין התדירות שבה מתבצע הסקרים של ה-GPS. מותר לשנות באופן דינמי את קצב הדגימה של ה-GPS מסיבות של חיסכון באנרגיה, כך שקצב הדגימה עשוי להיות מהיר או איטי יותר. unknown_timer_ms – מגבלת הזמן שאחריה צריך להפעיל את המעבר לסטטוס UNCERTAIN. הפרמטר הזה מוגדר באלפיות שנייה. הסבר מפורט מופיע למעלה.

ההגדרה מופיעה בשורה 1400 בקובץ gps.h .

void(* init)( GpsGeofenceCallbacks *callbacks)

פתיחת הממשק של הגדרת גבולות גיאוגרפיים ומתן פונקציות ה-callback להטמעה של הממשק הזה.

ההגדרה מופיעה בשורה 1369 בקובץ gps.h .

void(* pause_geofence)(int32_t geofence_id)

השהיית המעקב אחרי גדר גיאוגרפית מסוימת. פרמטרים: geofence_id – המזהה של הגדרת הגבול הווירטואלי.

ההגדרה מופיעה בשורה 1409 בקובץ gps.h .

void(* remove_geofence_area)(int32_t geofence_id)

הסרת אזור גדר גיאוגרפית. אחרי שהפונקציה חוזרת, לא אמורות להישלח התראות. פרמטר: geofence_id – המזהה של הגדרת הגבול הווירטואלי.

ההגדרה מופיעה בשורה 1429 בקובץ gps.h .

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

המשך המעקב אחרי גדר גיאוגרפית מסוימת. פרמטרים: geofence_id – המזהה של המכשול הגיאוגרפי. monitor_transitions – המעברים שרוצים לעקוב אחריהם. ביטוי OR בינארי של GPS_GEOFENCE_ENTERED, ‏ GPS_GEOFENCE_EXITED ו-GPS_GEOFENCE_UNCERTAIN. הערך הזה מחליף את הערך המשויך שסופק בקריאה add_geofence_area.

ההגדרה מופיעה בשורה 1421 בקובץ gps.h .

size_t size

מוגדר לערך sizeof(GpsGeofencingInterface)

ההגדרה מופיעה בשורה 1363 בקובץ gps.h .

התיעוד של המבנה הזה נוצר מהקובץ הבא:

hardware/libhardware/include/hardware/ gps.h

הפניה ל-struct של GpsGeofencingInterface

שדות נתונים

תיאור מפורט

מסמכי תיעוד של שדה