Add raster from service

/* Copyright 2025 Esri
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 */

package com.esri.arcgismaps.sample.addrasterfromservice

import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Surface
import androidx.compose.runtime.Composable
import com.arcgismaps.ApiKey
import com.arcgismaps.ArcGISEnvironment
import com.esri.arcgismaps.sample.sampleslib.theme.SampleAppTheme
import com.esri.arcgismaps.sample.addrasterfromservice.screens.AddRasterFromServiceScreen

class MainActivity : ComponentActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // authentication with an API key or named user is
        // required to access basemaps and other location services
        ArcGISEnvironment.apiKey = ApiKey.create(BuildConfig.ACCESS_TOKEN)

        setContent {
            SampleAppTheme {
                AddRasterFromServiceApp()
            }
        }
    }

    @Composable
    private fun AddRasterFromServiceApp() {
        Surface(color = MaterialTheme.colorScheme.background) {
            AddRasterFromServiceScreen(
                sampleName = getString(R.string.add_raster_from_service_app_name)
            )
        }
    }
}

/* Copyright 2025 Esri
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 */

package com.esri.arcgismaps.sample.addrasterfromservice.components

import android.app.Application
import androidx.lifecycle.AndroidViewModel
import androidx.lifecycle.viewModelScope
import com.arcgismaps.LoadStatus
import com.arcgismaps.geometry.Point
import com.arcgismaps.geometry.SpatialReference
import com.arcgismaps.mapping.ArcGISMap
import com.arcgismaps.mapping.BasemapStyle
import com.arcgismaps.mapping.Viewpoint
import com.arcgismaps.mapping.layers.RasterLayer
import com.arcgismaps.raster.ImageServiceRaster
import com.esri.arcgismaps.sample.sampleslib.components.MessageDialogViewModel
import kotlinx.coroutines.flow.MutableStateFlow
import kotlinx.coroutines.flow.asStateFlow
import kotlinx.coroutines.launch

/**
 * ViewModel for the Add raster from service sample.
 */
class AddRasterFromServiceViewModel(application: Application) : AndroidViewModel(application) {

    // Map used by the Compose MapView
    var arcGISMap = ArcGISMap(BasemapStyle.ArcGISDarkGray).apply {
        initialViewpoint = Viewpoint(
            center = Point(-13637000.0, 4550000.0, SpatialReference.webMercator()),
            scale = 100000.0
        )
    }


    // The image service raster (NOAA bathymetry service)
    private val imageServiceRaster = ImageServiceRaster(
        url = "https://gis.ngdc.noaa.gov/arcgis/rest/services/bag_bathymetry/ImageServer"
    )

    // Raster layer that will display the image service raster
    private val rasterLayer = RasterLayer(imageServiceRaster)

    // Flow exposing the current load status of the raster layer for the UI to observe
    private val _rasterLoadStatus = MutableStateFlow<LoadStatus>(LoadStatus.NotLoaded)
    val rasterLoadStatus = _rasterLoadStatus.asStateFlow()

    // Message dialog view model for error reporting
    val messageDialogVM = MessageDialogViewModel()

    init {
        // Add the raster layer to the map's operational layers
        arcGISMap.operationalLayers.add(rasterLayer)

        // Start loading the raster layer and observe its load status
        viewModelScope.launch {
            // Attempt to load the raster layer and report any immediate failures
            rasterLayer.load().onFailure { throwable ->
                messageDialogVM.showMessageDialog(throwable)
            }.onSuccess {
                _rasterLoadStatus.value = LoadStatus.Loaded
            }
        }
    }
}

/* Copyright 2025 Esri
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 */

package com.esri.arcgismaps.sample.addrasterfromservice.screens

import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.Scaffold
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.ui.Modifier
import androidx.lifecycle.compose.collectAsStateWithLifecycle
import androidx.lifecycle.viewmodel.compose.viewModel
import com.arcgismaps.LoadStatus
import com.arcgismaps.toolkit.geoviewcompose.MapView
import com.esri.arcgismaps.sample.addrasterfromservice.components.AddRasterFromServiceViewModel
import com.esri.arcgismaps.sample.sampleslib.components.LoadingDialog
import com.esri.arcgismaps.sample.sampleslib.components.MessageDialog
import com.esri.arcgismaps.sample.sampleslib.components.SampleTopAppBar

/**
 * Main screen layout for the sample app.
 * Displays a MapView showing a raster retrieved from an image service.
 */
@Composable
fun AddRasterFromServiceScreen(sampleName: String) {
    val mapViewModel: AddRasterFromServiceViewModel = viewModel()

    // Observe raster load status to show a simple loading overlay while the raster is being fetched/drawn
    val rasterLoadStatus by mapViewModel.rasterLoadStatus.collectAsStateWithLifecycle()

    Scaffold(
        topBar = { SampleTopAppBar(title = sampleName) },
        content = { padding ->
            Column(
                modifier = Modifier
                    .fillMaxSize()
                    .padding(padding)
            ) {
                MapView(
                    modifier = Modifier
                        .fillMaxSize()
                        .weight(1f),
                    arcGISMap = mapViewModel.arcGISMap,
                )
            }

            // Display a loading dialog while the raster layer is not yet fully loaded
            if (rasterLoadStatus != LoadStatus.Loaded) {
                LoadingDialog(loadingMessage = "Loading raster…")
            }

            // Display any error messages raised by the ViewModel
            mapViewModel.messageDialogVM.apply {
                if (dialogStatus) {
                    MessageDialog(
                        title = messageTitle,
                        description = messageDescription,
                        onDismissRequest = ::dismissDialog
                    )
                }
            }
        }
    )
}