GpsGeofencing مرجع هيكل الواجهة

حقول البيانات
GpsGeofencing مرجع هيكل الواجهة

#include < gps.h >

حقول البيانات

size_t بحجم
فارغ(* init ) ( GpsGeofenceCallbacks * callbacks)
فارغ(* add_geofence_area ) (int32_t geofence_id، double latitude، double longitude، double radius_meters، int last_transition، int monitor_transitions، int notifications_responsiveness_ms، int unknown_timer_ms)
فارغ(* pause_geofence ) (int32_t geofence_id)
فارغ(* استئناف_السياسة الجغرافية ) (int32_t geofence_id، int monitor_transitions)
فارغ(* 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 notifications_responsiveness_ms، int unknown_timer_ms)

أضف منطقة السياج الجغرافي. يدعم واجهة برمجة التطبيقات هذه حاليًا سياجات جغرافية دائرية. المعلمات: geofence_id - معرف السياج الجغرافي. في حالة وجود سياج جغرافي بهذا المعرف بالفعل ، يجب إرجاع قيمة خطأ (GPS_GEOFENCE_ERROR_ID_EXISTS). خط العرض وخط الطول و radius_meters - خطوط العرض والطول ونصف القطر (بالأمتار) للانتقال الأخير للسياج الجغرافي - الحالة الحالية للسياج الجغرافي. على سبيل المثال ، إذا كان النظام يعرف بالفعل أن المستخدم داخل السياج الجغرافي ، فسيتم تعيين هذا على GPS_GEOFENCE_ENTERED. في معظم الحالات ، سيكون GPS_GEOFENCE_UNCERTAIN. monitor_transition - ما هي التحولات التي يجب مراقبتها. على مستوى البت أو من GPS_GEOFENCE_ENTERED و GPS_GEOFENCE_EXITED و GPS_GEOFENCE_UNCERTAIN. إشعار_responsiveness_ms - يحدد أفضل وصف لمدى سرعة استدعاء رد الاتصال عند بدء الانتقال المرتبط بالسياج الجغرافي . على سبيل المثال ، إذا تم ضبطه على 1000 ميل ثانية باستخدام GPS_GEOFENCE_ENTERED ، فيجب استدعاء رد الاتصال 1000 مللي ثانية داخل السياج الجغرافي. يتم تحديد هذه المعلمة بالمللي ثانية. ملحوظة: هذا لا يجب الخلط بينه وبين المعدل الذي يتم استقصاء GPS به. من المقبول تغيير معدل أخذ عينات GPS ديناميكيًا لأسباب تتعلق بتوفير الطاقة ؛ وبالتالي فإن معدل أخذ العينات قد يكون أسرع أو أبطأ من ذلك. unknown_timer_ms - الحد الزمني الذي يجب بعده بدء انتقال UNCERTAIN. يتم تحديد هذه المعلمة بالمللي ثانية. انظر أعلاه للحصول على شرح مفصل.

تعريف في السطر 1400 لملف gps.h.

void (* init) ( GpsGeofenceCallbacks * callbacks)

يفتح واجهة السياج الجغرافي ويوفر إجراءات رد الاتصال لتنفيذ هذه الواجهة.

تعريف في السطر 1369 لملف gps.h.

باطل (* pause_geofence) (int32_t geofence_id)

توقف مؤقتًا عن مراقبة سياج جغرافي معين. المعلمات: geofence_id - معرف السياج الجغرافي.

تعريف في السطر 1409 لملف gps.h.

void (* remove_geofence_area) (int32_t geofence_id)

إزالة منطقة السياج الجغرافي. بعد عودة الوظيفة ، يجب عدم إرسال أي إشعارات. المعلمة: geofence_id - معرف السياج الجغرافي.

تعريف في السطر 1429 لملف gps.h.

باطل (* سيرة ذاتية جغرافية) (int32_t geofence_id ، int monitor_transitions)

استئناف مراقبة سياج جغرافي معين. المعلمات: geofence_id - معرف السياج الجغرافي. monitor_transitions - ما هي التحولات التي يجب مراقبتها. على مستوى البت أو من GPS_GEOFENCE_ENTERED و GPS_GEOFENCE_EXITED و GPS_GEOFENCE_UNCERTAIN. هذا يلغي القيمة المرتبطة المقدمة في استدعاء add_geofence_area.

تعريف في السطر 1421 لملف gps.h.

size_t size

ضبط على sizeof (GpsGeofencingInterface)

تعريف في السطر 1363 لملف gps.h.

تم إنشاء وثائق هذه البنية من الملف التالي: