GpsGeofencingInterface स्ट्रक्चर का रेफ़रंस

GpsGeofencingInterface स्ट्रक्चर का रेफ़रंस

#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 की सहायता के लिए बेहतर इंटरफ़ेस

परिभाषा, gps.h की लाइन 1361 पर दी गई है.

फ़ील्ड का दस्तावेज़

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)

कोई जियोफ़ेंस जोड़ें. फ़िलहाल, यह एपीआई सर्कुलर जियोफ़ेंस के साथ काम करता है. पैरामीटर: geofence_id - जियोफ़ेंस का आईडी. अगर इस आईडी वाला कोई जियोफ़ेंस पहले से मौजूद है, तो गड़बड़ी की वैल्यू (GPS_GEOFENCE_ERROR_ID_EXISTS) दिखनी चाहिए. latitude, longtitude, radius_meters - जियोफ़ेंस के लिए अक्षांश, देशांतर, और त्रिज्या (मीटर में) last_transition - जियोफ़ेंस की मौजूदा स्थिति. उदाहरण के लिए, अगर सिस्टम को पहले से पता है कि उपयोगकर्ता जियोफ़ेंस के अंदर है, तो यह वैल्यू GPS_GEOFENCE_ENTERED पर सेट हो जाएगी. ज़्यादातर मामलों में, यह GPS_GEOFENCE_UNCERTAIN होगा. monitor_transition - किन ट्रांज़िशन को मॉनिटर करना है. GPS_GEOFENCE_ENTERED, GPS_GEOFENCE_EXITED, और GPS_GEOFENCE_UNCERTAIN के बिटवाइज़ OR. notification_responsiveness_ms - इससे यह पता चलता है कि जियोफ़ेंस से जुड़ा ट्रांज़िशन ट्रिगर होने पर, कॉलबैक को कितनी जल्दी कॉल किया जाना चाहिए. उदाहरण के लिए, अगर GPS_GEOFENCE_ENTERED के साथ 1,000 मिलीसेकंड पर सेट किया गया है, तो जियोफ़ेंस में प्रवेश करने के 1,000 मिलीसेकंड के अंदर कॉलबैक को कॉल किया जाना चाहिए. इस पैरामीटर की वैल्यू मिलीसेकंड में दी जाती है. ध्यान दें: इसे उस दर से न जोड़ें जिस पर जीपीएस को पोल किया जाता है. बैटरी बचाने के लिए, जीपीएस सैंपलिंग की दर को डाइनैमिक तौर पर बदला जा सकता है. इसलिए, सैंपलिंग की दर इससे ज़्यादा या कम हो सकती है. unknown_timer_ms - वह समयसीमा जिसके बाद UNCERTAIN ट्रांज़िशन ट्रिगर होना चाहिए. इस पैरामीटर की वैल्यू मिलीसेकंड में दी जाती है. ज़्यादा जानकारी के लिए ऊपर देखें.

परिभाषा, gps.h फ़ाइल की लाइन 1400 पर दी गई है.

void(* init)( GpsGeofenceCallbacks *callbacks)

यह जियोफ़ेंस इंटरफ़ेस खोलता है और इस इंटरफ़ेस को लागू करने के लिए कॉलबैक रूटीन उपलब्ध कराता है.

परिभाषा, gps.h फ़ाइल की लाइन 1369 पर दी गई है.

void(* pause_geofence)(int32_t geofence_id)

किसी खास जियोफ़ेंस को मॉनिटर करने की सुविधा रोकना. पैरामीटर: geofence_id - जियोफ़ेंस का आईडी.

परिभाषा, gps.h फ़ाइल की लाइन 1409 पर दी गई है.

void(* remove_geofence_area)(int32_t geofence_id)

जियोफ़ेंस वाला कोई इलाका हटाना. फ़ंक्शन के रिटर्न होने के बाद, कोई सूचना नहीं भेजी जानी चाहिए. पैरामीटर: geofence_id - जियोफ़ेंस का आईडी.

परिभाषा, gps.h फ़ाइल की लाइन 1429 पर दी गई है.

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

किसी खास जियोफ़ेंस को मॉनिटर करना फिर से शुरू करना. पैरामीटर: geofence_id - यह जियोफ़ेंस का आईडी है. monitor_transitions - यह तय करता है कि किन ट्रांज़िशन को मॉनिटर करना है. GPS_GEOFENCE_ENTERED, GPS_GEOFENCE_EXITED, और GPS_GEOFENCE_UNCERTAIN का बिटवाइज़ OR. यह वैल्यू, add_geofence_area कॉल में दी गई वैल्यू की जगह ले लेती है.

परिभाषा, gps.h फ़ाइल की लाइन 1421 पर दी गई है.

size_t size

sizeof(GpsGeofencingInterface) पर सेट करें

परिभाषा, gps.h फ़ाइल की लाइन 1363 पर दी गई है.


इस स्ट्रक्चर का दस्तावेज़, इस फ़ाइल से जनरेट किया गया था:
  • hardware/libhardware/include/hardware/ gps.h