@maplibre/maplibre-react-native 10.1.5 → 11.0.0-alpha.2

package/{maplibre-react-native.podspec → MapLibreReactNative.podspec}

@@ -1,6 +1,6 @@
-require 'json'
+require "json"
 
-package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
 
 # Global Variable Defaults
 $MLRN_NATIVE_VERSION ||= "6.11.0"
@@ -40,7 +40,7 @@ def $MLRN.post_install(installer)
   project = installer.pods_project
   self._add_spm_to_target(
     project,
-    project.targets.find { |t| t.name == "maplibre-react-native"},
+    project.targets.find { |t| t.name == "MapLibreReactNative"},
     spm_spec[:url],
     spm_spec[:requirement],
     spm_spec[:product_name]
@@ -62,19 +62,18 @@ def $MLRN.post_install(installer)
 end
 
 Pod::Spec.new do |s|
-  s.name      = "maplibre-react-native"
-  s.summary	  = "React Native library for creating maps with MapLibre Native"
-  s.version	  = package['version']
-  s.authors   = { "MapLibre" => "" }
-  s.homepage  = "https://github.com/maplibre/maplibre-react-native"
-  s.source    = { :git => "https://github.com/maplibre/maplibre-react-native.git" }
-  s.license   = "MIT"
-  s.platform  = :ios, "8.0"
+  s.name         = "MapLibreReactNative"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
 
-  s.dependency 'React-Core'
-  s.dependency 'React'
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/maplibre/maplibre-react-native.git", :tag => "#{s.version}" }
 
-  s.subspec 'DynamicLibrary' do |sp|
-    sp.source_files	= "ios/MLRN/**/*.{h,m}"
-  end
+  s.source_files = "ios/**/*.{h,m,mm,cpp}"
+  s.private_header_files = "ios/**/*.h"
+
+ install_modules_dependencies(s)
 end

package/android/build.gradle

@@ -1,145 +1,124 @@
 buildscript {
-  // Buildscript is evaluated before everything else so we can't use getExtOrDefault
-  def kotlin_version = rootProject.ext.has("kotlinVersion") ? rootProject.ext.get("kotlinVersion") : project.properties["org.maplibre.reactnative.kotlinVersion"]
-
-  repositories {
-    google()
-    mavenCentral()
-  }
+    ext.getExtOrDefault = { name ->
+        return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['org.maplibre.reactnative.' + name]
+    }
 
-  dependencies {
-    classpath "com.android.tools.build:gradle:7.2.1"
-    // noinspection DifferentKotlinGradleVersion
-    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
-  }
-}
+    repositories {
+        google()
+        mavenCentral()
+    }
 
-def reactNativeArchitectures() {
-  def value = rootProject.getProperties().get("reactNativeArchitectures")
-  return value ? value.split(",") : ["armeabi-v7a", "x86", "x86_64", "arm64-v8a"]
+    dependencies {
+        classpath "com.android.tools.build:gradle:8.7.2"
+        // noinspection DifferentKotlinGradleVersion
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+    }
 }
 
-def isNewArchitectureEnabled() {
-  return rootProject.hasProperty("newArchEnabled") && rootProject.getProperty("newArchEnabled") == "true"
-}
 
 apply plugin: "com.android.library"
 apply plugin: "kotlin-android"
 
-// TODO: Currently breaks new arch support, but works without
-// if (isNewArchitectureEnabled()) {
-//   apply plugin: "com.facebook.react"
-// }
-
-def getExtOrDefault(name) {
-  return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties["org.maplibre.reactnative." + name]
-}
-
-def getConfigurableExtOrDefault(name) {
-  return rootProject.ext.has("org.maplibre.reactnative." + name) ? rootProject.ext.get("org.maplibre.reactnative." + name) : project.properties["org.maplibre.reactnative." + name]
-}
+apply plugin: "com.facebook.react"
 
 def getExtOrIntegerDefault(name) {
-  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["org.maplibre.reactnative." + name]).toInteger()
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["org.maplibre.reactnative." + name]).toInteger()
 }
 
