RD-1375: Add GetRenderWorldCopies Getter

Co-authored-by: klokantechsysadmin <[email protected]>

Author: github-actions[bot]

MapTilerSDK/src/main/java/com/maptiler/maptilersdk/commands/navigation/GetRenderWorldCopies.kt

@@ -0,0 +1,16 @@
+/*
+ * Copyright (c) 2025, MapTiler
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD 3-Clause
+ */
+
+package com.maptiler.maptilersdk.commands.navigation
+
+import com.maptiler.maptilersdk.bridge.MTBridge
+import com.maptiler.maptilersdk.bridge.MTCommand
+
+internal class GetRenderWorldCopies : MTCommand {
+    override val isPrimitiveReturnType: Boolean = true
+
+    override fun toJS(): String = "${MTBridge.MAP_OBJECT}.getRenderWorldCopies();"
+}

MapTilerSDK/src/main/java/com/maptiler/maptilersdk/map/MTMapViewController.kt

@@ -380,6 +380,8 @@ class MTMapViewController(
      */
     override suspend fun getCenterClampedToGround(): Boolean = navigableWorker.getCenterClampedToGround()
 
+    override suspend fun getRenderWorldCopies(): Boolean = navigableWorker.getRenderWorldCopies()
+
     /**
      * Returns the elevation of the map's center point in meters above sea level.
      */

MapTilerSDK/src/main/java/com/maptiler/maptilersdk/map/workers/navigable/MTNavigable.kt

@@ -111,6 +111,11 @@ interface MTNavigable {
      */
     suspend fun getCenterClampedToGround(): Boolean
 
+    /**
+     * Returns whether the map is set to render multiple world copies.
+     */
+    suspend fun getRenderWorldCopies(): Boolean
+
     /**
      * Returns the elevation of the map's center point in meters above sea level.
      */

MapTilerSDK/src/main/java/com/maptiler/maptilersdk/map/workers/navigable/NavigableWorker.kt

@@ -19,6 +19,7 @@ import com.maptiler.maptilersdk.commands.navigation.GetCenterElevation
 import com.maptiler.maptilersdk.commands.navigation.GetMaxPitch
 import com.maptiler.maptilersdk.commands.navigation.GetMinPitch
 import com.maptiler.maptilersdk.commands.navigation.GetPitch
+import com.maptiler.maptilersdk.commands.navigation.GetRenderWorldCopies
 import com.maptiler.maptilersdk.commands.navigation.GetRoll
 import com.maptiler.maptilersdk.commands.navigation.JumpTo
 import com.maptiler.maptilersdk.commands.navigation.PanBy
@@ -211,6 +212,27 @@ internal class NavigableWorker(
         }
     }
 
+    override suspend fun getRenderWorldCopies(): Boolean {
+        val returnTypeValue =
+            bridge.execute(
+                GetRenderWorldCopies(),
+            )
+
+        return when (returnTypeValue) {
+            is BoolValue -> returnTypeValue.value
+            is DoubleValue -> returnTypeValue.value != 0.0
+            is StringValue -> {
+                val normalized = returnTypeValue.value.trim().lowercase()
+                when (normalized) {
+                    "true" -> true
+                    "false" -> false
+                    else -> normalized.toDoubleOrNull()?.let { it != 0.0 } ?: false
+                }
+            }
+            else -> false
+        }
+    }
+
     override suspend fun getCenterElevation(): Double {
         val returnTypeValue =
             bridge.execute(

MapTilerSDK/src/test/java/com/maptiler/maptilersdk/NavigationTests.kt

@@ -13,6 +13,7 @@ import com.maptiler.maptilersdk.commands.navigation.GetMaxPitch
 import com.maptiler.maptilersdk.commands.navigation.GetMaxZoom
 import com.maptiler.maptilersdk.commands.navigation.GetMinPitch
 import com.maptiler.maptilersdk.commands.navigation.GetMinZoom
+import com.maptiler.maptilersdk.commands.navigation.GetRenderWorldCopies
 import com.maptiler.maptilersdk.commands.navigation.GetZoom
 import com.maptiler.maptilersdk.commands.navigation.PanBy
 import com.maptiler.maptilersdk.commands.navigation.PanTo
@@ -33,6 +34,11 @@ class NavigationTests {
         assertEquals("${MTBridge.MAP_OBJECT}.getCenterClampedToGround();", command.toJS())
     }
 
+    @Test fun getRenderWorldCopiesToJS_ReturnsCorrectJSString() {
+        val command = GetRenderWorldCopies()
+        assertEquals("${MTBridge.MAP_OBJECT}.getRenderWorldCopies();", command.toJS())
+    }
+
     @Test fun getCenterElevationToJS_ReturnsCorrectJSString() {
         val command = GetCenterElevation()
         assertEquals("${MTBridge.MAP_OBJECT}.getCenterElevation();", command.toJS())

MapTilerSDK/src/test/java/com/maptiler/maptilersdk/WorkerAndStyleTests.kt

@@ -13,6 +13,7 @@ import com.maptiler.maptilersdk.bridge.MTCommandExecutable
 import com.maptiler.maptilersdk.commands.navigation.GetBearing
 import com.maptiler.maptilersdk.commands.navigation.GetCenterClampedToGround
 import com.maptiler.maptilersdk.commands.navigation.GetCenterElevation
+import com.maptiler.maptilersdk.commands.navigation.GetRenderWorldCopies
 import com.maptiler.maptilersdk.commands.style.GetProjection
 import com.maptiler.maptilersdk.map.style.MTMapReferenceStyle
 import com.maptiler.maptilersdk.map.style.MTStyle
@@ -78,6 +79,51 @@ class WorkerAndStyleTests {
             assertTrue(executedCommands.all { it is GetCenterClampedToGround })
         }
 
+    @Test fun navigableWorker_getRenderWorldCopies_ParsesPrimitiveReturnTypes() =
+        runBlocking {
+            val executedCommands = mutableListOf<MTCommand>()
+            val responses =
+                ArrayDeque(
+                    listOf(
+                        MTBridgeReturnType.BoolValue(true),
+                        MTBridgeReturnType.StringValue("false"),
+                        MTBridgeReturnType.StringValue("1"),
+                        MTBridgeReturnType.DoubleValue(0.0),
+                        MTBridgeReturnType.DoubleValue(2.0),
+                        MTBridgeReturnType.StringValue("  TRUE "),
+                        MTBridgeReturnType.StringValue("invalid"),
+                    ),
+                )
+
+            val exec =
+                object : MTCommandExecutable {
+                    override suspend fun execute(command: MTCommand): MTBridgeReturnType {
+                        executedCommands.add(command)
+                        return responses.removeFirst()
+                    }
+                }
+
+            val bridge = MTBridge(exec)
+            val worker = NavigableWorker(bridge, this)
+
+            val first = worker.getRenderWorldCopies()
+            val second = worker.getRenderWorldCopies()
+            val third = worker.getRenderWorldCopies()
+            val fourth = worker.getRenderWorldCopies()
+            val fifth = worker.getRenderWorldCopies()
+            val sixth = worker.getRenderWorldCopies()
+            val seventh = worker.getRenderWorldCopies()
+
+            assertEquals(true, first)
+            assertEquals(false, second)
+            assertEquals(true, third)
+            assertEquals(false, fourth)
+            assertEquals(true, fifth)
+            assertEquals(true, sixth)
+            assertEquals(false, seventh)
+            assertTrue(executedCommands.all { it is GetRenderWorldCopies })
+        }
+
     @Test fun navigableWorker_getCenterElevation_ParsesStringReturnType() =
         runBlocking {
             var usedGetCenterElevation = false