構成プロファイル

Tracelet には、さまざまな使用例に合わせてバックグラウンドの地理位置情報を迅速に設定できるように、いくつかの事前定義された構成プロファイルが付属しています。これらのプロファイルは、バッテリーの消耗と位置精度の間のトレードオフを最適化します。

利用可能なプロファイル

1. バランスのとれた (非変換)

これは、ほとんどのアプリケーションで推奨されるデフォルトです。詳細なルートのキャプチャとバッテリー寿命の維持の間で、高度に最適化されたバランスが提供されます。

対象となる使用例: 配送アプリ、車両追跡、走行距離の記録。
精度: 中～高 (ハードウェアに依存)
距離フィルター: ~20-50 メートル
バッテリーの消耗: 低い (1 時間あたり約 1 ～ 3%)
適応サンプリング: 有効


final config = Config.balanced(
  stopOnTerminate: false,
  startOnBoot: true,
);
await Tracelet.ready(config);

2. 高精度（`Config.highAccuracy()`）

このプロファイルは、GPS ハードウェアを強制的にアクティブにし、可能な限り最高の精度を要求します。ほとんどのバッテリー節約ヒューリスティックが無効になります。

対象となる使用例: ターンバイターンナビゲーション、スポーツトラッキング (ランニング、サイクリング)、正確なジオフェンストリガー。
精度: 最大 (1 ～ 5 メートル)
距離フィルター: 0-10 メートル
バッテリーの消耗: 高 (1 時間あたり約 5 ～ 10%)
適応サンプリング: 無効


final config = Config.highAccuracy(
  stopOnTerminate: false,
  startOnBoot: true,
);
await Tracelet.ready(config);

3. 低電力 (`Config.lowPower()`)

このプロファイルは、電力を大量に消費する GPS チップではなく、主に携帯電話基地局の三角測量と Wi-Fi ネットワークに依存することで、バッテリーへの影響を最小限に抑えます。更新の頻度は低くなり、精度も低くなります。

対象となる使用例: ソーシャルアプリ、天気予報の更新、一般的なエリア追跡。
精度: 都市/近隣レベル (100 ～ 3000 メートル)
距離フィルター: ~500+ メートル
バッテリーの消耗: 無視できる程度 (1 時間あたり 1% 未満)
適応サンプリング: 有効


final config = Config.lowPower(
  stopOnTerminate: false,
  startOnBoot: true,
);
await Tracelet.ready(config);

4. パッシブ (非変換)

このプロファイルは、バッテリー最適化の極限を表しています。 Android では、GPS または Wi-Fi スキャナーがアクティブにオンになりません。代わりに、他のアプリ (Google マップ、天気アプリなど) または OS によって行われた位置リクエストに受動的に「便乗」します。真のパッシブ API がない iOS では、これは可能な限り低い精度 (kCLLocationAccuracyThreeKilometers) に戻り、低電力プロファイルと同様に機能します。

対象となる使用例: 極端なバッテリー節約、ユーザーに影響を与えないバックグラウンドデータ収集。
精度: 可変 (Android では他のアプリのリクエストによって異なります。iOS では 3km)
バッテリーの消耗: ゼロから無視できる程度
適応サンプリング: 無効


final config = Config.passive(
  stopOnTerminate: false,
  startOnBoot: true,
);
await Tracelet.ready(config);

プロファイルのカスタマイズ

プロファイルは、事前に構成された Config インスタンスにすぎません。プロファイルから開始し、.copyWith() を使用して特定のフィールドをオーバーライドできます。


final config = Config.balanced().copyWith(
  geo: GeoConfig(
    distanceFilter: 10, // Override just the distance filter
  ),
  sync: SyncConfig(
    url: 'https://my-api.com/locations',
  ),
);