HERE SDKを統合する

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
    ...
}

dependencies {
    implementation(fileTree(mapOf(
        "dir" to "libs",
        "include" to listOf("*.aar", "*.jar"),
        "exclude" to listOf("*mock*.jar")
    )))
    ...
}

import android.content.Context;

import com.here.sdk.core.engine.AuthenticationMode;
import com.here.sdk.core.engine.SDKNativeEngine;
import com.here.sdk.core.engine.SDKOptions;
import com.here.sdk.core.errors.InstantiationErrorException;

...

private void initializeHERESDK() {
    // Set your credentials for the HERE SDK.
    String accessKeyID = "YOUR_ACCESS_KEY_ID";
    String accessKeySecret = "YOUR_ACCESS_KEY_SECRET";
    AuthenticationMode authenticationMode = AuthenticationMode.withKeySecret(accessKeyID, accessKeySecret);
    SDKOptions options = new SDKOptions(authenticationMode);

    try {
        Context context = this;
        SDKNativeEngine.makeSharedInstance(context, options);
    } catch (InstantiationErrorException e) {
        throw new RuntimeException("Initialization of HERE SDK failed: " + e.error.name());
    }
}

import android.content.Context;

import com.here.sdk.core.engine.AuthenticationMode;
import com.here.sdk.core.engine.SDKNativeEngine;
import com.here.sdk.core.engine.SDKOptions;
import com.here.sdk.core.errors.InstantiationErrorException;

...

private fun initializeHERESDK() {
    // Set your credentials for the HERE SDK.
    val accessKeyID = "YOUR_ACCESS_KEY_ID"
    val accessKeySecret = "YOUR_ACCESS_KEY_SECRET"
    val authenticationMode = AuthenticationMode.withKeySecret(accessKeyID, accessKeySecret)
    val options = SDKOptions(authenticationMode)
    try {
        val context = this
        SDKNativeEngine.makeSharedInstance(context, options)
    } catch (e: InstantiationErrorException) {
        throw RuntimeException("Initialization of HERE SDK failed: " + e.error.name)
    }
}

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Usually, you need to initialize the HERE SDK only once during the lifetime of an application.
    // Before creating a MapView instance please make sure that the HERE SDK is initialized.
    // Since in this example we inflate the MapView from a layout, make sure to initialize
    // the HERE SDK before calling setContentView(...).
    initializeHERESDK();

    setContentView(R.layout.activity_main);
    ...
}

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    // Usually, you need to initialize the HERE SDK only once during the lifetime of an application.
    // Before creating a MapView instance please make sure that the HERE SDK is initialized.
    // Since in this example we inflate the MapView from a layout, make sure to initialize
    // the HERE SDK before calling setContentView(...).
    initializeHERESDK()

    enableEdgeToEdge()

    // Note that this example uses XML layouts. If you want to use Jetpack Compose,
    // take a look at other example apps on GitHub, for example,
    // "RoutingKotlin" uses declarative UIs with Jetpack Compose.
    setContentView(R.layout.activity_main)

    ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main)) { v, insets ->
        val systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars())
        v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom)
        insets
    }
    ...
}

private void disposeHERESDK() {
    // Free HERE SDK resources before the application shuts down.
    // Usually, this should be called only on application termination.
    // Afterwards, the HERE SDK is no longer usable unless it is initialized again.
    SDKNativeEngine sdkNativeEngine = SDKNativeEngine.getSharedInstance();
    if (sdkNativeEngine != null) {
        sdkNativeEngine.dispose();
        // For safety reasons, we explicitly set the shared instance to null to avoid situations,
        // where a disposed instance is accidentally reused.
        SDKNativeEngine.setSharedInstance(null);
    }
}

private fun disposeHERESDK() {
    // Free HERE SDK resources before the application shuts down.
    // Usually, this should be called only on application termination.
    // Afterwards, the HERE SDK is no longer usable unless it is initialized again.
    SDKNativeEngine.getSharedInstance()?.dispose()
    // For safety reasons, we explicitly set the shared instance to null to avoid situations,
    // where a disposed instance is accidentally reused.
    SDKNativeEngine.setSharedInstance(null)
}

@Override
protected void onDestroy() {
    mapView.onDestroy();
    disposeHERESDK();
    super.onDestroy();
}

