Create and save map

<UserControl x:Class="ArcGIS.WinUI.Samples.AuthorMap.AuthorMap"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:esriUI="using:Esri.ArcGISRuntime.UI.Controls">
    <UserControl.Resources>
        <Style TargetType="TextBlock">
            <Setter Property="FontWeight" Value="SemiBold" />
            <Setter Property="HorizontalAlignment" Value="Center" />
            <Setter Property="VerticalAlignment" Value="Center" />
            <Setter Property="Margin" Value="0,2.5,0,2.5" />
        </Style>
        <Style TargetType="TextBox">
            <Setter Property="Margin" Value="0,2.5,0,2.5" />
            <Setter Property="Padding" Value="2.5" />
            <Setter Property="HorizontalAlignment" Value="Stretch" />
        </Style>
        <Style TargetType="Button">
            <Setter Property="HorizontalAlignment" Value="Stretch" />
            <Setter Property="Margin" Value="0,2.5,0,2.5" />
        </Style>
    </UserControl.Resources>
    <Grid>
        <Grid.ColumnDefinitions>
            <ColumnDefinition />
            <ColumnDefinition Width="300" />
        </Grid.ColumnDefinitions>
        <ScrollViewer Grid.Column="1" Padding="5">
            <Grid>
                <Grid.RowDefinitions>
                    <RowDefinition Height="Auto" />
                    <RowDefinition Height="Auto" />
                    <RowDefinition Height="Auto" />
                    <RowDefinition Height="Auto" />
                    <RowDefinition Height="Auto" />
                    <RowDefinition Height="Auto" />
                    <RowDefinition Height="Auto" />
                    <RowDefinition Height="Auto" />
                </Grid.RowDefinitions>
                <TextBlock Text="Select a basemap" />
                <ComboBox x:Name="BasemapListBox"
                          Grid.Row="1"
                          HorizontalAlignment="Stretch" />
                <TextBlock Grid.Row="2" Text="Choose layers" />
                <ListBox x:Name="OperationalLayerListBox"
                         Grid.Row="3"
                         SelectionChanged="LayerSelectionChanged"
                         SelectionMode="Multiple">
                    <ListBox.ItemTemplate>
                        <DataTemplate>
                            <TextBlock Text="{Binding Key}" />
                        </DataTemplate>
                    </ListBox.ItemTemplate>
                </ListBox>
                <TextBlock Grid.Row="4"
                           Grid.Column="0"
                           Text="Pan and zoom to set initial extent" />
                <Grid Grid.Row="5">
                    <Grid.RowDefinitions>
                        <RowDefinition Height="Auto" />
                        <RowDefinition Height="Auto" />
                        <RowDefinition Height="Auto" />
                        <RowDefinition Height="Auto" />
                    </Grid.RowDefinitions>
                    <Grid.ColumnDefinitions>
                        <ColumnDefinition Width="Auto" />
                        <ColumnDefinition Width="*" />
                    </Grid.ColumnDefinitions>
                    <TextBlock Grid.Row="0"
                               Grid.Column="0"
                               Margin="0,0,5,0"
                               Text="X Min:" />
                    <TextBox x:Name="XMinTextBox"
                             Grid.Row="0"
                             Grid.Column="1"
                             IsReadOnly="True" />
                    <TextBlock Grid.Row="1"
                               Grid.Column="0"
                               Margin="0,0,5,0"
                               Text="Y Min:" />
                    <TextBox x:Name="YMinTextBox"
                             Grid.Row="1"
                             Grid.Column="1"
                             IsReadOnly="True" />
                    <TextBlock Grid.Row="2"
                               Grid.Column="0"
                               Margin="0,0,5,0"
                               Text="X Max:" />
                    <TextBox x:Name="XMaxTextBox"
                             Grid.Row="2"
                             Grid.Column="1"
                             IsReadOnly="True" />
                    <TextBlock Grid.Row="3"
                               Grid.Column="0"
                               Margin="0,0,5,0"
                               Text="Y Max:" />
                    <TextBox x:Name="YMaxTextBox"
                             Grid.Row="3"
                             Grid.Column="1"
                             IsReadOnly="True" />
                </Grid>
                <Button Grid.Row="6"
                        Click="NewMapClicked"
                        Content="New map" />
                <Grid x:Name="SaveMapGrid"
                      Grid.Row="7"
                      Margin="10">
                    <Grid.RowDefinitions>
                        <RowDefinition Height="Auto" />
                        <RowDefinition Height="Auto" />
                        <RowDefinition Height="Auto" />
                        <RowDefinition Height="Auto" />
                        <RowDefinition Height="Auto" />
                    </Grid.RowDefinitions>
                    <Grid.ColumnDefinitions>
                        <ColumnDefinition Width="Auto" />
                        <ColumnDefinition Width="*" />
                    </Grid.ColumnDefinitions>
                    <TextBlock Margin="0,0,5,0"
                               HorizontalAlignment="Right"
                               Text="Title:" />
                    <TextBox x:Name="TitleTextBox"
                             Grid.Row="0"
                             Grid.Column="1"
                             Text="My Map" />
                    <TextBlock Grid.Row="1"
                               Grid.Column="0"
                               Margin="0,0,5,0"
                               HorizontalAlignment="Right"
                               Text="Description:" />
                    <TextBox x:Name="DescriptionTextBox"
                             Grid.Row="1"
                             Grid.Column="1"
                             Text="Authored and saved using ArcGIS Maps SDK for .NET."
                             TextWrapping="Wrap" />
                    <TextBlock Grid.Row="2"
                               Grid.Column="0"
                               Margin="0,0,5,0"
                               HorizontalAlignment="Right"
                               Text="Tags:" />
                    <TextBox x:Name="TagsTextBox"
                             Grid.Row="2"
                             Grid.Column="1"
                             Text="ArcGIS, Sample" />
                    <Button Grid.Row="3"
                            Grid.Column="0"
                            Grid.ColumnSpan="2"
                            Click="SaveMapClicked"
                            Content="Save map to portal"
                            IsEnabled="{Binding ElementName=MyMapView}" />
                    <ProgressBar x:Name="SaveProgressBar"
                                 Grid.Row="4"
                                 Grid.Column="0"
                                 Grid.ColumnSpan="2"
                                 Height="15"
                                 Margin="10,0,10,0"
                                 HorizontalAlignment="Stretch"
                                 IsIndeterminate="True"
                                 Visibility="Collapsed" />
                </Grid>
            </Grid>
        </ScrollViewer>
        <esriUI:MapView x:Name="MyMapView" Grid.Column="0" />
    </Grid>
