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()
最終更新日 :: 2024年November月6日