GpsGeofencingInterface 結構體參考資料

新增地理圍欄區域。這個 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 行。

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

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

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

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

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

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

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

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

設為 sizeof(GpsGeofencingInterface)

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