#include < gps.h >
อินเทอร์เฟซเพิ่มเติมสำหรับการรองรับ GPS_Geofencing
คำจำกัดความที่บรรทัด 1361 ของไฟล์ gps.h
เป็นโมฆะ (* add_geofence_area) (int32_t geofence_id, ละติจูดคู่, ลองจิจูดคู่, radius_meters คู่, int Last_transition, int monitor_transitions, int alert_responsiveness_ms, intknown_timer_ms) |
เพิ่มพื้นที่ขอบเขตภูมิศาสตร์ ปัจจุบัน API นี้รองรับ Geofence แบบวงกลม พารามิเตอร์: geofence_id - รหัสสำหรับขอบเขตภูมิศาสตร์ หากมีขอบเขตภูมิศาสตร์ที่มีรหัสนี้อยู่แล้ว ควรส่งคืนค่าข้อผิดพลาด (GPS_GEOFENCE_ERROR_ID_EXISTS) ละติจูด, ลองจิจูด, radius_meters - ค่าละติจูด, ยาว และรัศมี (เป็นเมตร) สำหรับขอบเขตภูมิศาสตร์ Last_transition - สถานะปัจจุบันของขอบเขตภูมิศาสตร์ ตัวอย่างเช่น หากระบบรู้อยู่แล้วว่าผู้ใช้อยู่ภายในขอบเขตภูมิศาสตร์ สิ่งนี้จะถูกตั้งค่าเป็น GPS_GEOFENCE_ENTERED ในกรณีส่วนใหญ่ มันจะเป็น GPS_GEOFENCE_UNCERTAIN monitor_transition - การเปลี่ยนแปลงใดที่ต้องตรวจสอบ บิตหรือของ GPS_GEOFENCE_ENTERED, GPS_GEOFENCE_EXITED และ GPS_GEOFENCE_UNCERTAIN alert_responsiveness_ms - กำหนดคำอธิบายความพยายามอย่างดีที่สุดว่าควรโทรกลับเร็วเพียงใดเมื่อทริกเกอร์การเปลี่ยนแปลงที่เกี่ยวข้องกับ Geofence ตัวอย่างเช่น หากตั้งค่าเป็น 1,000 มิลลิวินาทีด้วย GPS_GEOFENCE_ENTERED การโทรกลับควรถูกเรียกว่า 1,000 มิลลิวินาทีภายในการเข้าสู่ขอบเขตภูมิศาสตร์ พารามิเตอร์นี้ถูกกำหนดเป็นมิลลิวินาที หมายเหตุ: อย่าสับสนกับอัตราที่ GPS สำรวจ เป็นที่ยอมรับได้ในการเปลี่ยนแปลงอัตราการสุ่มตัวอย่าง GPS แบบไดนามิกเพื่อเหตุผลในการประหยัดพลังงาน ดังนั้นอัตราการสุ่มตัวอย่างอาจจะเร็วหรือช้ากว่านี้ก็ได้ known_timer_ms - ขีดจำกัดเวลาหลังจากนั้นควรทริกเกอร์การเปลี่ยนแปลง UNCERTAIN พารามิเตอร์นี้ถูกกำหนดเป็นมิลลิวินาที ดูด้านบนสำหรับคำอธิบายโดยละเอียด
คำจำกัดความที่บรรทัด 1400 ของไฟล์ gps.h
เปิดอินเทอร์เฟซขอบเขตภูมิศาสตร์และจัดเตรียมรูทีนการโทรกลับเพื่อใช้งานอินเทอร์เฟซนี้
คำจำกัดความที่บรรทัด 1369 ของไฟล์ gps.h
เป็นโมฆะ (* Pause_geofence) (int32_t geofence_id) |
หยุดการตรวจสอบขอบเขตภูมิศาสตร์เฉพาะชั่วคราว พารามิเตอร์: geofence_id - รหัสสำหรับขอบเขตภูมิศาสตร์
คำจำกัดความที่บรรทัด 1409 ของไฟล์ gps.h
เป็นโมฆะ (* Remove_geofence_area) (int32_t geofence_id) |
ลบพื้นที่ขอบเขตภูมิศาสตร์ หลังจากที่ฟังก์ชันกลับมาแล้ว ไม่ควรส่งการแจ้งเตือน พารามิเตอร์: geofence_id - รหัสสำหรับขอบเขตภูมิศาสตร์
คำจำกัดความที่บรรทัด 1429 ของไฟล์ gps.h
เป็นโมฆะ (* resume_geofence) (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
ตั้งค่าเป็น sizeof (GpsGeofencingInterface)
คำจำกัดความที่บรรทัด 1363 ของไฟล์ gps.h
เอกสารประกอบสำหรับโครงสร้างนี้สร้างขึ้นจากไฟล์ต่อไปนี้:
- ฮาร์ดแวร์ / libhardware / รวม / ฮาร์ดแวร์ / gps.h