位置情報と目標地点

位置情報は、緯度と経度に加え、事前定義された目標地点を使用して Android アプリで位置データを測定する場合に役立ちます。

trackLocation 呼び出しでは、次の情報が送信されます。

  • Adobe Mobile Services UI で定義されている目標地点(POI)の緯度、経度および位置。

    この情報は、自動レポート用としてモバイルソリューション変数に渡されます。

  • 中心からの距離と、コンテキストデータとして渡される精度。

    これらの変数は、自動ではキャプチャされません。これらのコンテキストデータ変数は、以下の「追加データの送信」の節の手順に従ってマッピングする必要があります。

POI の動的更新

バージョン 4.2 以降、POI は Adobe Mobile UI で定義され、アプリ設定ファイルに動的に同期されます。この同期をおこなうには、ADBMobile JSON 設定analytics.poi 設定をおこなう必要があります。

“analytics.poi”: “https://assets.adobedtm.com/…/yourfile.json”,

これを設定しない場合、ADBMobile.json ファイルの更新バージョンをダウンロードし、アプリに追加する必要があります。詳しくは、「SDK およびテストツールのダウウンロード」を参照してください。

位置情報と POI の追跡

  1. ライブラリをプロジェクトに追加し、ライフサイクルを実装します。

    詳しくは、コア実装とライフサイクルの「IntelliJ IDEA または Eclipse プロジェクトへの SDK と設定ファイルの追加」を参照してください。

  2. ライブラリをインポートします。

    import com.adobe.mobile.*;
    
  3. trackLocation を呼び出して、現在の位置を追跡します。

    Location currentLocation = new Location("my location here"); 
    Analytics.trackLocation(currentLocation, null);
    
    TIP

    いつでも trackLocation を呼び出すことができます。

    ロケーション戦略を使用すると、trackLocation 呼び出しに渡される位置を特定することができます。詳しくは、「Android Location Strategies(Android のロケーション戦略)」を参照してください。

さらに、その位置が定義された POI 半径内にあると判断された場合、a.loc.poi コンテキストデータ変数が trackLocation ヒットと共に送信され、ロケーション分類​レポートで POI としてレポートされます。a.loc.dist コンテキスト変数も、定義された座標からの距離(メートル単位)と共に送信されます。

追加データの送信

位置データに加えて、各位置追跡呼び出しで追加のコンテキストデータを送信することができます。

HashMap<String, Object> locationContextData = new HashMap<String, Object>(); 
locationContextData.put("myapp.location.LocationSource", "GPS"); 
 
Location currentLocation = new Location("my location here"); 
Analytics.trackLocation(currentLocation, locationContextData);

コンテキストデータ値は、Adobe Mobile Services UI でカスタム変数にマップする必要があります。

位置コンテキストデータ

緯度と経度は、合計 6 つのコンテキストデータパラメーターに対し、3 つの異なるコンテキストデータパラメータを使用して送信されます。各パラメーターは異なる精度を表します。

例えば、座標「lat = 40.93231, long = -111.93152」は、1 mの精度で位置を表します。この場所は、次の変数の精度のレベルに従って分割されます。

a.loc.lat.a= 040.9

a.loc.lat.b = 32

a.loc.lat.c = 31

a.loc.lon.a = -111.9

a.loc.lon.b = 31

a.loc.lon.c = 52

現在の位置の精度によっては、一部の精度レベルが 00 と表示されることがあります。例えば、位置の現在の精度が 100 m である場合は、a.loc.lat.ca.loc.lon.c00 が設定されます。

次の情報に留意してください。

  • trackLocation リクエストは、trackAction 呼び出しに相当するものを送信します。

  • POI は一般的な trackAction および trackState 呼び出しの一部として渡されないので、POI を追跡するには trackLocation 呼び出しを使用する必要があります。

  • trackLocation を必要に応じて呼び出し、ロケーションと POI を追跡してください。

    trackLocation は、アプリの起動時に呼び出し、その後はアプリの要件に応じて必要なときに呼び出すことをお勧めします。

  • POI は、アプリケーションの設定ファイルで定義された後にのみ設定されます。

    POI は、以前に送信された履歴の trackLocation 呼び出しには適用されません。

  • trackLocation 呼び出しでは、trackAction 呼び出しと同様の追加コンテキストデータの送信がサポートされます。

  • 2 つの POI の直径が重なっている場合は、現在のロケーションを含む最初の POI が使用されます。

    POI が重複する場合、最も精度の高い POI が確実に報告されるように、POI を精度の高い順にリストする必要があります。

このページ