#include < gps.h >
ממשק מורחב לתמיכה ב-GPS_Geofencing
הגדרה בשורה 1361 של הקובץ gps.h.
void(* add_geofence_area)(int32_t geofence_id, קו רוחב כפול, קו אורך כפול, radius_meters, int last_transition, int monitor_transitions, int notification_responsiveness_ms, int unknown_timer_ms) |
הוסף אזור גיאופנס. ממשק API זה תומך כעת ב-geofences מעגליים. פרמטרים: geofence_id - המזהה של ה-geofence. אם כבר קיים גג גיאוגרפי עם מזהה זה, יש להחזיר ערך שגיאה (GPS_GEOFENCE_ERROR_ID_EXISTS). רוחב, אורך, radius_meters - ה-lat, long ורדיוס (במטרים) עבור ה-geofence last_transition - המצב הנוכחי של ה-geofence. לדוגמה, אם המערכת כבר יודעת שהמשתמש נמצא בתוך ה-geofence, זה יוגדר ל-GPS_GEOFENCE_ENTERED. ברוב המקרים, זה יהיה GPS_GEOFENCE_UNCERTAIN. monitor_transition - אילו מעברים לניטור. או של GPS_GEOFENCE_ENTERED, GPS_GEOFENCE_EXITED ו-GPS_GEOFENCE_UNCERTAIN. notification_responsiveness_ms - מגדיר את התיאור במאמץ הטוב ביותר של כמה מהר יש לקרוא להתקשרות חזרה כאשר המעבר הקשור ל- Geofence מופעל. לדוגמה, אם מוגדר ל-1000 אלפיות שניות עם GPS_GEOFENCE_ENTERED, ההתקשרות חזרה צריכה להיקרא 1000 אלפיות שניות בכניסה ל-geofence. פרמטר זה מוגדר באלפיות שניות. הערה: אין לבלבל את זה עם הקצב שבו ה-GPS נשאל. מקובל לשנות באופן דינמי את קצב הדגימה של ה-GPS מסיבות של חיסכון בחשמל; לפיכך קצב הדגימה עשוי להיות מהיר או איטי יותר מזה. unknown_timer_ms - מגבלת הזמן שאחריה יש להפעיל את המעבר ה-UNCERTAIN. פרמטר זה מוגדר באלפיות שניות. ראה לעיל להסבר מפורט.
הגדרה בשורה 1400 של הקובץ gps.h.
פותח את ממשק ה-geofence ומספק את שגרות ה-callback ליישום ממשק זה.
הגדרה בשורה 1369 של הקובץ gps.h.
void(* pause_geofence)(int32_t geofence_id) |
השהה את הניטור של גיאופנס מסוים. פרמטרים: geofence_id - המזהה של ה-geofence.
הגדרה בשורה 1409 של הקובץ gps.h.
void(* remove_geofence_area)(int32_t geofence_id) |
הסר אזור גיאופנס. לאחר שהפונקציה חוזרת, אין לשלוח התראות. פרמטר: geofence_id - המזהה של ה-geofence.
הגדרה בשורה 1429 של הקובץ gps.h.
void(* resume_geofence)(int32_t geofence_id, int monitor_transitions) |
המשך מעקב אחר גיאופנס מסוים. פרמטרים: geofence_id - המזהה של ה-geofence. monitor_transitions - אילו מעברים לניטור. או של GPS_GEOFENCE_ENTERED, GPS_GEOFENCE_EXITED ו-GPS_GEOFENCE_UNCERTAIN. זה מחליף את הערך המשויך שסופק בקריאה add_geofence_area.
הגדרה בשורה 1421 של הקובץ gps.h.
מוגדר ל-sizeof(GpsGeofencingInterface)
הגדרה בשורה 1363 של הקובץ gps.h.
התיעוד עבור מבנה זה נוצר מהקובץ הבא:
- hardware/libhardware/include/hardware/ gps.h