ロケーションモジュール
React Native用のTealiumロケーションモジュールのインストール方法を学びます。
Tealium for React Nativeは、React NativeアプリケーションでTealiumのネイティブモバイルライブラリ(iOS、Android)を使用することを可能にします。
仕組み
Tealiumのモバイルライブラリは、以下の2つの方法のいずれかを使用してReact Nativeアプリケーションに統合されます:
- NPMパッケージ(推奨)
- 手動でGitHubから
必要条件
- ネイティブビルド環境へのアクセス
- Tealium for React Native v2.2.0+
- React Native 0.63+とそのツールのインストール
- Tealium iQ Mobile Profile
- Android StudioまたはXcode
- Tealium for AndroidまたはTealium for iOS
インストール(NPM/YARN)
React Native用のTealiumロケーションモジュールをNPMでインストールするには:
-
メインの
tealium-react-native
ライブラリのインストール手順をこちらで確認し、少なくともバージョン2.2.0以上をインストールしていることを確認します。 -
React Nativeプロジェクトのルートに移動します。
-
以下のコマンドで
tealium-react-native-location
パッケージをダウンロードしてインストールします:yarn install tealium-react-native-location
JavaScript
アプリに関連するクラスをインポートするには、以下のようにします:
import TealiumLocation from 'tealium-react-native-location';
import { TealiumLocationConfig, Accuracy, DesiredAccuracy, LocationData } from 'tealium-react-native-location/common';
初期化
メインのTealium React Native統合を初期化する前に、ロケーションモジュールを構成します。
必要なすべてのオプションを1つのメソッドで構成するか、ヘルパーメソッドを個別に呼び出すことができます:
let locationConfig: TealiumLocationConfig = {
accuracy: Accuracy.high,
geofenceUrl: "...",
geofenceFile: "...",
interval: 6000, // android only
geofenceEnabled: false, // iOS only
desiredAccuracy: DesiredAccuracy.best, // iOS only
updateDistance: 150 // iOS only
}
TealiumLocation.configure(locationConfig);
// または、それらを個別に呼び出します:
TealiumLocation.setAccuracy(Accuracy.high);
TealiumLocation.setGeofenceUrl(".../...");
// etc
APIリファレンス
ロケーションモジュールとメインのTealium React Native統合が両方とも初期化された後、ロケーショントラッキングの開始または停止を要求したり、最新の既知のロケーションポイントデータを要求することができます。
startLocationTracking()
ロケーションデータのトラッキングを開始します - ロケーショントラッキングを開始する前に、関連する権限が付与されていることを確認する必要があります。
TealiumLocation.startLocationTracking();
stopLocationTracking()
ロケーションデータのトラッキングを停止します - 現在ロケーションデータをトラッキングしている場合にのみ関連します。
TealiumLocation.stopLocationTracking();
lastLocation(callback)
最後に知られているロケーションを要求し、lat
とlng
キーとして緯度と経度の座標を含むオブジェクトを返します - 現在ロケーションデータをトラッキングしている場合にのみ関連します。
TealiumLocation.lastLocation((loc) => {
if (loc) {
Alert.alert(`Lat: ${loc.lat} | Lng: ${loc.lng}`)
}
})
最終更新日 :: 2024年November月6日