ProbeData Setting

この章ではプローブデータの収集設定方法を紹介します。

収集できるプローブデータの種類

DataTypeに設定できる定義と収集頻度は以下になります。

収集を行う

プローブデータの収集はNavi.initialize()のタイミングでNaviInitInfo.setProbeDataSettingInfo()を設定します。

設定が必要な項目は以下の通りです。

NAVI_INFOとROUTE_ACTION_LOGを収集するサンプルコードは以下の通りです。

NaviInitInfo initInfo = new NaviInitInfo(getApplicationContext());

// 認証情報等の設定は割愛

// プローブデータの収集設定を行う
ProbeDataSettingInfo probeDataSettingInfo = new ProbeDataSettingInfo();
probeDataSettingInfo.setCollectDataTypeList(Arrays.asList(
        ProbeDataSettingInfo.DataType.NAVI_INFO, 
        ProbeDataSettingInfo.DataType.ROUTE_ACTION_LOG));
initInfo.setProbeDataSettingInfo(probeDataSettingInfo);

// 初期化開始
Navi.getInstance().initialize(initInfo, (errorCode, naviInitResult) -> {
    if (errorCode == NaviInitListener.ErrorCode.NONE) {
        // データの収集と自動アップロードの開始
        Navi.getInstance().startCollectProbeData();
    }
});

収集を停止する

プローブデータの収集を停止するにはNavi.stopCollectProbeData()を呼び出します。

// プローブデータ収集を停止する
Navi.getInstance().stopCollectProbeData()

プローブデータをアップロードしてから収集を停止したい場合、Navi.forceUploadProbeData()を呼び出し、完了後にNavi.stopCollectProbeData()を呼び出します。

// プローブデータをアップロードしてから収集を停止する
Navi.getInstance().forceUploadProbeData(new ProbeDataForceUploadEventListener() {
    @Override
    public void onCompleted(ErrorCode errorCode) {
        if (errorCode == ErrorCode.NONE) {
            Navi.getInstance().stopCollectProbeData();
        }
    }
});

ACTIVITY_LOG_INFOを収集する場合

ACTIVITY_LOG_INFOの収集は、ユーザーの移動体系の変更を検知するためにActivity Recognition Transition APIを使用します。

そのため以下のアクティビティ権限が必要となります。

• android.permission.ACTIVITY_RECOGNITION
• com.google.android.gms.permission.ACTIVITY_RECOGNITION

AndroidManifest.xmlに上記権限を追加し、ユーザーに使用権限リクエストを行うようにしてください。

アクティビティ権限が許可されない場合でも、基本的な機能(ナビゲーション機能等)は影響なく動作します。

ユーザーが使用権限リクエストを拒否した場合、ACTIVITY_LOG_INFOの収集は無効化されます。

収集したプローブデータを受ける

収集されたプローブデータは、一定間隔でパイオニアのクラウドサーバーへアップロードされます。
SDKを利用するアプリケーションは、このクラウドへのアップロードが成功した時点で
アップロードされたものと同一のデータをコールバックで受け取ることができます。

SDKから収集したプローブデータを受けるには
Navi.addProbeDataUploadEventListener()にてProbeDataUploadEventListenerを追加します。
追加したProbeDataUploadEventListenerはNavi.removeProbeDataUploadEventListener()で削除が可能です。

// リスナーを定義する
ProbeDataUploadEventListener listener = new ProbeDataUploadEventListener() {
    @Override
    public void onUploadedNavigationLog(List<ProbeDataNavigationLog> probeDataNavigationLogList) {
        // ナビゲーションログが通知される
    }

    @Override
    public void onUploadedRouteActionLog(List<ProbeDataRouteActionLog> probeDataRouteActionLogList) {
        // ルートアクションログが通知される
    }

    @Override
    public void onUploadedSystemStatusLog(List<ProbeDataGnssLocation> probeDataGnssLocationList,
                                          List<ProbeDataFusedLocation> probeDataFusedLocationList,
                                          List<ProbeDataMotion> probeDataMotionList,
                                          ProbeDataVehicleInfo probeDataVehicleInfo,
                                          List<ProbeDataActivityLog> probeDataActivityLogList) {
        // システムステータスログが通知される
    }
};

// リスナーを追加する
Navi.getInstance().addProbeDataUploadEventListener(listener);

// リスナーを削除する
Navi.getInstance().removeProbeDataUploadEventListener(listener);

アップロード直前のプローブデータを受ける

SDKから収集したプローブデータを受けるには
Navi.addProbeDataCollectEventListener()にてProbeDataCollectEventListenerを追加します。
追加したProbeDataCollectEventListenerはNavi.removeProbeDataCollectEventListener()で削除が可能です。

// リスナーを定義する
ProbeDataCollectEventListener listener = new ProbeDataCollectEventListener() {
    @Override
    public void onCollectedNavigationLog(List<ProbeDataNavigationLog> probeDataNavigationLogList) {
        // ナビゲーションログが通知される
    }

    @Override
    public void onCollectedRouteActionLog(List<ProbeDataRouteActionLog> probeDataRouteActionLogList) {
        // ルートアクションログが通知される
    }

    @Override
    public void onCollectedSystemStatusLog(List<ProbeDataGnssLocation> probeDataGnssLocationList,
                                          List<ProbeDataFusedLocation> probeDataFusedLocationList,
                                          List<ProbeDataMotion> probeDataMotionList,
                                          ProbeDataVehicleInfo probeDataVehicleInfo,
                                          List<ProbeDataActivityLog> probeDataActivityLogList) {
        // システムステータスログが通知される
    }
};

// リスナーを追加する
Navi.getInstance().addProbeDataCollectEventListener(listener);

// リスナーを削除する
Navi.getInstance().removeProbeDataCollectEventListener(listener);

プローブデータを受けるListenerの使い分けについて

各Listenerの違いは以下の通りです。
どちらを使用するかは目的に応じて決めるとよいでしょう。両方使用することも可能です。