Display alternate symbols at different scales (#441)

Author: shubham7109

gradle/libs.versions.toml

@@ -1,7 +1,7 @@
 [versions]
 
 # ArcGIS Maps SDK for Kotlin version
-arcgisMapsKotlinVersion = "300.0.0-4738"
+arcgisMapsKotlinVersion = "300.0.0-4757"
 
 ### Android versions
 androidGradlePlugin = "8.12.1"

samples/add-feature-collection-layer-from-table/src/main/java/com/esri/arcgismaps/sample/addfeaturecollectionlayerfromtable/components/AddFeatureCollectionLayerFromTableViewModel.kt

@@ -213,12 +213,3 @@ class AddFeatureCollectionLayerFromTableViewModel(app: Application) : AndroidVie
         return polygonsCollectionTable
     }
 }
-
-/**
- * Define a blue color.
- */
-private val Color.Companion.blue: Color
-    get() {
-        return fromRgba(r = 0, g = 0, b = 255, a = 255)
-    }
-    

samples/apply-simple-renderer-to-feature-layer/src/main/java/com/esri/arcgismaps/sample/applysimplerenderertofeaturelayer/components/ApplySimpleRendererToFeatureLayerViewModel.kt

@@ -77,7 +77,3 @@ class ApplySimpleRendererToFeatureLayerViewModel(app: Application) : AndroidView
         featureLayer.renderer = renderer
     }
 }
-
-// Extension property to provide blue color for ArcGISMaps Color class
-val Color.Companion.blue: Color
-    get() = fromRgba(0, 0, 255, 255)

samples/browse-ogc-api-feature-service/src/main/java/com/esri/arcgismaps/sample/browseogcapifeatureservice/components/BrowseOGCAPIFeatureServiceViewModel.kt

@@ -222,7 +222,3 @@ class BrowseOgcApiFeatureServiceViewModel(app: Application) : AndroidViewModel(a
     }
 
 }
-
-// Extension property to provide blue color for ArcGISMaps Color class
-val Color.Companion.blue: Color
-    get() = fromRgba(0, 0, 255, 255)

samples/create-and-edit-geometries/src/main/java/com/esri/arcgismaps/sample/createandeditgeometries/components/CreateAndEditGeometriesViewModel.kt

