Initialize

SDK使用時はナビ機能(Navi),地図表示機能(SupportMapFragment)の初期化が必要です。

各機能のInitializeでは認証情報が必要になるため、次のように関数化しておくと便利です。
本章では関数化されている前提で各機能のInitializeタイミングや制約について紹介します。

    private ServerSettingInfo createServerSettingInfo() {
        ApiKeyInfo apiKeyInfo = new ApiKeyInfo();
        apiKeyInfo.setApiKey(Setting.getApiKey()); // 具体的なキー(文字列)については営業窓口までお問い合わせください。
        apiKeyInfo.setTrafficProviderKey(Setting.getTrafficProviderKey()); // 具体的なキー(文字列)については営業窓口までお問い合わせください。
        apiKeyInfo.setTrafficProviderUserID(Setting.getTrafficProviderUserID()); // 具体的なID(文字列)については営業窓口までお問い合わせください。
        return new ServerSettingInfo(apiKeyInfo);
    }

ナビ機能(Navi)

Initializeタイミング

Navi.initialize()を呼ぶタイミング

• アプリ起動時
• NaviInitInfoのユーザー切り替え時

initialize(NaviInitInfo, NaviInitListener)による初期化完了(onInitCompleted受信)後にNaviクラスが使用可能になります。
検索機能(SearchJPクラス)についてもこのタイミングで使用可能になります。

初期化時設定項目　

初期化時に設定が必要な項目は以下の通りです。

NaviInitInfo initInfo = new NaviInitInfo(getApplicationContext());
initInfo.setServerSettingInfo(createServerSettingInfo());

// UserID(このIDを元にクラウドの設定やルート保存が行われるためユニークなIDを推奨)
String userID = "MyAppName" + Settings.Secure.getString(getApplicationContext().getContentResolver(), ANDROID_ID);
initInfo.setUserID(userID);

Navi.getInstance().initialize(initInfo, new NaviInitListener() {
    @Override
    public void onInitCompleted(ErrorCode errorCode, NaviInitResult naviInitResult) {
        if (errorCode == ErrorCode.NONE) {

            // 現在のデバイスの位置情報に基づく現在位置の更新を開始(Positioning機能をONに)する
            Navi.getInstance().startPositioning(new PositioningSetting())

            // ライフサイクル設定
            Navi.getInstance().setMobileAppLifecycle(getLifecycle());

            // 音声案内エンジン初期化
            Navi.getInstance().startVoiceEngine(new VoiceEngineInitListener() {
                @Override
                public void onInitCompleted(ErrorCode errorCode) {}
            });

            // 誘導情報(GuidePointList, PathPointList）更新イベントリスナーを追加
            Navi.getInstance().addGuidePointDataChangedListener(new GuidePointDataChangedListener() {
                @Override
                public void onChanged(Navi.GuidePointCreateStatus status) {
                }   
            });

            // 走行情報更新イベントリスナーを追加
            Navi.getInstance().addRunInfoListener(new RunInfoListener() {
                @Override
                public void onUpdate() {}
            });
            // 音声案内イベントリスナーを追加
            Navi.getInstance().addGuideEventListener(new GuideEventListener() {
                @Override
                public void onGuide(@NonNull Guidance guidance) {}
            });

            // 案内中ルートがある場合、ルート復元
            if (naviInitResult.getRouteResult() != null) {
                Navi.getInstance().restoreRoute(new GetRouteDataListener() {
                    @Override
                    public void onCompleted(@NonNull ErrorCode errorCode, @Nullable GetRouteDataResult getRouteDataResult) {
                    }
                });
            }
        } else {
            // Naviの初期化失敗　
            // エラー内容によりリトライやネットワークの接続状況確認メッセージ表示,サポートセンターに連絡など
        }
    }
});

地図表示機能(SupportMapFragment)

Initializeタイミング

SupportMapFragment.initialize()を呼ぶタイミング

• アプリ起動時

initialize(MapSetting, OnMapEventListener)での初期化完了（onInitializationCompleted受信）後にgetMap()してMapクラスが使用可能になります。

初期化時設定項目　

初期化時に設定が必要な項目は以下の通りです。

MapSetting mapSetting = new MapSetting();
mapSetting.setServerSettingInfo(createServerSettingInfo());
mapSetting.setMapStyle(Map.MapStyle.DEFAULT);

// MapFragment初期化
SupportMapFragment supportMapFragment = (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.mapFragment);
supportMapFragment.initialize(mapSetting, new OnMapEventListener() {
    @Override
    public void onInitializationCompleted(ErrorCode errorCode) {

        if (errorCode == ErrorCode.NONE) {
            // getMap()してMapが使用可能
            Map map = supportMapFragment.getMap();

            // Naviのアタッチ
            Navi.getInstance().attach(map);

            // 長押しイベントリスナー追加
            map.addOnMapLongClickListener(new OnMapLongClickListener() {
                @Override
                public boolean onMapLongClick(GeoCoordinate point) {}
            });

            // 短押しイベントリスナー追加
            map.addOnMapClickListener(new OnMapClickListener() {
                @Override
                public boolean onMapClick(GeoCoordinate point) {}
            });

            // 地図スケール変更イベントリスナー追加
            map.addOnMapScaleChangeListener(new OnMapScaleChangeListener() {
                @Override
                public void onScaleChanged() {}
            });
        }
    }
});