Set initial viewpoint

/* 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.setinitialviewpoint

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.setinitialviewpoint.screens.SetInitialViewpointScreen

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 {
                SetInitialViewpointApp()
            }
        }
    }

    @Composable
    private fun SetInitialViewpointApp() {
        Surface(color = MaterialTheme.colorScheme.background) {
            SetInitialViewpointScreen(
                sampleName = getString(R.string.set_initial_viewpoint_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.setinitialviewpoint.components

import android.app.Application
import androidx.lifecycle.AndroidViewModel
import androidx.lifecycle.viewModelScope
import com.arcgismaps.geometry.Envelope
import com.arcgismaps.geometry.SpatialReference
import com.arcgismaps.mapping.ArcGISMap
import com.arcgismaps.mapping.BasemapStyle
import com.arcgismaps.mapping.Viewpoint
import com.esri.arcgismaps.sample.sampleslib.components.MessageDialogViewModel
import kotlinx.coroutines.launch

/**
 * ViewModel for the SetInitialViewpoint sample.
 *
 * Exposes an ArcGISMap with an initial viewpoint defined by a bounding Envelope.
 */
class SetInitialViewpointViewModel(application: Application) : AndroidViewModel(application) {

    /**
     * ArcGISMap configured with an imagery basemap and an initial viewpoint.
     * The initial viewpoint is set using a bounding geometry (Envelope) in Web Mercator.
     */
    val arcGISMap = ArcGISMap(BasemapStyle.ArcGISImageryStandard).apply {
        initialViewpoint = Viewpoint(
            // Web Mercator coordinates around Potash Ponds, Moab, Utah.
            boundingGeometry = Envelope(
                xMin = -12211308.778729,
                yMin = 4645116.003309,
                xMax = -12208257.879667,
                yMax = 4650542.535773,
                spatialReference = SpatialReference.webMercator()
            )
        )
    }


    // Message dialog VM to show errors
    val messageDialogVM = MessageDialogViewModel()

    init {
        // Load the map and report errors through the message dialog
        viewModelScope.launch {
            arcGISMap.load().onFailure { throwable ->
                messageDialogVM.showMessageDialog(throwable)
            }
        }
    }
}

/* 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.setinitialviewpoint.screens

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.ui.Modifier
import androidx.lifecycle.viewmodel.compose.viewModel
import com.arcgismaps.toolkit.geoviewcompose.MapView
import com.esri.arcgismaps.sample.setinitialviewpoint.components.SetInitialViewpointViewModel
import com.esri.arcgismaps.sample.sampleslib.components.MessageDialog
import com.esri.arcgismaps.sample.sampleslib.components.SampleTopAppBar

/**
 * Screen composable that hosts the MapView and observes the ViewModel.
 * The MapView receives the ArcGISMap from the ViewModel which contains the initial viewpoint.
 */
@Composable
fun SetInitialViewpointScreen(sampleName: String) {
    val mapViewModel: SetInitialViewpointViewModel = viewModel()

    Scaffold(
        topBar = { SampleTopAppBar(title = sampleName) }
    ) { paddingValues ->
        // MapView displays the map configured in the ViewModel
        MapView(
            modifier = Modifier
                .fillMaxSize()
                .padding(paddingValues),
            arcGISMap = mapViewModel.arcGISMap
        )
    }

    // Show message dialog when the viewmodel reports an error
    mapViewModel.messageDialogVM.apply {
        if (dialogStatus) {
            MessageDialog(
                title = messageTitle,
                description = messageDescription,
                onDismissRequest = ::dismissDialog
            )
        }
    }
}