#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)

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

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

void(* init)( GpsGeofenceCallbacks *callbacks)

يفتح واجهة سياج جغرافي ويقدّم إجراءات الاستدعاء لتنفيذ هذه الواجهة.

التعريف في السطر 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

تم ضبطه على sizeof(GpsGeofencingInterface)

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

تم إنشاء مستندات هذه البنية من الملف التالي:

hardware/libhardware/include/hardware/ gps.h

مرجع بنية GpsGeofencingInterface

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

وصف مفصّل

مستندات الحقل