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 - ジオフェンスの緯度、経度、半径（メートル単位）last_transition - ジオフェンスの現在の状態。たとえば、ユーザーがジオフェンス内にいることがシステムですでにわかっている場合は、GPS_GEOFENCE_ENTERED に設定されます。ほとんどの場合、GPS_GEOFENCE_UNCERTAIN になります。monitor_transition - モニタリングする遷移。GPS_GEOFENCE_ENTERED、GPS_GEOFENCE_EXITED、GPS_GEOFENCE_UNCERTAIN のビットごとの OR。notification_responsiveness_ms - ジオフェンス に関連付けられた遷移がトリガーされたときに、コールバックを呼び出すまでの最短時間をベスト エフォート方式で定義します。たとえば、GPS_GEOFENCE_ENTERED で 1, 000 ミリ秒に設定した場合、ジオフェンスに進入してから 1, 000 ミリ秒以内にコールバックが呼び出されます。このパラメータはミリ秒単位で定義されます。注: これは、GPS がポーリングされるレートとは異なります。省電力のため、GPS のサンプリング レートを動的に変更できます。そのため、サンプリング レートは、この値よりも速くなったり遅くなったりすることがあります。unknown_timer_ms - UNCERTAIN 遷移をトリガーするまでの時間制限。このパラメータはミリ秒単位で定義されます。詳しくは、上記をご覧ください。

ファイル 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 - モニタリングする遷移。GPS_GEOFENCE_ENTERED、GPS_GEOFENCE_EXITED、GPS_GEOFENCE_UNCERTAIN のビット演算 OR。これは、add_geofence_area 呼び出しで指定された値に優先されます。

ファイル gps.h の 1421 行の定義。

size_t size

sizeof(GpsGeofencingInterface) に設定

ファイル gps.h の 1363 行の定義。

この構造体のドキュメントは、次のファイルから生成されました。
  • hardware/libhardware/include/hardware/ gps.h