</UserControl>

// Copyright 2021 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.

using ArcGIS.Helpers;
using Esri.ArcGISRuntime.Geometry;
using Esri.ArcGISRuntime.Mapping;
using Esri.ArcGISRuntime.Portal;
using Esri.ArcGISRuntime.UI;
using Microsoft.UI.Xaml;
using Microsoft.UI.Xaml.Controls;
using System;
using System.Collections.Generic;
using System.IO;
using System.Threading.Tasks;

namespace ArcGIS.WinUI.Samples.AuthorMap
{
    [ArcGIS.Samples.Shared.Attributes.Sample(
        name: "Create and save map",
        category: "Map",
        description: "Create and save a map as an ArcGIS `PortalItem` (i.e. web map).",
        instructions: "1. Select the basemap and layers you'd like to add to your map.",
        tags: new[] { "ArcGIS Online", "OAuth", "portal", "publish", "share", "web map" })]
    [ArcGIS.Samples.Shared.Attributes.ClassFile("Helpers\\ArcGISLoginPrompt.cs")]
    public partial class AuthorMap
    {
        // String array to store names of the available basemaps
        private readonly string[] _basemapNames = {
            "Light Gray",
            "Topographic",
            "Streets",
            "Imagery",
            "Ocean"
        };

        // Key value pairs of operational layer names and URLs
        private readonly KeyValuePair<string, string>[] _operationalLayerUrls = {
            KeyValuePair.Create("World Elevations", "https://sampleserver6.arcgisonline.com/arcgis/rest/services/Elevation/WorldElevations/MapServer"),
            KeyValuePair.Create("World Cities", "https://sampleserver6.arcgisonline.com/arcgis/rest/services/SampleWorldCities/MapServer/"),
            KeyValuePair.Create("US Census Data", "https://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer"),
        };

