Initialize

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

各機能のInitilizeタイミングや制約について紹介します。

ナビ機能(Navi)

Initializeタイミング

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

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

initialize(NaviInitInfo, NaviInitListener)による初期化完了(onInitCompleted受信)後にNaviクラスが使用可能になります。

初期化時設定項目　

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

NaviInitInfo initInfo = new NaviInitInfo(this);
initInfo.setCloudEnvironment(Common.CloudEnvironment.PRODUCTION);
initInfo.setApiKey(API_KEY); // 具体的なキー(文字列)については営業窓口までお問い合わせください。
initInfo.setTrafficProviderKey(PROVIDER_KEY); // 具体的なキー(文字列)については営業窓口までお問い合わせください。
initInfo.setTrafficProviderUserID(USER_ID); // 具体的なID(文字列)については営業窓口までお問い合わせください。

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().setGuidePointDataChangedListener(new GuidePointDataChangedListener() {
                @Override
                public void onChanged(Navi.GuidePointCreateStatus status) {
                }   
            });

            // 走行情報更新イベントリスナーを追加
            Navi.getInstance().setRunInfoListener(new RunInfoListener() {
                @Override
                public void onUpdate() {}
            });
            // 音声案内イベントリスナーを追加
            Navi.getInstance().setGuideEventListener(new GuideEventListener() {
                @Override
                public void onGuide(Common.GuideEventKind guideEvent, String guidancePhrase, Common.GuideLanguageKind guidanceLanguage) {}
            });
        } else {
            // Naviの初期化失敗　
            // エラー内容によりリトライやネットワークの接続状況確認メッセージ表示,サポートセンターに連絡など
        }
    }
});

検索機能(SearchJP)のInitializeタイミング

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

• アプリ起動時

initialize(SearchInitInfo)後にSearchJPクラスが使用可能になります。

SearchSettingInfoの各propertyは全て設定必須です。

SearchJP.SearchInitInfo searchInitInfo = new SearchJP.SearchInitInfo();
searchInitInfo.setCloudEnvironment(Common.CloudEnvironment.PRODUCTION);
searchInitInfo.setApiKey(API_KEY); // 具体的なキー(文字列)については営業窓口までお問い合わせください。
searchInitInfo.setTrafficProviderKey(PROVIDER_KEY); // 具体的なキー(文字列)については営業窓口までお問い合わせください。
searchInitInfo.setTrafficProviderUserID(USER_ID); // 具体的なID(文字列)については営業窓口までお問い合わせください。

SearchJP.getInstance().initialize(searchInitInfo);

地図表示機能(SupportMapFragment)

Initializeタイミング

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

• Navi.initialize()でNaviの初期化が完了したタイミング、またはAuthenticationStatusChangedListener.onChanged(AuthenticationType: AUTH_APIKEY, status: true)が通知されたタイミング。

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

初期化時設定項目　

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

MapSetting mapSetting = new MapSetting();
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.setOnMapScaleChangeListener(new OnMapScaleChangeListener() {
                @Override
                public void onScaleChanged() {}
            });
        }
    }
});

AndroidAuto用地図表示機能(CarMap)

Initializeタイミング

carMap.initialize(MapSetting, OnMapEventListener)を呼ぶタイミング

• AndroidAuto起動時
• Navi.initialize()でNaviの初期化が完了したタイミング、またはAuthenticationStatusChangedListener.onChanged(AuthenticationType: AUTH_APIKEY, status: true)が通知されたタイミング。

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

初期化時設定項目　

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

// CarAppServiceの生成
public class NavigationService extends CarAppService {

   @NonNull
   @Override
   public HostValidator createHostValidator() {
      return HostValidator.ALLOW_ALL_HOSTS_VALIDATOR;
   }

   @NonNull
   @Override
   public Session onCreateSession() {
      return new NavigationSession();
   }
}

// Sessionの生成
public class NavigationSession extends Session {

   @NonNull
   @Override
   public Screen onCreateScreen(@NonNull Intent intent) {
      return new NavigationScreen(getCarContext());
   }
}

// Screenの生成
public class NavigationScreen extends Screen {

    protected NavigationScreen(@NonNull CarContext carContext) {
        // CarMap初期化
        CarMap carMap = new CarMap(carContext);

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

        carMap.initialize(mapSetting, new OnMapEventListener() {
            @Override
            public void onInitializationCompleted(ErrorCode errorCode) {
                if (errorCode == ErrorCode.NONE) {
                    // getMap()してMapが使用可能
                    Map map = carMap.getMap();
                    
                    Navi.getInstance().attach(map);
                    // AndroidAuto用のライフサイクル設定
                    Navi.getInstance().setAndroidAutoLifecycle(getLifecycle());
                }
            }

            @Override
            public void onRestoreCompleted(Error error) {
                }

            @Override
            public void onMapModeChanged(Map.MapMode mapMode) {
            }
        });

        carMap.setCarMapObserver(new CarMapObserver() {
           @Override
           public void onAttached(@NonNull SurfaceContainer surfaceContainer) {}

           @Override
           public void onDetached(@NonNull SurfaceContainer surfaceContainer) {}

           @Override
           public void onVisibleAreaChanged(@NonNull Rect visibleArea, @NonNull EdgeInsets edgeInsets) {}

           @Override
           public void onStableAreaChanged(@NonNull Rect stableArea, @NonNull EdgeInsets edgeInsets) {}
       });

        carMap.setGestureHandler(new CarMapGestureHandler(){
            @Override
            public void onScroll() {}

            @Override
            public void onFling() {}

            @Override
            public void onScale() {}
        });
    }
}