Tham chiếu cấu trúc GpsGeofencingInterface

Tham chiếu cấu trúc GpsGeofencingInterface

#include < gps.h >

Trường dữ liệu

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)
 

Nội dung mô tả chi tiết

Giao diện mở rộng để hỗ trợ GPS_Geofencing

Định nghĩa tại dòng 1361 của tệp gps.h .

Tài liệu về trường

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)

Thêm khu vực khoanh vùng địa lý. API này hiện hỗ trợ khoanh vùng địa lý hình tròn. Tham số: geofence_id – Mã nhận dạng cho khoanh vùng địa lý. Nếu một khoanh vùng địa lý có mã nhận dạng này đã tồn tại, thì hệ thống sẽ trả về một giá trị lỗi (GPS_GEOFENCE_ERROR_ID_EXISTS). latitude, longtitude, radius_meters – Vĩ độ, kinh độ và bán kính (tính bằng mét) của khoanh vùng địa lý last_transition – Trạng thái hiện tại của khoanh vùng địa lý. Ví dụ: nếu hệ thống đã biết rằng người dùng đang ở trong khoanh vùng địa lý, thì giá trị này sẽ được đặt thành GPS_GEOFENCE_ENTERED. Trong hầu hết các trường hợp, giá trị này sẽ là GPS_GEOFENCE_UNCERTAIN. monitor_transition – Các chuyển đổi cần theo dõi. Bitwise OR của GPS_GEOFENCE_ENTERED, GPS_GEOFENCE_EXITED và GPS_GEOFENCE_UNCERTAIN. notification_responsiveness_ms – Xác định nội dung mô tả nỗ lực tốt nhất về thời điểm gọi lại khi quá trình chuyển đổi liên kết với Vùng khoanh vùng địa lý được kích hoạt. Ví dụ: nếu bạn đặt thành 1000 mili giây bằng GPS_GEOFENCE_ENTERED, thì lệnh gọi lại sẽ được gọi 1000 mili giây trong khi vào khoanh vùng địa lý. Tham số này được xác định bằng mili giây. LƯU Ý: Bạn không nên nhầm lẫn tốc độ này với tốc độ thăm dò của GPS. Bạn có thể thay đổi linh hoạt tốc độ lấy mẫu GPS vì lý do tiết kiệm pin; do đó, tốc độ lấy mẫu có thể nhanh hơn hoặc chậm hơn tốc độ này. unknown_timer_ms – Giới hạn thời gian sau đó sẽ kích hoạt quá trình chuyển đổi UNCERTAIN. Tham số này được xác định bằng mili giây. Hãy xem phần trên để biết nội dung giải thích chi tiết.

Định nghĩa tại dòng 1400 của tệp gps.h .

void(* init)( GpsGeofenceCallbacks *callbacks)

Mở giao diện khoanh vùng địa lý và cung cấp các quy trình gọi lại để triển khai giao diện này.

Định nghĩa tại dòng 1369 của tệp gps.h .

void(* pause_geofence)(int32_t geofence_id)

Tạm dừng giám sát một khoanh vùng địa lý cụ thể. Tham số: geofence_id – Mã nhận dạng cho khoanh vùng địa lý.

Định nghĩa tại dòng 1409 của tệp gps.h .

void(* remove_geofence_area)(int32_t geofence_id)

Xoá khu vực khoanh vùng địa lý. Sau khi hàm trả về, hệ thống sẽ không gửi thông báo nào. Tham số: geofence_id – Mã nhận dạng cho khoanh vùng địa lý.

Định nghĩa tại dòng 1429 của tệp gps.h .

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

Tiếp tục giám sát một khoanh vùng địa lý cụ thể. Tham số: geofence_id – Mã nhận dạng cho khoanh vùng địa lý. monitor_transitions – Quá trình chuyển đổi cần theo dõi. Toán tử OR bit của GPS_GEOFENCE_ENTERED, GPS_GEOFENCE_EXITED và GPS_GEOFENCE_UNCERTAIN. Giá trị này thay thế giá trị được liên kết được cung cấp trong lệnh gọi add_geofence_area.

Định nghĩa tại dòng 1421 của tệp gps.h .

size_t size

đặt thành sizeof(GpsGeofencingInterface)

Định nghĩa tại dòng 1363 của tệp gps.h .


Tài liệu cho cấu trúc này được tạo từ tệp sau:
  • hardware/libhardware/include/hardware/ gps.h