@@ -413,12 +413,4 @@ class CreateAndEditGeometriesViewModel(application: Application) : AndroidViewMo
             [-1068004.43,6998409.28],[-1067943.67,6998403.86]]],
             "spatialReference":{"latestWkid":3857,"wkid":102100}}"""
 
-    /**
-     * Define a blue color for polylines.
-     */
-    private val Color.Companion.blue: Color
-        get() {
-            return fromRgba(0, 0, 255, 255)
-        }
-
 }

samples/create-convex-hull-around-points/src/main/java/com/esri/arcgismaps/sample/createconvexhullaroundpoints/MainActivity.kt

@@ -211,9 +211,3 @@ class MainActivity : EdgeToEdgeCompatActivity() {
         Snackbar.make(mapView, message, Snackbar.LENGTH_SHORT).show()
     }
 }
-
-/**
- * Simple extension property that represents a blue color
- */
-private val Color.Companion.blue
-    get() = fromRgba(0, 0, 255)

samples/cut-geometry/src/main/java/com/esri/arcgismaps/sample/cutgeometry/components/CutGeometryViewModel.kt

@@ -183,19 +183,6 @@ class CutGeometryViewModel(application: Application) : AndroidViewModel(applicat
         }
     }
 
-    /**
-     * Define a blue color for polygon boundary.
-     */
-    private val Color.Companion.blue: Color
-        get() {
-            return fromRgba(
-                r = 0,
-                g = 0,
-                b = 255,
-                a = 255
-            )
-        }
-
     /**
      * Create a polygon corresponding to Lake Superior.
      */

samples/display-alternate-symbols-at-different-scales/README.md

@@ -0,0 +1,46 @@
+# Display alternate symbols at different scales
+
+Apply a unique value with alternate symbols at different scales.
+
+![Display alternate symbols at different scales sample](display-alternate-symbols-at-different-scales.png)
+
+## Use case
+
+When a layer is symbolized with unique value symbology, you can specify the visible scale range for each unique value. This is an effective strategy to limit the amount of detailed data at smaller scales without having to make multiple versions of the layer, each with a unique definition query.
+
+Once scale ranges are applied to unique values, you can further refine the appearance of features within those scale ranges by establishing alternate symbols to different parts of the symbol class scale range.
+
+## How to use the sample
+
+Zoom in and out of the map to see alternate symbols at each scale. The symbology changes according to the following scale ranges: 0-5,000, 5,000-10,000, 10,000-20,000. To go back to the initial viewpoint, tap "Reset Viewpoint".
+
+## How it works
+
+1. Create a `FeatureLayer` using the service URL and add it to the map's list of operational layers.
+2. Create two alternate symbols (a blue square and a yellow diamond) to be used as alternate symbols. To create an alternate symbol:
+    1. Create a symbol using `SimpleMarkerSymbol`.
+    2. Convert the simple marker symbol to an `MultilayerSymbol` using `SimpleMarkerSymbol.toMultilayerSymbol()`.
+    3. Set the multilayer symbol's `referenceProperties` to the valid scale ranges with the blue square and yellow diamond.
+3. Create a third multilayer symbol to be used to create a `UniqueValue` class.
+4. Create a unique value using the red triangle from step 3 and the list of alternate symbols from step 2.
+5. Create a `UniqueValueRenderer` and add the unique value from step 4 to it.
+6. Create a purple diamond simple marker and convert it to a multilayer symbol to be used as the default symbol.
+7. Set the unique value renderer's `defaultSymbol` property to the purple diamond from step 6.
+8. Set the unique value renderer's `fieldNames` property to "req_type".
+9. Apply this unique value renderer to the renderer on feature layer.
+
+## Relevant API
+
+* MultilayerSymbol
+* SimpleMarkerSymbol
+* SymbolReferenceProperties
+* UniqueValue
+* UniqueValueRenderer
+
+## About the data
+
+The [San Francisco 311 incidents layer](https://sampleserver6.arcgisonline.com/arcgis/rest/services/SF311/FeatureServer/0) in this sample displays point features related to crime incidents such as graffiti and tree damage that have been reported by city residents.
+
+## Tags
+
+alternate symbols, multilayer symbol, scale based rendering, simple marker symbol, symbol reference properties, symbology, unique value, unique value renderer

samples/display-alternate-symbols-at-different-scales/README.metadata.json

@@ -0,0 +1,39 @@
+{
+    "category": "Visualization",
+    "description": "Apply a unique value with alternate symbols at different scales.",
+    "formal_name": "DisplayAlternateSymbolsAtDifferentScales",
+    "ignore": false,
+    "images": [
+        "display-alternate-symbols-at-different-scales.png"
+    ],
+    "keywords": [
+        "alternate symbols",
+        "multilayer symbol",
+        "scale based rendering",
+        "simple marker symbol",
+        "symbol reference properties",
+        "symbology",
+        "unique value",
+        "unique value renderer",
+        "MultilayerSymbol",
+        "SimpleMarkerSymbol",
+        "SymbolReferenceProperties",
+        "UniqueValue",
+        "UniqueValueRenderer"
+    ],
+    "language": "kotlin",
+    "redirect_from": "",
+    "relevant_apis": [
+        "MultilayerSymbol",
+        "SimpleMarkerSymbol",
+        "SymbolReferenceProperties",
+        "UniqueValue",
+        "UniqueValueRenderer"
+    ],
+    "snippets": [
+        "src/main/java/com/esri/arcgismaps/sample/displayalternatesymbolsatdifferentscales/components/DisplayAlternateSymbolsAtDifferentScalesViewModel.kt",
+        "src/main/java/com/esri/arcgismaps/sample/displayalternatesymbolsatdifferentscales/MainActivity.kt",
+        "src/main/java/com/esri/arcgismaps/sample/displayalternatesymbolsatdifferentscales/screens/DisplayAlternateSymbolsAtDifferentScalesScreen.kt"
+    ],
+    "title": "Display alternate symbols at different scales"
+}

samples/display-alternate-symbols-at-different-scales/build.gradle.kts

@@ -0,0 +1,22 @@
+plugins {
+    alias(libs.plugins.arcgismaps.android.library)
+    alias(libs.plugins.arcgismaps.android.library.compose)
+    alias(libs.plugins.arcgismaps.kotlin.sample)
+    alias(libs.plugins.gradle.secrets)
+}
+
+secrets {
+    // this file doesn't contain secrets, it just provides defaults which can be committed into git.
+    defaultPropertiesFileName = "secrets.defaults.properties"
+}
+
+android {
+    namespace = "com.esri.arcgismaps.sample.displayalternatesymbolsatdifferentscales"
+    buildFeatures {
+        buildConfig = true
+    }
+}
+
+dependencies {
+    // Only module specific dependencies needed here
+}