100.10 (#866)

* pull from master

* Hud10837/surface placement (#832)

* update java sample to new design

* kotlinize

* clean up

* add readme and metadata details

* add kotlin readme etc

* Update kotlin/surface-placement/src/main/AndroidManifest.xml

Co-Authored-By: TADraeseke <[email protected]>

* move apply block to multiple lines

* make enum references all caps

* remove rogue backtick

* add metadata updater instructions for new files (#827)

* Update build.gradle

* Update build.gradle

* add slider

* finish rebase

* tweak layout

* reformat

* add seekbar

* update readmes and format

* update metadata

* add s

* add s

* update scereenshots

* revert metadata updater change

* Update kotlin/surface-placement/src/main/java/com/esri/arcgisruntime/sample/surfaceplacement/MainActivity.kt

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

* move slider and add value text

* move slider java and format

* make slider background opaque

* edit layout

* update screenshots and java sample

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

* fix metadata snippet generation (#840)

* Hud10837/realistic lighting and shadows (#836)

* create module

* working sample

* rearrange

* update ui

* add comments and clean

* update ui and metadata

* complete checklist

* change category

* change gradle version

* change data

* fix time zone

* fix time zone format

* version number

* Update kotlin/realistic-lighting-and-shadows/README.metadata.json

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

* address pr comments

* block touch events below frame layout

* update data and basemap

* make comments two lines

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

* add lifecycle overrides

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

* Trev8939/feature linked anno (#838)

* initial commit

* working with read only loudoun data

* working prototype

* rename and add readme and screenshot files

* revert not sample files

* add behaviour to select correct end of polyline and disallow selection of multisegment polylines

* PR fixes

* add fix for dot-qualified call with operator

* add instructions that only straight polylines can be selected

* further PR fixes

* shorten toast length

* update README

* Hud10837/identify fixes (#839)

* feature layer selection

* feature layer show attributes

* list related features

* feature layer selection kotlin

* address pr comments

* reformat function call

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

* separate text view name

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

* address pr comments

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

* Hud10837/readme updates (#842)

* animate images with image overlay

* update readmes

* Hud10837/layer view state (#841)

* create module

* simplify and implement new behavior

* add readme

* change ui

* clean up and add screenshot

* change data source

* add comment

* address pr comments

* update readme and screenshot

* add hide layer option

* add error message and fix ui

* format errors

* update metadata

* implement java sample

* update java readme and metadata

* change string resource names

* address pr comments

* address pr comments

* separate map view name

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

* Fix strings

* move airplane mode message

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

* minor fixes feature linked anno

* hud10837/readme-changes-aug-4  (#845)

* update readmes

* update identify workflow readmes

* Hud10837/group layer exclusive (#844)

* almost working initial kotlin version

* clean code and add comments

* remove toast

* clean code

* add readme

* add exclusive radio buttons to java sample

* add metadata and copyright and reformat code

* address pr comments kotlin

* address pr comments java

* fix settings gradle

* Update settings.gradle

* Update settings.gradle

* update open scene portal item to netherlands scene

* change open scene portal item to berlin scene

* rename bottom_sheet.xml and other generic xml files (#848)

* Hud10837/mosaic rule (#847)

* initial implementation

* implement spinner

* failing to load

* clean up and add metadata

* Update kotlin/apply-mosaic-rule-rasters/src/main/java/com/esri/arcgisruntime/sample/applymosaicrulerasters/MainActivity.kt

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

* Update kotlin/apply-mosaic-rule-rasters/src/main/java/com/esri/arcgisruntime/sample/applymosaicrulerasters/MainActivity.kt

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

* remove ags

* change data

* Update kotlin/apply-mosaic-rule-rasters/README.md

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

* Update kotlin/apply-mosaic-rule-rasters/README.md

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

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

* add try/catch to configure subnetwork trace add (#849)

* make smaller barrier in route around barriers and give checkbox unique name in group layers (#851)

* Hud10837/route tracker (#850)

* buggy

* add route tracker location data source to navigate route

* add route tracker location data source

* Update kotlin/navigate-route/src/main/java/com/esri/arcgisruntime/sample/navigateroute/MainActivity.kt

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

* Update kotlin/navigate-route/src/main/java/com/esri/arcgisruntime/sample/navigateroute/MainActivity.kt

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

* Update kotlin/navigate-route/README.md

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

* update java readme

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

* update sample to congressional districts (#852)

* Trev8939/update dependency versions (#853)

* set versions to 100.9

* rename mosaic rule

* Update README.md

* Update version.gradle

* Update version.gradle

* http to https

Merging this to test in daily build

* Hud10837/edit with branch versioning (#855)

* initial veprototype almost working

* debugging

* working prototype

* change method of getting createdversionname

* the same but better

* add comments and kdoc

* add lifecycle overrides

* separate edit location into its own button

* clean up

* remove redundant boolean

* clear selection on cancel

* remove redundant defaultversionname member

* remove redundant currentversionname member

* clean up dialog builders

* fix typo

* update metadata

* update category

* update edit with branch versioning

* update edit with branch versioning (#858)

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

* set version.gradle up U10

* give unique name and password

* update integrated mesh layer screenshots

* fix edit with branch versioning screenshot

* Update README.metadata.json

* Update README.metadata.json

* Samples to new metered basemaps (#862)

* up to and including display map

* add comment and done up to feature layer selection

* all kotlin samples to metered basemaps

* up to and including display map

* part way up to find service area

* up to feature layer geodatabase

* all new basemaps

* fix viewpoint setter and update readmes

* set initial viewpoint to map view setter

* increment to 100.10 release

* increment to 100.10

* update README and build.gradle files

* Update README.md

* Update README.md

* Update README.md

Co-authored-by: hud10837 <[email protected]>
Co-authored-by: TADraeseke <[email protected]>
Co-authored-by: hud10837 <[email protected]>

Author: TADraeseke

README.md

@@ -1,13 +1,22 @@
 # Overview
-ArcGIS Runtime SDK for Android v100.9.0 samples.  The `master` branch of this repository contains sample app modules for the latest available version of the [ArcGIS Runtime SDK for Android](https://developers.arcgis.com/android/). Samples released under older versions can be found through the [git tags](https://github.com/Esri/arcgis-runtime-samples-android/tags).  Please read our [wiki](https://github.com/Esri/arcgis-runtime-samples-android/wiki) for help with working with this repository.
+ArcGIS Runtime SDK for Android v100.10.0 samples.  The `master` branch of this repository contains sample app modules for the latest available version of the [ArcGIS Runtime SDK for Android](https://developers.arcgis.com/android/). Samples released under older versions can be found through the [git tags](https://github.com/Esri/arcgis-runtime-samples-android/tags).  Please read our [wiki](https://github.com/Esri/arcgis-runtime-samples-android/wiki) for help with working with this repository.
 
 # Prerequisites
 * The samples are building with `compileSdkVersion 29`
 * [Android Studio](http://developer.android.com/sdk/index.html)
+* [An ArcGIS Developers API key](https://developers.arcgis.com/android/get-started/#3-get-an-api-key)
 
 ## Developer Instructions
 Please read our [developer instructions wiki page](https://github.com/Esri/arcgis-runtime-samples-android/wiki/dev-instructions) to set up your developer environment with Android Studio.  Instructions include forking and cloning the repository for those new to Git.
 
+## Accessing Esri location services
+Accessing Esri location services, including basemaps, routing, and geocoding, requires authentication using either an API Key or an ArcGIS identity:
+ 1. API key: A permanent key that gives your application access to Esri location services. Visit your [ArcGIS Developers Dashboard](https://developers.arcgis.com/dashboard) to create a new API key or access an existing API key.
+ 
+The Android samples in this repository have been structured to use an API key, set once, which will run in all samples. Set your API key in the `gradle.properties` file located in the `/.gradle` folder within your home directory (`/Users/<user_name>/.gradle/gradle.properties`). The API_KEY property should contain quotes around the key itself: `API_KEY = "YOUR_API_KEY"`
+
+2. ArcGIS identity: An ArcGIS named user account that is a member of an organization in ArcGIS Online or ArcGIS Enterprise.
+
 ## Run a sample
 Once you have set up your developer environment you can run any sample from within Android Studio by selecting the app module from the **Edit Configurations** drop down and clicking the **Run** button from the toolbar. 
 
@@ -57,7 +66,7 @@ Anyone and everyone is welcome to [contribute](.github/CONTRIBUTING.md). We do a
 Please see our [guidelines for contributing doc](https://github.com/Esri/contributing/blob/master/README.md)
 
 ## Licensing
-Copyright 2020 Esri
+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
 

java/add-enc-exchange-set/build.gradle

@@ -9,6 +9,7 @@ android {
         targetSdkVersion rootProject.ext.targetSdkVersion
         versionCode rootProject.ext.versionCode
         versionName rootProject.ext.versionName
+        buildConfigField("String", "API_KEY", API_KEY)
     }
 
     buildTypes {

java/add-enc-exchange-set/src/main/java/com/esri/arcgisruntime/sample/addencexchangeset/MainActivity.java

@@ -25,6 +25,7 @@
 import android.widget.Toast;
 
 import androidx.appcompat.app.AppCompatActivity;
+import com.esri.arcgisruntime.ArcGISRuntimeEnvironment;
 import com.esri.arcgisruntime.geometry.Envelope;
 import com.esri.arcgisruntime.geometry.GeometryEngine;
 import com.esri.arcgisruntime.hydrography.EncCell;
@@ -34,7 +35,7 @@
 import com.esri.arcgisruntime.layers.EncLayer;
 import com.esri.arcgisruntime.loadable.LoadStatus;
 import com.esri.arcgisruntime.mapping.ArcGISMap;
-import com.esri.arcgisruntime.mapping.Basemap;
+import com.esri.arcgisruntime.mapping.BasemapStyle;
 import com.esri.arcgisruntime.mapping.Viewpoint;
 import com.esri.arcgisruntime.mapping.view.MapView;
 
@@ -52,10 +53,14 @@ protected void onCreate(Bundle savedInstanceState) {
     super.onCreate(savedInstanceState);
     setContentView(R.layout.activity_main);
 
+    // authentication with an API key or named user is required to access basemaps and other
+    // location services
+    ArcGISRuntimeEnvironment.setApiKey(BuildConfig.API_KEY);
+
     // get a reference to the map view
     mMapView = findViewById(R.id.mapView);
     // create a map with the BasemapType topographic
-    ArcGISMap map = new ArcGISMap(Basemap.createOceans());
+    ArcGISMap map = new ArcGISMap(BasemapStyle.ARCGIS_OCEANS);
     // set the map to be displayed in this view
     mMapView.setMap(map);
 

java/add-features-feature-service/build.gradle

@@ -9,6 +9,7 @@ android {
         targetSdkVersion rootProject.ext.targetSdkVersion
         versionCode rootProject.ext.versionCode
         versionName rootProject.ext.versionName
+        buildConfigField("String", "API_KEY", API_KEY)
     }
 
     buildTypes {

java/add-features-feature-service/src/main/java/com/esri/arcgisruntime/sample/addfeaturesfeatureservice/MainActivity.java

@@ -22,20 +22,22 @@
 import java.util.concurrent.ExecutionException;
 
 import android.os.Bundle;
-import androidx.annotation.Nullable;
-import androidx.appcompat.app.AppCompatActivity;
 import android.util.Log;
 import android.view.MotionEvent;
 import android.widget.Toast;
 
+import androidx.annotation.Nullable;
+import androidx.appcompat.app.AppCompatActivity;
+import com.esri.arcgisruntime.ArcGISRuntimeEnvironment;
 import com.esri.arcgisruntime.concurrent.ListenableFuture;
 import com.esri.arcgisruntime.data.Feature;
 import com.esri.arcgisruntime.data.FeatureEditResult;
 import com.esri.arcgisruntime.data.ServiceFeatureTable;
 import com.esri.arcgisruntime.geometry.Point;
 import com.esri.arcgisruntime.layers.FeatureLayer;
 import com.esri.arcgisruntime.mapping.ArcGISMap;
-import com.esri.arcgisruntime.mapping.Basemap;
+import com.esri.arcgisruntime.mapping.BasemapStyle;
+import com.esri.arcgisruntime.mapping.Viewpoint;
 import com.esri.arcgisruntime.mapping.view.DefaultMapViewOnTouchListener;
 import com.esri.arcgisruntime.mapping.view.MapView;
 
@@ -51,10 +53,14 @@ public class MainActivity extends AppCompatActivity {
     super.onCreate(savedInstanceState);
     setContentView(R.layout.activity_main);
 
+    // authentication with an API key or named user is required to access basemaps and other
+    // location services
+    ArcGISRuntimeEnvironment.setApiKey(BuildConfig.API_KEY);
+
     mMapView = findViewById(R.id.mapView);
 
     // create a map with streets basemap
-    ArcGISMap map = new ArcGISMap(Basemap.Type.STREETS, 40.0, -95.0, 4);
+    ArcGISMap map = new ArcGISMap(BasemapStyle.ARCGIS_STREETS);
 
     // create service feature table from URL
     mServiceFeatureTable = new ServiceFeatureTable(getString(R.string.service_layer_url));
@@ -83,6 +89,7 @@ public class MainActivity extends AppCompatActivity {
 
     // set map to be displayed in map view
     mMapView.setMap(map);
+    mMapView.setViewpoint(new Viewpoint( 40.0, -95.0, 10000000.0));
   }
 
   /**

java/add-graphics-renderer/build.gradle

@@ -9,6 +9,7 @@ android {
         targetSdkVersion rootProject.ext.targetSdkVersion
         versionCode rootProject.ext.versionCode
         versionName rootProject.ext.versionName
+        buildConfigField("String", "API_KEY", API_KEY)
     }
     buildTypes {
         release {

java/add-graphics-renderer/src/main/java/com/esri/arcgisruntime/sample/addgraphicsrenderer/MainActivity.java

@@ -18,14 +18,16 @@
 
 import android.graphics.Color;
 import android.os.Bundle;
-import androidx.appcompat.app.AppCompatActivity;
 
+import androidx.appcompat.app.AppCompatActivity;
+import com.esri.arcgisruntime.ArcGISRuntimeEnvironment;
 import com.esri.arcgisruntime.geometry.Point;
 import com.esri.arcgisruntime.geometry.PolygonBuilder;
 import com.esri.arcgisruntime.geometry.PolylineBuilder;
 import com.esri.arcgisruntime.geometry.SpatialReferences;
 import com.esri.arcgisruntime.mapping.ArcGISMap;
-import com.esri.arcgisruntime.mapping.Basemap;
+import com.esri.arcgisruntime.mapping.BasemapStyle;
+import com.esri.arcgisruntime.mapping.Viewpoint;
 import com.esri.arcgisruntime.mapping.view.Graphic;
 import com.esri.arcgisruntime.mapping.view.GraphicsOverlay;
 import com.esri.arcgisruntime.mapping.view.MapView;
@@ -43,14 +45,19 @@ protected void onCreate(Bundle savedInstanceState) {
     super.onCreate(savedInstanceState);
     setContentView(R.layout.activity_main);
 
+    // authentication with an API key or named user is required to access basemaps and other
+    // location services
+    ArcGISRuntimeEnvironment.setApiKey(BuildConfig.API_KEY);
+
     // create MapView from layout
-    mMapView = (MapView) findViewById(R.id.mapView);
+    mMapView = findViewById(R.id.mapView);
     // create a map with the Basemap Type topographic
-    ArcGISMap mMap = new ArcGISMap(Basemap.Type.TOPOGRAPHIC, 15.169193, 16.333479, 2);
+    ArcGISMap map = new ArcGISMap(BasemapStyle.ARCGIS_TOPOGRAPHIC);
     // add graphics overlay
     addGraphicsOverlay();
     // set the map to be displayed in this view
-    mMapView.setMap(mMap);
+    mMapView.setMap(map);
+    mMapView.setViewpoint(new Viewpoint(15.169193, 16.333479, 100000000.0));
   }
 
   private void addGraphicsOverlay() {

java/add-graphics-with-symbols/build.gradle

@@ -9,6 +9,7 @@ android {
         targetSdkVersion rootProject.ext.targetSdkVersion
         versionCode rootProject.ext.versionCode
         versionName rootProject.ext.versionName
+        buildConfigField("String", "API_KEY", API_KEY)
     }
     buildTypes {
         release {

java/add-graphics-with-symbols/src/main/java/com/esri/arcgisruntime/sample/addgraphicswithsymbols/MainActivity.java

@@ -18,16 +18,18 @@
 
 import android.graphics.Color;
 import android.os.Bundle;
-import androidx.appcompat.app.AppCompatActivity;
 
+import androidx.appcompat.app.AppCompatActivity;
+import com.esri.arcgisruntime.ArcGISRuntimeEnvironment;
 import com.esri.arcgisruntime.geometry.Point;
 import com.esri.arcgisruntime.geometry.PointCollection;
 import com.esri.arcgisruntime.geometry.Polygon;
 import com.esri.arcgisruntime.geometry.Polyline;
 import com.esri.arcgisruntime.geometry.SpatialReference;
 import com.esri.arcgisruntime.geometry.SpatialReferences;
 import com.esri.arcgisruntime.mapping.ArcGISMap;
-import com.esri.arcgisruntime.mapping.Basemap;
+import com.esri.arcgisruntime.mapping.BasemapStyle;
+import com.esri.arcgisruntime.mapping.Viewpoint;
 import com.esri.arcgisruntime.mapping.view.Graphic;
 import com.esri.arcgisruntime.mapping.view.GraphicsOverlay;
 import com.esri.arcgisruntime.mapping.view.MapView;
@@ -46,12 +48,17 @@ protected void onCreate(Bundle savedInstanceState) {
     super.onCreate(savedInstanceState);
     setContentView(R.layout.activity_main);
 
+    // authentication with an API key or named user is required to access basemaps and other
+    // location services
+    ArcGISRuntimeEnvironment.setApiKey(BuildConfig.API_KEY);
+
     // inflate MapView from layout
-    mMapView = (MapView) findViewById(R.id.mapView);
+    mMapView = findViewById(R.id.mapView);
     // create a map with the BasemapType topographic
-    ArcGISMap map = new ArcGISMap(Basemap.Type.OCEANS, 56.075844, -2.681572, 11);
+    ArcGISMap map = new ArcGISMap(BasemapStyle.ARCGIS_OCEANS);
     // set the map to be displayed in this view
     mMapView.setMap(map);
+    mMapView.setViewpoint(new Viewpoint(56.075844, -2.681572, 100000.0));
     // add graphics overlay to MapView.
     GraphicsOverlay graphicsOverlay = addGraphicsOverlay(mMapView);
     //add some buoy positions to the graphics overlay

java/analyze-hotspots/build.gradle

@@ -9,6 +9,7 @@ android {
         targetSdkVersion rootProject.ext.targetSdkVersion
         versionCode rootProject.ext.versionCode
         versionName rootProject.ext.versionName
+        buildConfigField("String", "API_KEY", API_KEY)
     }
 
     buildTypes {