ロケーションモジュール

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でインストールするには：

1. メインのtealium-react-nativeライブラリのインストール手順をこちらで確認し、少なくともバージョン2.2.0以上をインストールしていることを確認します。

2. React Nativeプロジェクトのルートに移動します。

3. 以下のコマンドで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}`)
    }
})