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)

新增地理圍欄區域。這個 API 目前支援圓形地理圍欄。參數：geofence_id - 地理圍欄 ID。如果已存在這個 ID 的地理圍欄，系統應會傳回錯誤值 (GPS_GEOFENCE_ERROR_ID_EXISTS)。latitude、longtitude、radius_meters - 地理圍欄的 lat、long 和半徑 (以公尺為單位)。last_transition - 地理圍欄目前的狀態。舉例來說，如果系統已知曉使用者位於地理圍欄內，就會將此值設為 GPS_GEOFENCE_ENTERED。在大多數情況下，這會是 GPS_GEOFENCE_UNCERTAIN。monitor_transition - 要監控哪些轉換。將 GPS_GEOFENCE_ENTERED、GPS_GEOFENCE_EXITED 和 GPS_GEOFENCE_UNCERTAIN 以位元運算 OR 連結。notification_responsiveness_ms - 定義最佳努力描述，說明在觸發與 Geofence 相關聯的轉換時，應在多久後呼叫回呼。舉例來說，如果設定為 1000 毫秒，且使用 GPS_GEOFENCE_ENTERED，則回呼應在進入地理圍欄後 1000 毫秒內呼叫。此參數以毫秒為單位。注意：請勿將此與 GPS 輪詢速率混淆。為節省電力，您可以動態調整 GPS 取樣率，因此取樣率可能會比這更快或更慢。unknown_timer_ms - 超過這段時間後，系統應觸發「不明確」轉換。此參數以毫秒為單位。請參閱上方的詳細說明。

定義位於檔案 gps.h 的 1400 行。

void(* init)( GpsGeofenceCallbacks *callbacks)

開啟地理圍欄介面，並為此介面的實作提供回呼例程。

定義位於檔案 gps.h 的 1369 行。

void(* pause_geofence)(int32_t geofence_id)

暫停監控特定地理圍欄。參數：geofence_id - 地理圍欄的 ID。

定義位於檔案 gps.h 的 1409 行。

void(* remove_geofence_area)(int32_t geofence_id)

移除地理圍欄區域。函式傳回後，系統不應傳送任何通知。參數：geofence_id - 地理圍欄 ID。

定義位於檔案 gps.h 的 1429 行。

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

繼續監控特定地理圍欄。參數：geofence_id - 地理圍欄的 ID。monitor_transitions - 要監控的轉換。位元 OR 運算的 GPS_GEOFENCE_ENTERED、GPS_GEOFENCE_EXITED 和 GPS_GEOFENCE_UNCERTAIN。這會取代 add_geofence_area 呼叫中提供的相關值。

定義位於檔案 gps.h 的 1421 行。

size_t size

設為 sizeof(GpsGeofencingInterface)

定義位於檔案 gps.h 的 1363 行。

這個結構體的說明文件是由下列檔案產生：
  • hardware/libhardware/include/hardware/ gps.h