-def supportsNamespace() {
-  def parsed = com.android.Version.ANDROID_GRADLE_PLUGIN_VERSION.tokenize('.')
-  def major = parsed[0].toInteger()
-  def minor = parsed[1].toInteger()
-
-  // Namespace support was added in 7.3.0
-  return (major == 7 && minor >= 3) || major >= 8
+def getConfigurableExtOrDefault(name) {
+    return rootProject.ext.has("org.maplibre.reactnative." + name) ? rootProject.ext.get("org.maplibre.reactnative." + name) : project.properties["org.maplibre.reactnative." + name]
 }
 
 android {
-  if (supportsNamespace()) {
     namespace "org.maplibre.reactnative"
 
-    sourceSets {
-      main {
-        manifest.srcFile "src/main/AndroidManifestNew.xml"
-      }
-    }
-  }
-
-  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+    compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
 
-  defaultConfig {
-    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
-    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
-
-    buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString()
-  }
+    defaultConfig {
+        minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+        targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+    }
 
-  sourceSets {
-    main {
-      java.srcDirs = ['src/main/java']
+    buildFeatures {
+        buildConfig true
+    }
 
-      if (getConfigurableExtOrDefault("locationEngine") == "default") {
-        java.srcDirs += 'src/main/location-engine-default'
-      } else if (getConfigurableExtOrDefault("locationEngine") == "google") {
-        java.srcDirs += 'src/main/location-engine-google'
-      } else {
-        throw new GradleException("org.maplibre.reactnative.locationEngine.locationEngine should be one of [\"default\", \"google\"]`. \"${getConfigurableExtOrDefault("locationEngine")}\" was provided.")
-      }
+    buildTypes {
+        release {
+            minifyEnabled false
+        }
     }
-  }
 
-  buildTypes {
-    release {
-      minifyEnabled false
+    lintOptions {
+        disable "GradleCompatible"
     }
-  }
 
-  lintOptions {
-    disable "GradleCompatible"
-  }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
 
-  compileOptions {
-    sourceCompatibility JavaVersion.VERSION_1_8
-    targetCompatibility JavaVersion.VERSION_1_8
-  }
+    sourceSets {
+        main {
+            java.srcDirs = ['src/main/java']
+
+            if (getConfigurableExtOrDefault("locationEngine") == "default") {
+                java.srcDirs += 'src/main/location-engine-default'
+            } else if (getConfigurableExtOrDefault("locationEngine") == "google") {
+                java.srcDirs += 'src/main/location-engine-google'
+            } else {
+                throw new GradleException("org.maplibre.reactnative.locationEngine.locationEngine should be one of [\"default\", \"google\"]`. \"${getConfigurableExtOrDefault("locationEngine")}\" was provided.")
+            }
+
+            java.srcDirs += [
+                    "generated/java",
+                    "generated/jni"
+            ]
+        }
+    }
 }
 
 repositories {
-  mavenCentral()
-  google()
+    mavenCentral()
+    google()
 }
 
 def kotlin_version = getExtOrDefault("kotlinVersion")
 
 dependencies {
-  // For < 0.71, this will be from the local maven repo
-  // For > 0.71, this will be replaced by `com.facebook.react:react-android:$version` by react gradle plugin
-  //noinspection GradleDynamicVersion
-  implementation "com.facebook.react:react-native:+"
-  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-
-  // MapLibre Native
-  implementation "org.maplibre.gl:android-sdk-${getConfigurableExtOrDefault('nativeVariant')}:${getConfigurableExtOrDefault('nativeVersion')}"
-
-  // MapLibre Plugins
-  implementation("org.maplibre.gl:android-plugin-localization-v9:${getConfigurableExtOrDefault('pluginVersion')}") {
-    exclude(group: "org.maplibre.gl", module: "android-sdk")
-  }
-  implementation("org.maplibre.gl:android-plugin-annotation-v9:${getConfigurableExtOrDefault('pluginVersion')}") {
-    exclude(group: "org.maplibre.gl", module: "android-sdk")
-  }
-  implementation("org.maplibre.gl:android-plugin-markerview-v9:${getConfigurableExtOrDefault('pluginVersion')}") {
-    exclude(group: "org.maplibre.gl", module: "android-sdk")
-  }
-
-  // Dependencies
-  implementation "org.maplibre.gl:android-sdk-turf:${getConfigurableExtOrDefault('turfVersion')}"
-  implementation "com.squareup.okhttp3:okhttp:${getConfigurableExtOrDefault('okhttpVersion')}"
-  implementation "com.squareup.okhttp3:okhttp-urlconnection:${getConfigurableExtOrDefault('okhttpVersion')}"
-  implementation "androidx.vectordrawable:vectordrawable:1.1.0"
-  implementation "androidx.annotation:annotation:1.7.0"
-  implementation "androidx.appcompat:appcompat:1.6.1"
-
-  // Dependencies for Google Location Engine
-  if (getConfigurableExtOrDefault("locationEngine") == "google") {
-    implementation "com.google.android.gms:play-services-location:${getConfigurableExtOrDefault('googlePlayServicesLocationVersion')}"
-  }
+    implementation "com.facebook.react:react-android"
+    implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+
+    // MapLibre Native
+    implementation "org.maplibre.gl:android-sdk-${getConfigurableExtOrDefault('nativeVariant')}:${getConfigurableExtOrDefault('nativeVersion')}"
+
+    // MapLibre Plugins
+    implementation("org.maplibre.gl:android-plugin-localization-v9:${getConfigurableExtOrDefault('pluginVersion')}") {
+        exclude(group: "org.maplibre.gl", module: "android-sdk")
+    }
+    implementation("org.maplibre.gl:android-plugin-annotation-v9:${getConfigurableExtOrDefault('pluginVersion')}") {
+        exclude(group: "org.maplibre.gl", module: "android-sdk")
+    }
+    implementation("org.maplibre.gl:android-plugin-markerview-v9:${getConfigurableExtOrDefault('pluginVersion')}") {
+        exclude(group: "org.maplibre.gl", module: "android-sdk")
+    }
+
+    // Dependencies
+    implementation "org.maplibre.gl:android-sdk-turf:${getConfigurableExtOrDefault('turfVersion')}"
+    implementation "com.squareup.okhttp3:okhttp:${getConfigurableExtOrDefault('okhttpVersion')}"
+    implementation "com.squareup.okhttp3:okhttp-urlconnection:${getConfigurableExtOrDefault('okhttpVersion')}"
+    implementation "androidx.vectordrawable:vectordrawable:1.1.0"
+    implementation "androidx.annotation:annotation:1.7.0"
+    implementation "androidx.appcompat:appcompat:1.6.1"
+
+    // Dependencies for Google Location Engine
+    if (getConfigurableExtOrDefault("locationEngine") == "google") {
+        implementation "com.google.android.gms:play-services-location:${getConfigurableExtOrDefault('googlePlayServicesLocationVersion')}"
+    }
+}
+
+react {
+    jsRootDir = file("../src/")
+    libraryName = "MapLibreReactNative"
+    codegenJavaPackageName = "org.maplibre.reactnative"
 }

package/android/gradle.properties

@@ -1,8 +1,8 @@
-org.maplibre.reactnative.kotlinVersion=1.7.0
-org.maplibre.reactnative.minSdkVersion=21
-org.maplibre.reactnative.targetSdkVersion=31
-org.maplibre.reactnative.compileSdkVersion=31
-org.maplibre.reactnative.ndkVersion=21.4.7075529
+org.maplibre.reactnative.kotlinVersion=2.0.21
+org.maplibre.reactnative.minSdkVersion=24
+org.maplibre.reactnative.targetSdkVersion=34
+org.maplibre.reactnative.compileSdkVersion=35
+org.maplibre.reactnative.ndkVersion=27.1.12297006
 
 # MapLibre React Native
 org.maplibre.reactnative.nativeVersion=11.8.1

package/android/src/main/AndroidManifest.xml

@@ -1,6 +1,4 @@
-<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-    package="org.maplibre.reactnative">
-
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
 </manifest>

package/android/src/main/java/org/maplibre/reactnative/MLRNPackage.kt

@@ -0,0 +1,144 @@
+package org.maplibre.reactnative
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import com.facebook.react.uimanager.ViewManager
+import org.maplibre.reactnative.components.annotation.MLRNCalloutManager
+import org.maplibre.reactnative.components.annotation.MLRNMarkerViewManager
+import org.maplibre.reactnative.components.annotation.MLRNPointAnnotationManager
+import org.maplibre.reactnative.components.camera.MLRNCameraManager
+import org.maplibre.reactnative.components.images.MLRNImagesManager
+import org.maplibre.reactnative.components.location.MLRNNativeUserLocationManager
+import org.maplibre.reactnative.components.mapview.MLRNAndroidTextureMapViewManager
+import org.maplibre.reactnative.components.mapview.MLRNMapViewManager
+import org.maplibre.reactnative.components.styles.layers.MLRNBackgroundLayerManager
+import org.maplibre.reactnative.components.styles.layers.MLRNCircleLayerManager
+import org.maplibre.reactnative.components.styles.layers.MLRNFillExtrusionLayerManager
+import org.maplibre.reactnative.components.styles.layers.MLRNFillLayerManager
+import org.maplibre.reactnative.components.styles.layers.MLRNHeatmapLayerManager
+import org.maplibre.reactnative.components.styles.layers.MLRNLineLayerManager
+import org.maplibre.reactnative.components.styles.layers.MLRNRasterLayerManager
+import org.maplibre.reactnative.components.styles.layers.MLRNSymbolLayerManager
+import org.maplibre.reactnative.components.styles.light.MLRNLightManager
+import org.maplibre.reactnative.components.styles.sources.MLRNImageSourceManager
+import org.maplibre.reactnative.components.styles.sources.MLRNRasterSourceManager
+import org.maplibre.reactnative.components.styles.sources.MLRNShapeSourceManager
+import org.maplibre.reactnative.components.styles.sources.MLRNVectorSourceManager
+import org.maplibre.reactnative.modules.MLRNLocationModule
+import org.maplibre.reactnative.modules.MLRNLogging
+import org.maplibre.reactnative.modules.MLRNModule
+import org.maplibre.reactnative.modules.MLRNOfflineModule
+import org.maplibre.reactnative.modules.MLRNSnapshotModule
+
+
+class MLRNPackage : BaseReactPackage() {
+    override fun getModule(
+        name: String,
+        reactContext: ReactApplicationContext
+    ): NativeModule? {
+        when (name) {
+            MLRNModule.REACT_CLASS -> return MLRNModule(reactContext)
+            MLRNOfflineModule.REACT_CLASS -> return MLRNOfflineModule(reactContext)
+            MLRNSnapshotModule.NAME -> return MLRNSnapshotModule(reactContext)
+            MLRNLocationModule.REACT_CLASS -> return MLRNLocationModule(reactContext)
+            MLRNLogging.REACT_CLASS -> return MLRNLogging(reactContext)
+        }
+
+        return null
+    }
+
+    override fun getReactModuleInfoProvider(): ReactModuleInfoProvider {
+        return ReactModuleInfoProvider {
+            val moduleInfos: MutableMap<String, ReactModuleInfo> = HashMap()
+
+            moduleInfos[MLRNModule.REACT_CLASS] = ReactModuleInfo(
+                MLRNModule.REACT_CLASS,
+                MLRNModule.REACT_CLASS,
+                false,  // canOverrideExistingModule
+                false,  // needsEagerInit
+                true,  // hasConstants
+                false,  // isCxxModule
+                false // isTurboModule
+            )
+
+            moduleInfos[MLRNOfflineModule.REACT_CLASS] = ReactModuleInfo(
+                MLRNOfflineModule.REACT_CLASS,
+                MLRNOfflineModule.REACT_CLASS,
+                false,  // canOverrideExistingModule
+                false,  // needsEagerInit
+                true,  // hasConstants
+                false,  // isCxxModule
+                false // isTurboModule
+            )
+
+            moduleInfos[MLRNSnapshotModule.NAME] = ReactModuleInfo(
+                MLRNSnapshotModule.NAME,
+                MLRNSnapshotModule.NAME,
+                false,  // canOverrideExistingModule
+                false,  // needsEagerInit
+                false,  // isCxxModule
+                true // isTurboModule
+            )
+
+            moduleInfos[MLRNLocationModule.REACT_CLASS] = ReactModuleInfo(
+                MLRNLocationModule.REACT_CLASS,
+                MLRNLocationModule.REACT_CLASS,
+                false,  // canOverrideExistingModule
+                false,  // needsEagerInit
+                true,  // hasConstants
+                false,  // isCxxModule
+                false // isTurboModule
+            )
+
+            moduleInfos[MLRNLogging.REACT_CLASS] = ReactModuleInfo(
+                MLRNLogging.REACT_CLASS,
+                MLRNLogging.REACT_CLASS,
+                false,  // canOverrideExistingModule
+                false,  // needsEagerInit
+                true,  // hasConstants
+                false,  // isCxxModule
+                false // isTurboModule
+            )
+
+            moduleInfos
+        }
+    }
+
+    override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+        val managers: MutableList<ViewManager<*, *>> = ArrayList()
+
+        // components
+        managers.add(MLRNCameraManager(reactContext))
+        managers.add(MLRNMapViewManager(reactContext))
+        managers.add(MLRNMarkerViewManager(reactContext))
+        managers.add(MLRNAndroidTextureMapViewManager(reactContext))
+        managers.add(MLRNLightManager())
+        managers.add(MLRNPointAnnotationManager(reactContext))
+        managers.add(MLRNCalloutManager())
+        managers.add(MLRNNativeUserLocationManager())
+
+        // sources
+        managers.add(MLRNVectorSourceManager(reactContext))
+        managers.add(MLRNShapeSourceManager(reactContext))
+        managers.add(MLRNRasterSourceManager(reactContext))
+        managers.add(MLRNImageSourceManager())
+
+        // images
+        managers.add(MLRNImagesManager(reactContext))
+
+        // layers
+        managers.add(MLRNFillLayerManager())
+        managers.add(MLRNFillExtrusionLayerManager())
+        managers.add(MLRNHeatmapLayerManager())
+        managers.add(MLRNLineLayerManager())
+        managers.add(MLRNCircleLayerManager())
+        managers.add(MLRNSymbolLayerManager())
+        managers.add(MLRNRasterLayerManager())
+        managers.add(MLRNBackgroundLayerManager())
+
+        return managers
+    }
+}

package/android/src/main/java/org/maplibre/reactnative/components/AbstractEventEmitter.java

@@ -45,11 +45,7 @@ abstract public class AbstractEventEmitter<T extends ViewGroup> extends ViewGrou
 
     @Override
     protected void addEventEmitters(ThemedReactContext context, @Nonnull T view) {
-        if (BuildConfig.IS_NEW_ARCHITECTURE_ENABLED) {
-            mEventDispatcher = UIManagerHelper.getUIManager(context, UIManagerType.FABRIC).getEventDispatcher();
-        } else {
-            mEventDispatcher = context.getNativeModule(UIManagerModule.class).getEventDispatcher();
-        }
+        mEventDispatcher = UIManagerHelper.getUIManager(context, UIManagerType.FABRIC).getEventDispatcher();
     }
 
     @Nullable

package/android/src/main/java/org/maplibre/reactnative/modules/MLRNModule.java

@@ -132,25 +132,6 @@ public class MLRNModule extends ReactContextBaseJavaModule {
                 .build();
     }
 
-    /**
-     * @deprecated This will be removed in the next major version.
-     * @see https://github.com/maplibre/maplibre-react-native/issues/25#issuecomment-1382382044
-     */
-    @Deprecated
-    @ReactMethod
-    public void setAccessToken(final String accessToken) {
-        mReactContext.runOnUiQueueThread(new Runnable() {
-            @Override
-            public void run() {
-                if (accessToken == null) {
-                    MapLibre.getInstance(getReactApplicationContext());
-                } else {
-                    MapLibre.getInstance(getReactApplicationContext(), accessToken, WellKnownTileServer.Mapbox);
-                }
-            }
-        });
-    }
-
     @ReactMethod
     public void removeCustomHeader(final String headerName) {
         mReactContext.runOnUiQueueThread(new Runnable() {
@@ -179,21 +160,6 @@ public class MLRNModule extends ReactContextBaseJavaModule {
         });
     }
 
-    /**
-     * @deprecated This will be removed in the next major version.
-     * @see https://github.com/maplibre/maplibre-react-native/issues/25#issuecomment-1382382044
-     */
-    @Deprecated
-    @ReactMethod
-    public void getAccessToken(Promise promise) {
-        String token = MapLibre.getApiKey();
-        if(token == null) {
-            promise.reject("missing_access_token", "No access token has been set");
-        } else {
-            promise.resolve(token);
-        }
-    }
-
     @ReactMethod
     public void setConnected(final boolean connected) {
         mReactContext.runOnUiQueueThread(new Runnable() {

package/android/src/main/java/org/maplibre/reactnative/modules/MLRNSnapshotModule.kt

@@ -0,0 +1,128 @@
+package org.maplibre.reactnative.modules
+
+import android.graphics.Bitmap
+import android.util.Log
+import android.util.TypedValue
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.module.annotations.ReactModule
+import org.maplibre.android.camera.CameraPosition
+import org.maplibre.android.maps.Style
+import org.maplibre.android.snapshotter.MapSnapshot
+import org.maplibre.android.snapshotter.MapSnapshotter
+import org.maplibre.geojson.Feature
+import org.maplibre.geojson.FeatureCollection
+import org.maplibre.geojson.Point
+import org.maplibre.reactnative.NativeSnapshotModuleSpec
+import org.maplibre.reactnative.utils.BitmapUtils
+import org.maplibre.reactnative.utils.GeoJSONUtils
+import java.io.IOException
+import java.io.OutputStream
+import java.util.UUID
+
+@ReactModule(name = MLRNSnapshotModule.NAME)
+class MLRNSnapshotModule(reactContext: ReactApplicationContext) :
+    NativeSnapshotModuleSpec(reactContext) {
+    companion object {
+        const val NAME = "MLRNSnapshotModule"
+    }
+
+    override fun getName() = NAME
+
+    private val context: ReactApplicationContext = reactContext
+
+    // Prevent garbage collection
+    private val snapshotterMap: MutableMap<String, MapSnapshotter> =
+        HashMap<String, MapSnapshotter>()
+
+    override fun takeSnap(jsOptions: ReadableMap, promise: Promise) {
+        org.maplibre.android.storage.FileSource.getInstance(context).activate()
+
+        context.runOnUiQueueThread {
+            val snapshotterID = UUID.randomUUID().toString()
+            val snapshotter: MapSnapshotter = MapSnapshotter(context, getOptions(jsOptions))
+            snapshotterMap[snapshotterID] = snapshotter
+            snapshotter.start(object :
+                MapSnapshotter.SnapshotReadyCallback {
+                override fun onSnapshotReady(snapshot: MapSnapshot) {
+                    val bitmap: Bitmap = snapshot.bitmap
+                    val result: String? = if (jsOptions.getBoolean("writeToDisk")) {
+                        BitmapUtils.createTempFile(
+                            context, bitmap
+                        )
+                    } else {
+                        BitmapUtils.createBase64(bitmap)
+                    }
+
+                    if (result == null) {
+                        promise.reject(
+                            NAME,
+                            "Could not generate snapshot, please check Android logs for more info."
+                        )
+                        return
+                    }
+
+                    promise.resolve(result)
+                    snapshotterMap.remove(snapshotterID)
+                }
+            }) { error ->
+                Log.w(NAME, error)
+                snapshotterMap.remove(snapshotterID)
+            }
+        }
+    }
+
+    private fun getOptions(jsOptions: ReadableMap): MapSnapshotter.Options {
+        val options: MapSnapshotter.Options =
+            MapSnapshotter.Options(
+                jsOptions.getDouble("width").toInt(), jsOptions.getDouble("height").toInt()
+            )
+
+        options.withLogo(jsOptions.getBoolean("withLogo"))
+        jsOptions.getString("styleURL")?.let { styleUrl ->
+            options.withStyleBuilder(
+                Style.Builder().fromUri(styleUrl)
+            )
+        }
+        options.withPixelRatio(
+            TypedValue.applyDimension(
+                TypedValue.COMPLEX_UNIT_DIP,
+                1f,
+                context.resources.displayMetrics
+            )
+        )
+
+        if (jsOptions.hasKey("bounds")) {
+            val bounds = jsOptions.getString("bounds")?.let { boundsStr ->
+                FeatureCollection.fromJson(boundsStr)
+            }
+            bounds?.let {
+                options.withRegion(GeoJSONUtils.toLatLngBounds(it))
+            }
+        } else {
+            val centerPoint = jsOptions.getString("centerCoordinate")?.let { coordStr ->
+                Feature.fromJson(coordStr)
+            }
+            val cameraPosition: CameraPosition =
+                CameraPosition.Builder()
+                    .target(GeoJSONUtils.toLatLng(centerPoint?.geometry() as Point?))
+                    .tilt(jsOptions.getDouble("pitch")).bearing(jsOptions.getDouble("heading"))
+                    .zoom(jsOptions.getDouble("zoomLevel")).build()
+            options.withCameraPosition(cameraPosition)
+        }
+
+        return options
+    }
+
+    private fun closeSnapshotOutputStream(outputStream: OutputStream?) {
+        if (outputStream == null) {
+            return
+        }
+        try {
+            outputStream.close()
+        } catch (e: IOException) {
+            e.localizedMessage?.let { Log.w(NAME, it) }
+        }
+    }
+}