LocationManager
TealiumのAndroid(Kotlin)用LocationManagerクラスとメソッドのリファレンスガイド。
クラス: LocationManager
LocationManager
クラスは、位置データの収集、ジオフェンスの作成と監視のためのメソッドを提供します。以下は、Tealium KotlinのLocationManager
クラスで一般的に使用されるメソッドをまとめたものです。詳細については、Location moduleを参照してください。
メソッド | 説明 |
---|---|
addGeofence() |
新しいGeofenceLocation をallGeofenceLocationsに作成して追加します。 |
allGeofenceNames() |
すべてのGeofenceLocation 名のリストを返します。 |
lastLocation() |
ユーザーのデバイスの最後の既知の位置情報を返します。 |
lastLocationLatitude() |
最後の位置情報の緯度を返します。 |
lastLocationLongitude() |
最後の位置情報の経度を返します。 |
startLocationTracking() |
望む精度と更新間隔で位置追跡を開始します。 |
stopLocationTracking() |
位置追跡の更新を停止します。 |
addGeofence()
手動でジオフェンスを作成し、監視用に追加する機能を提供します。
tealiumInstance.location?.addGeofence(
"Tealium-HQ",
45.0, // 緯度
100.0, // 経度
100, // 半径
-1, // 有効期限
0, // 滞在時間
true, // ジオフェンス入場時にイベントをトリガー
true) // ジオフェンス退出時にイベントをトリガー
パラメータ | タイプ | 説明 | 例 |
---|---|---|---|
name |
String |
位置の名前 | "Tealium-HQ" |
latitude |
Double |
位置の緯度 | 45.0 |
longitude |
Double |
位置の経度 | 100.0 |
radius |
Int |
ジオフェンスの半径(メートル) | 100 |
expireTime |
Int |
ジオフェンスの有効期限(ミリ秒) | -1 |
loiterTime |
Int |
ジオフェンスに入ってから滞在するまでの時間(ミリ秒) | 0 |
triggerEnter |
Boolean |
ジオフェンスに入った際にイベントをトリガーするか | true |
triggerExit |
Boolean |
ジオフェンスから出た際にイベントをトリガーするか | true |
allGeofenceNames()
監視するすべてのジオフェンス名のリストを返します。
tealiumInstance.location?.allGeofenceNames()
lastLocation()
ユーザーのデバイスの最新の位置情報を返します。位置情報が利用不可能な場合はnull
を返します。
val location = tealiumInstance.location?.lastLocation()
lastLocationLatitude()
ユーザーのデバイスの最新の位置情報の緯度を返します。
val latitude = tealiumInstance.location?.lastLocationLatitude()
lastLocationLongitude()
ユーザーのデバイスの最新の位置情報の経度を返します。
val longitude = tealiumInstance.location?.lastLocationLongitude()
startLocationTracking()
連続的な位置追跡を開始し、位置更新の精度と間隔(ミリ秒)を構成します。正確な位置情報と頻繁な位置更新間隔はバッテリー消費に影響を与える可能性があります。
tealiumInstance.location?.startLocationTracking(true, 1000)
パラメータ | タイプ | 説明 | 例 |
---|---|---|---|
isHighAcuracy |
Boolean |
高精度の位置追跡を行う場合はtrue 、100メートル以内の精度で良い場合はfalse |
true |
updateInterval |
Int |
位置更新の頻度を好みの間隔(ミリ秒)で構成 | 10000 |
stopLocationTracking()
連続的な位置追跡の更新を停止します。
tealiumInstance.location?.stopLocationTracking()
最終更新日 :: 2025年September月11日