New Basemaps: Network Analysis and OGC Categories (#607)

* Closest facility

* Closest facility static

* Find service areas for multiple facilities

* Routing around barriers

* Service area task

* Browse wfs layers

* Display wfs layer sample

* OpenStreetMap layer

* WFS XML query

* WMS layer URL

* OpenStreetMap Layer - set viewpoint on mapview

* Find route

* OSM - update readme and comment

* update build.gradle - versions

* Tidy up comment and scale consistencies

* comment typo fix

Author: jenmerritt

network_analysis/closest-facility-static/build.gradle

@@ -6,7 +6,7 @@ plugins {
 group = 'com.esri.samples'
 
 ext {
-    arcgisVersion = '100.9.0'
+    arcgisVersion = '100.10.0-2992'
 }
 
 javafx {

network_analysis/closest-facility-static/src/main/java/com/esri/samples/closest_facility_static/ClosestFacilityStaticSample.java

@@ -31,6 +31,7 @@
 import javafx.scene.layout.StackPane;
 import javafx.stage.Stage;
 
+import com.esri.arcgisruntime.ArcGISRuntimeEnvironment;
 import com.esri.arcgisruntime.concurrent.ListenableFuture;
 import com.esri.arcgisruntime.data.Feature;
 import com.esri.arcgisruntime.data.FeatureQueryResult;
@@ -43,7 +44,7 @@
 import com.esri.arcgisruntime.layers.FeatureLayer;
 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.view.Graphic;
 import com.esri.arcgisruntime.mapping.view.GraphicsOverlay;
 import com.esri.arcgisruntime.mapping.view.MapView;
@@ -77,6 +78,10 @@ public void start(Stage stage) throws Exception {
       stage.setScene(scene);
       stage.show();
 
+      // authentication with an API key or named user is required to access basemaps and other location services
+      String yourAPIKey = System.getProperty("apiKey");
+      ArcGISRuntimeEnvironment.setApiKey(yourAPIKey);
+
       // create buttons
       Button solveRoutesButton = new Button("Solve Routes");
       solveRoutesButton.setMaxWidth(150);
@@ -86,10 +91,10 @@ public void start(Stage stage) throws Exception {
       ProgressIndicator progressIndicator = new ProgressIndicator();
       progressIndicator.setVisible(true);
 
-      // create a ArcGISMap with a Basemap instance with an Imagery base layer
-      ArcGISMap map = new ArcGISMap(Basemap.createStreetsWithReliefVector());
+      // create a map with the streets relief basemap style
+      ArcGISMap map = new ArcGISMap(BasemapStyle.ARCGIS_STREETS_RELIEF);
 
-      // set the map to be displayed in this view
+      // create a map view and set the map to it
       mapView = new MapView();
       mapView.setMap(map);
 

network_analysis/closest-facility/build.gradle

@@ -6,7 +6,7 @@ plugins {
 group = 'com.esri.samples'
 
 ext {
-    arcgisVersion = '100.9.0'
+    arcgisVersion = '100.10.0-2992'
 }
 
 javafx {

network_analysis/closest-facility/src/main/java/com/esri/samples/closest_facility/ClosestFacilitySample.java

@@ -31,13 +31,14 @@
 import javafx.scene.layout.StackPane;
 import javafx.stage.Stage;
 
+import com.esri.arcgisruntime.ArcGISRuntimeEnvironment;
 import com.esri.arcgisruntime.concurrent.ListenableFuture;
 import com.esri.arcgisruntime.geometry.Point;
 import com.esri.arcgisruntime.geometry.SpatialReference;
 import com.esri.arcgisruntime.geometry.SpatialReferences;
 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.Graphic;
 import com.esri.arcgisruntime.mapping.view.GraphicsOverlay;
@@ -86,14 +87,21 @@ public void start(Stage stage) {
 
     try {
 
-      // create a map with streets basemap and add to view
-      ArcGISMap map = new ArcGISMap(Basemap.createStreets());
+      // authentication with an API key or named user is required to access basemaps and other location services
+      String yourAPIKey = System.getProperty("apiKey");
+      ArcGISRuntimeEnvironment.setApiKey(yourAPIKey);
+
+      // create a map with the streets basemap style
+      ArcGISMap map = new ArcGISMap(BasemapStyle.ARCGIS_STREETS);
+
+      // create a map view and set the map to it
       mapView = new MapView();
       mapView.setMap(map);
-      // add the mapview to stack pane
+
+      // add the map view to stack pane
       stackPane.getChildren().addAll(mapView);
 
-      // set view to be over San Diego
+      // set a viewpoint on the map view to be over San Diego
       mapView.setViewpoint(new Viewpoint(32.727, -117.1750, 40000));
 
       facilityGraphicsOverlay = new GraphicsOverlay();

network_analysis/find-route/build.gradle

@@ -6,7 +6,7 @@ plugins {
 group = 'com.esri.samples'
 
 ext {
-    arcgisVersion = '100.9.0'
+    arcgisVersion = '100.10.0-2992'
 }
 
 javafx {

network_analysis/find-route/src/main/java/com/esri/samples/find_route/FindRouteSample.java

@@ -35,13 +35,14 @@
 import javafx.scene.paint.Paint;
 import javafx.stage.Stage;
 
+import com.esri.arcgisruntime.ArcGISRuntimeEnvironment;
 import com.esri.arcgisruntime.geometry.Envelope;
 import com.esri.arcgisruntime.geometry.Geometry;
 import com.esri.arcgisruntime.geometry.Point;
 import com.esri.arcgisruntime.geometry.SpatialReference;
 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.view.DrawStatus;
 import com.esri.arcgisruntime.mapping.view.Graphic;
 import com.esri.arcgisruntime.mapping.view.GraphicsOverlay;
@@ -92,6 +93,10 @@ public void start(Stage stage) {
       stage.setScene(scene);
       stage.show();
 
+      // authentication with an API key or named user is required to access basemaps and other location services
+      String yourAPIKey = System.getProperty("apiKey");
+      ArcGISRuntimeEnvironment.setApiKey(yourAPIKey);
+
       // create a control panel
       VBox controlsVBox = new VBox(6);
       controlsVBox.setBackground(new Background(new BackgroundFill(Paint.valueOf("rgba(0,0,0,0.3)"), CornerRadii.EMPTY,
@@ -148,10 +153,10 @@ public void start(Stage stage) {
       // add buttons and direction list and label to the control panel
       controlsVBox.getChildren().addAll(directionsLabel, directionsList, findButton, resetButton);
 
-      // create a ArcGISMap with a streets basemap
-      ArcGISMap map = new ArcGISMap(Basemap.createStreets());
+      // create a map with the streets basemap style
+      ArcGISMap map = new ArcGISMap(BasemapStyle.ARCGIS_STREETS);
 
-      // set the ArcGISMap to be displayed in this view
+      // create a map view and set the map to it
       mapView = new MapView();
       mapView.setMap(map);
 

network_analysis/find-service-areas-for-multiple-facilities/build.gradle

@@ -6,7 +6,7 @@ plugins {
 group = 'com.esri.samples'
 
 ext {
-    arcgisVersion = '100.9.0'
+    arcgisVersion = '100.10.0-2992'
 }
 
 javafx {

network_analysis/find-service-areas-for-multiple-facilities/src/main/java/com/esri/samples/find_service_areas_for_multiple_facilities/FindServiceAreasForMultipleFacilitiesSample.java

@@ -31,14 +31,15 @@
 import javafx.scene.layout.StackPane;
 import javafx.stage.Stage;
 
+import com.esri.arcgisruntime.ArcGISRuntimeEnvironment;
 import com.esri.arcgisruntime.concurrent.ListenableFuture;
 import com.esri.arcgisruntime.data.ArcGISFeatureTable;
 import com.esri.arcgisruntime.data.QueryParameters;
 import com.esri.arcgisruntime.data.ServiceFeatureTable;
 import com.esri.arcgisruntime.layers.FeatureLayer;
 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.view.DrawStatus;
 import com.esri.arcgisruntime.mapping.view.DrawStatusChangedEvent;
 import com.esri.arcgisruntime.mapping.view.DrawStatusChangedListener;
@@ -73,6 +74,10 @@ public void start(Stage stage) {
     stage.setScene(scene);
     stage.show();
 
+    // authentication with an API key or named user is required to access basemaps and other location services
+    String yourAPIKey = System.getProperty("apiKey");
+    ArcGISRuntimeEnvironment.setApiKey(yourAPIKey);
+
     // create button
     Button findServiceAreasButton = new Button("Find Service Areas");
     findServiceAreasButton.setMaxWidth(150);
@@ -82,10 +87,10 @@ public void start(Stage stage) {
     ProgressIndicator progressIndicator = new ProgressIndicator();
     progressIndicator.setVisible(false);
 
-    // create an ArcGISMap with a streets basemap
-    ArcGISMap map = new ArcGISMap(Basemap.createLightGrayCanvas());
+    // create a map with the light gray basemap style
+    ArcGISMap map = new ArcGISMap(BasemapStyle.ARCGIS_LIGHT_GRAY);
 
-    // set the ArcGISMap to be displayed in the map view
+    // create a map view and set the map to it
     mapView = new MapView();
     mapView.setMap(map);
 
@@ -112,7 +117,7 @@ public void start(Stage stage) {
     // set the renderer of the facilities feature layer to use the facilities symbol
     facilitiesFeatureLayer.setRenderer(new SimpleRenderer(facilitySymbol));
 
-    // add the facilities feature layer to the map
+    // add the facilities feature layer to the map's operational layers
     map.getOperationalLayers().add(facilitiesFeatureLayer);
 
     // wait for the facilities feature layer to load

network_analysis/routing-around-barriers/build.gradle

@@ -6,7 +6,7 @@ plugins {
 group = 'com.esri.samples'
 
 ext {
-    arcgisVersion = '100.9.0'
+    arcgisVersion = '100.10.0-2992'
 }
 
 javafx {

network_analysis/routing-around-barriers/src/main/java/com/esri/samples/routing_around_barriers/RoutingAroundBarriersController.java

@@ -32,14 +32,15 @@
 import javafx.scene.input.MouseButton;
 import javafx.scene.input.MouseEvent;
 
+import com.esri.arcgisruntime.ArcGISRuntimeEnvironment;
 import com.esri.arcgisruntime.concurrent.ListenableFuture;
 import com.esri.arcgisruntime.geometry.Geometry;
 import com.esri.arcgisruntime.geometry.GeometryEngine;
 import com.esri.arcgisruntime.geometry.Point;
 import com.esri.arcgisruntime.geometry.Polygon;
 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.Graphic;
 import com.esri.arcgisruntime.mapping.view.GraphicsOverlay;
@@ -83,9 +84,15 @@ public class RoutingAroundBarriersController {
 
   @FXML
   public void initialize() {
-    // add a map with the streets basemap to the map view, centered on San Diego
-    ArcGISMap map = new ArcGISMap(Basemap.createStreets());
+    // authentication with an API key or named user is required to access basemaps and other location services
+    String yourAPIKey = System.getProperty("apiKey");
+    ArcGISRuntimeEnvironment.setApiKey(yourAPIKey);
+
+    // create a map with the streets basemap style and set it to the map view
+    ArcGISMap map = new ArcGISMap(BasemapStyle.ARCGIS_STREETS);
     mapView.setMap(map);
+
+    // set a viewpoint on the map view
     mapView.setViewpoint(new Viewpoint(32.727, -117.1750, 40000));
 
     // add the graphics overlays to the map view