override fun onDestroy() {
    mapView?.onDestroy()
    disposeHERESDK()
    super.onDestroy()
}

<com.here.sdk.mapview.MapView
   android:id="@+id/map_view"
   android:layout_width="match_parent"
   android:layout_height="match_parent">
</com.here.sdk.mapview.MapView>

private MapView mapView;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Usually, you need to initialize the HERE SDK only once during the lifetime of an application.
    initializeHERESDK();

    setContentView(R.layout.activity_main);

    // Get a MapView instance from the layout.
    mapView = findViewById(R.id.map_view);
    mapView.onCreate(savedInstanceState);
    ...
}

private var mapView: MapView? = null

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    // Usually, you need to initialize the HERE SDK only once during the lifetime of an application.
    // Before creating a MapView instance please make sure that the HERE SDK is initialized.
    initializeHERESDK()

    enableEdgeToEdge()
    setContentView(R.layout.activity_main)
    ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main)) { v, insets ->
        val systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars())
        v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom)
        insets
    }

    // Get a MapView instance from the layout.
    mapView = findViewById(R.id.map_view)
    mapView?.onCreate(savedInstanceState)
    ...
}

private void loadMapScene() {
    // The camera can be configured before or after a scene is loaded.
    double distanceInMeters = 1000 * 10;
    MapMeasure mapMeasureZoom = new MapMeasure(MapMeasure.Kind.DISTANCE_IN_METERS, distanceInMeters);
    mapView.getCamera().lookAt(new GeoCoordinates(52.530932, 13.384915), mapMeasureZoom);

    // Load a scene from the HERE SDK to render the map with a map scheme.
    mapView.getMapScene().loadScene(MapScheme.NORMAL_DAY, new MapScene.LoadSceneCallback() {
        @Override
        public void onLoadScene(@Nullable MapError mapError) {
            if (mapError != null) {
                Log.d("HelloMap", "Loading map failed: mapError: " + mapError.name());
            }
        }
    });
}

private fun loadMapScene() {
    // Load a scene from the HERE SDK to render the map with a map scheme.
    mapView?.mapScene?.loadScene(MapScheme.NORMAL_DAY) { mapError ->
        if (mapError == null) {
            val distanceInMeters = (1000 * 10).toDouble()
            val mapMeasureZoom = MapMeasure(MapMeasure.Kind.DISTANCE_IN_METERS, distanceInMeters)
            mapView?.camera?.lookAt(GeoCoordinates(52.530932, 13.384915), mapMeasureZoom)
        } else {
            Log.d(TAG, "Loading map failed: mapError: " + mapError.name)
        }
    }
}

@Override
protected void onCreate(Bundle savedInstanceState) {
    ...
    loadMapScene();
}

override fun onCreate(savedInstanceState: Bundle?) {
    ...
    loadMapScene()
}

Map<String, String> mapFeatures = new HashMap<>();
mapFeatures.put(MapFeatures.LANDMARKS, MapFeatureModes.LANDMARKS_TEXTURED);
mapView.getMapScene().enableFeatures(mapFeatures);

val mapFeatures: MutableMap<String, String> = HashMap()
mapFeatures[MapFeatures.LANDMARKS] = MapFeatureModes.LANDMARKS_TEXTURED
mapView?.mapScene?.enableFeatures(mapFeatures)

@Override
protected void onPause() {
    mapView.onPause();
    super.onPause();
}

@Override
protected void onResume() {
    mapView.onResume();
    super.onResume();
}

@Override
protected void onDestroy() {
    mapView.onDestroy();
    disposeHERESDK();
    super.onDestroy();
}

@Override
protected void onSaveInstanceState(@NonNull Bundle outState) {
    mapView.onSaveInstanceState(outState);
    super.onSaveInstanceState(outState);
}

override fun onPause() {
    mapView?.onPause()
    super.onPause()
}

override fun onResume() {
    mapView?.onResume()
    super.onResume()
}

override fun onDestroy() {
    mapView?.onDestroy()
    disposeHERESDK()
    super.onDestroy()
}

override fun onSaveInstanceState(outState: Bundle) {
    mapView?.onSaveInstanceState(outState)
    super.onSaveInstanceState(outState)
}