        public AuthorMap()
        {
            InitializeComponent();

            // Create the UI, setup the control references and execute initialization
            _ = Initialize();
        }

        private async Task Initialize()
        {
            ArcGISLoginPrompt.SetChallengeHandler(this);

            bool loggedIn = await ArcGISLoginPrompt.EnsureAGOLCredentialAsync();

            // Show a plain gray map in the map view
            if (loggedIn)
            {
                MyMapView.Map = new Map(BasemapStyle.ArcGISLightGray);
            }
            else MyMapView.Map = new Map();

            // Update the UI with basemaps and layers
            BasemapListBox.ItemsSource = _basemapNames;

            // Add a listener for changes in the selected basemap.
            BasemapListBox.SelectionChanged += BasemapSelectionChanged;

            // Update the extent labels whenever the view point (extent) changes
            MyMapView.ViewpointChanged += (s, evt) => UpdateViewExtentLabels();

            OperationalLayerListBox.ItemsSource = _operationalLayerUrls;
        }

        #region UI event handlers

        private void LayerSelectionChanged(object sender, SelectionChangedEventArgs e)
        {
            // Call a function to add operational layers to the map
            AddOperationalLayers();
        }

        private async void SaveMapClicked(object sender, RoutedEventArgs e)
        {
            try
            {
                // Show the progress bar so the user knows work is happening
                SaveProgressBar.Visibility = Visibility.Visible;

                // Get the current map
                Map myMap = MyMapView.Map;

                // Apply the current extent as the map's initial extent
                myMap.InitialViewpoint = MyMapView.GetCurrentViewpoint(ViewpointType.BoundingGeometry);

                // Export the current map view to use as the item's thumbnail
                RuntimeImage thumbnailImg = await MyMapView.ExportImageAsync();

                // See if the map has already been saved (has an associated portal item)
                if (myMap.Item == null)
                {
                    // Get information for the new portal item
                    string title = TitleTextBox.Text;
                    string description = DescriptionTextBox.Text;
                    string tagText = TagsTextBox.Text;

                    // Make sure all required info was entered
                    if (string.IsNullOrEmpty(title) || string.IsNullOrEmpty(description) || string.IsNullOrEmpty(tagText))
                    {
                        throw new Exception("Please enter a title, description, and some tags to describe the map.");
                    }

                    // Call a function to save the map as a new portal item
                    await SaveNewMapAsync(MyMapView.Map, title, description, tagText.Split(','), thumbnailImg);

                    // Report a successful save
                    await new MessageDialog2("Saved '" + title + "' to ArcGIS Online!", "Map Saved").ShowAsync();
                }
                else
                {
                    // This is not the initial save, call SaveAsync to save changes to the existing portal item
                    await myMap.SaveAsync();

                    // Get the file stream from the new thumbnail image
                    Stream imageStream = await thumbnailImg.GetEncodedBufferAsync();

                    // Update the item thumbnail
                    ((PortalItem)myMap.Item).SetThumbnail(imageStream);
                    await myMap.SaveAsync();

                    // Report update was successful
                    await new MessageDialog2("Saved changes to '" + myMap.Item.Title + "'", "Updates Saved").ShowAsync();
                }
            }
            catch (Exception ex)
            {
                // Report error message
                await new MessageDialog2("Error saving map to ArcGIS Online: " + ex.Message).ShowAsync();
            }
            finally
            {
                // Hide the progress bar
                SaveProgressBar.Visibility = Visibility.Collapsed;
            }
        }

        private void NewMapClicked(object sender, RoutedEventArgs e)
        {
            // Create a new map (will not have an associated PortalItem)
            MyMapView.Map = new Map(BasemapStyle.ArcGISLightGray);
            MyMapView.Map.Basemap.LoadAsync();

            // Reset the basemap selection in the UI
            BasemapListBox.SelectedIndex = 0;

            // Reset the layer selection in the UI;
            OperationalLayerListBox.SelectedIndex = -1;

            // Reset the extent labels
            UpdateViewExtentLabels();
        }

        #endregion UI event handlers

        private void ApplyBasemap(string basemapName)
        {
            // Set the basemap for the map according to the user's choice in the list box.
            switch (basemapName)
            {
                case "Light Gray":
                    MyMapView.Map.Basemap = new Basemap(BasemapStyle.ArcGISLightGray);
                    break;

                case "Topographic":
                    MyMapView.Map.Basemap = new Basemap(BasemapStyle.ArcGISTopographic);
                    break;

                case "Streets":
                    MyMapView.Map.Basemap = new Basemap(BasemapStyle.ArcGISStreets);
                    break;

                case "Imagery":
                    MyMapView.Map.Basemap = new Basemap(BasemapStyle.ArcGISImagery);
                    break;

                case "Ocean":
                    MyMapView.Map.Basemap = new Basemap(BasemapStyle.ArcGISOceans);
                    break;
            }

            MyMapView.Map.Basemap.LoadAsync();
        }

        private void AddOperationalLayers()
        {
            // Clear the operational layers from the map
            Map myMap = MyMapView.Map;
            myMap.OperationalLayers.Clear();

            // Loop through the selected items in the operational layers list box
            foreach (KeyValuePair<string, string> item in OperationalLayerListBox.SelectedItems)
            {
                // Get the service uri for each selected item
                KeyValuePair<string, string> layerInfo = item;
                Uri layerUri = new Uri(layerInfo.Value);

                // Create a new map image layer, set it 50% opaque, and add it to the map
                ArcGISMapImageLayer layer = new ArcGISMapImageLayer(layerUri)
                {
                    Opacity = 0.5
                };
                myMap.OperationalLayers.Add(layer);
            }
        }

        private async Task SaveNewMapAsync(Map myMap, string title, string description, string[] tags, RuntimeImage img)
        {
            await ArcGISLoginPrompt.EnsureAGOLCredentialAsync();

            // Get the ArcGIS Online portal (will use credential from login above)
            ArcGISPortal agsOnline = await ArcGISPortal.CreateAsync();

            // Save the current state of the map as a portal item in the user's default folder
            await myMap.SaveAsAsync(agsOnline, null, title, description, tags, img);
        }

        private void UpdateViewExtentLabels()
        {
            // Get the current view point for the map view
            Viewpoint currentViewpoint = MyMapView.GetCurrentViewpoint(ViewpointType.BoundingGeometry);
            if (currentViewpoint == null) { return; }

            // Get the current map extent (envelope) from the view point
            Envelope currentExtent = currentViewpoint.TargetGeometry as Envelope;

            // Project the current extent to geographic coordinates (longitude / latitude)
            Envelope currentGeoExtent = (Envelope)currentExtent.Project(SpatialReferences.Wgs84);

            // Fill the app text boxes with min / max longitude (x) and latitude (y) to four decimal places
            XMinTextBox.Text = currentGeoExtent.XMin.ToString("0.####");
            YMinTextBox.Text = currentGeoExtent.YMin.ToString("0.####");
            XMaxTextBox.Text = currentGeoExtent.XMax.ToString("0.####");
            YMaxTextBox.Text = currentGeoExtent.YMax.ToString("0.####");
        }

        private void BasemapSelectionChanged(object sender, SelectionChangedEventArgs e)
        {
            // Get the name of the desired basemap
            string name = e.AddedItems[0].ToString();

            // Apply the basemap to the current map
            ApplyBasemap(name);
        }
    }
}