merged master

Author: tschie

src/main/java/com/esri/samples/displayinformation/add_graphics_with_renderer/AddGraphicsWithRenderer.png

@@ -1,8 +1,8 @@
 <h1>Add Graphics with Renderer</h1>
 
 <p>Demonstrates how to add graphics to a graphics overlay and display them with a renderer. A renderer allows you to 
-change the style of all graphics in an overlay by only changing one copy of the symbol. A renderer will only change 
-the symbol for graphics that do not specify their own symbol.</p>
+change the style of all graphics in an overlay by only changing one copy of the symbol. A renderer will only effect 
+graphics that do not specify their own symbol.</p>
 
 <p><img src="AddGraphicsWithRenderer.png"/></p>
 

src/main/java/com/esri/samples/displayinformation/add_graphics_with_renderer/README.md

@@ -1,4 +1,4 @@
-<h1>Display Callout</h1>
+<h1>Show Callout</h1>
 
 <p>Demonstrates how to show coordinates for a clicked location on an ArcGISMap in a Callout.</p>
 

src/main/java/com/esri/samples/displayinformation/show_callout/README.md

@@ -0,0 +1,217 @@
+/*
+ * Copyright 2016 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.samples.featurelayers.feature_collection_layer;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import javafx.application.Application;
+import javafx.scene.Scene;
+import javafx.scene.layout.StackPane;
+import javafx.stage.Stage;
+
+import com.esri.arcgisruntime.data.Feature;
+import com.esri.arcgisruntime.data.FeatureCollection;
+import com.esri.arcgisruntime.data.FeatureCollectionTable;
+import com.esri.arcgisruntime.data.Field;
+import com.esri.arcgisruntime.geometry.GeometryType;
+import com.esri.arcgisruntime.geometry.Point;
+import com.esri.arcgisruntime.geometry.PolygonBuilder;
+import com.esri.arcgisruntime.geometry.PolylineBuilder;
+import com.esri.arcgisruntime.geometry.SpatialReference;
+import com.esri.arcgisruntime.geometry.SpatialReferences;
+import com.esri.arcgisruntime.layers.FeatureCollectionLayer;
+import com.esri.arcgisruntime.mapping.ArcGISMap;
+import com.esri.arcgisruntime.mapping.Basemap;
+import com.esri.arcgisruntime.mapping.view.MapView;
+import com.esri.arcgisruntime.symbology.SimpleFillSymbol;
+import com.esri.arcgisruntime.symbology.SimpleLineSymbol;
+import com.esri.arcgisruntime.symbology.SimpleMarkerSymbol;
+import com.esri.arcgisruntime.symbology.SimpleMarkerSymbol.Style;
+import com.esri.arcgisruntime.symbology.SimpleRenderer;
+
+public class FeatureCollectionLayerSample extends Application {
+
+  private MapView mapView;
+
+  private static final SpatialReference WGS84 = SpatialReferences.getWgs84();
+
+  @Override
+  public void start(Stage stage) throws Exception {
+
+    try {
+      // create stack pane and application scene
+      StackPane stackPane = new StackPane();
+      Scene scene = new Scene(stackPane);
+
+      // set title, size, and add scene to stage
+      stage.setTitle("Feature Collection Layer Sample");
+      stage.setWidth(800);
+      stage.setHeight(700);
+      stage.setScene(scene);
+      stage.show();
+
+      // create amp and set it to be displayed in this view
+      ArcGISMap map = new ArcGISMap(Basemap.createOceans());
+      mapView = new MapView();
+      mapView.setMap(map);
+
+      // set initial location for view
+      mapView.setViewpointCenterAsync(new Point(-79.497238, 8.849289, WGS84), 1000000);
+
+      // create feature collection and add to the map as a layer
+      FeatureCollection featureCollection = new FeatureCollection();
+      FeatureCollectionLayer featureCollectionLayer = new FeatureCollectionLayer(featureCollection);
+      map.getOperationalLayers().add(featureCollectionLayer);
+
+      // add point, line, and polygon geometry to feature collection
+      createPointTable(featureCollection);
+      createPolylineTable(featureCollection);
+      createPolygonTables(featureCollection);
+
+      // add the map view to stack pane
+      stackPane.getChildren().addAll(mapView);
+    } catch (Exception e) {
+      // on any error, display the stack trace.
+      e.printStackTrace();
+    }
+  }
+
+  /**
+   * Creates a Point Feature Collection Table with one Point and adds it to the Feature collection that was passed.
+   * 
+   * @param featureCollection that the point Feature Collection Table will be added to
+   */
+  private void createPointTable(FeatureCollection featureCollection) {
+
+    // defines the schema for the geometry's attribute
+    List<Field> pointFields = new ArrayList<>();
+    pointFields.add(Field.createString("Place", "Place Name", 50));
+
+    // a feature collection table that creates point geometry
+    FeatureCollectionTable pointsTable = new FeatureCollectionTable(pointFields, GeometryType.POINT, WGS84);
+
+    // set a default symbol for features in the collection table
+    SimpleMarkerSymbol markerSymbol = new SimpleMarkerSymbol(Style.TRIANGLE, 0xFFFF0000, 18);
+    SimpleRenderer renderer = new SimpleRenderer(markerSymbol);
+    pointsTable.setRenderer(renderer);
+
+    // add feature collection table to feature collection
+    featureCollection.getTables().add(pointsTable);
+
+    // create feature using the collection table by passing an attribute and geometry
+    Map<String, Object> attributes = new HashMap<>();
+    attributes.put(pointFields.get(0).getName(), "Current Location");
+    Point point = new Point(-79.497238, 8.849289, WGS84);
+    Feature addedFeature = pointsTable.createFeature(attributes, point);
+
+    // add feature to collection table
+    pointsTable.addFeatureAsync(addedFeature);
+  }
+
+  /**
+   * Creates a PolyLine Feature Collection Table with one PolyLine and adds it to the Feature collection that was passed.
+   * 
+   * @param featureCollection that the polyline Feature Collection Table will be added to
+   */
+  private void createPolylineTable(FeatureCollection featureCollection) {
+
+    // defines the schema for the geometry's attribute
+    List<Field> polylineFields = new ArrayList<>();
+    polylineFields.add(Field.createString("Boundary", "Boundary Name", 50));
+
+    // a feature collection table that creates polyline geometry
+    FeatureCollectionTable polylineTable = new FeatureCollectionTable(polylineFields, GeometryType.POLYLINE, WGS84);
+
+    // set a default symbol for features in the collection table
+    SimpleLineSymbol lineSymbol = new SimpleLineSymbol(SimpleLineSymbol.Style.DASH, 0xFF00FF00, 3);
+    SimpleRenderer renderer = new SimpleRenderer(lineSymbol);
+    polylineTable.setRenderer(renderer);
+
+    // add feature collection table to feature collection
+    featureCollection.getTables().add(polylineTable);
+
+    // create feature using the collection table by passing an attribute and geometry
+    Map<String, Object> attributes = new HashMap<>();
+    attributes.put(polylineFields.get(0).getName(), "AManAPlanACanalPanama");
+    PolylineBuilder builder = new PolylineBuilder(WGS84);
+    builder.addPoint(new Point(-79.497238, 8.849289, WGS84));
+    builder.addPoint(new Point(-80.035568, 9.432302, WGS84));
+    Feature addedFeature = polylineTable.createFeature(attributes, builder.toGeometry());
+
+    // add feature to collection table
+    polylineTable.addFeatureAsync(addedFeature);
+  }
+
+  /**
+   * Creates a Polygon Feature Collection Table with one Polygon and adds it to the Feature collection that was passed.
+   * 
+   * @param featureCollection that the polygon Feature Collection Table will be added to
+   */
+  private void createPolygonTables(FeatureCollection featureCollection) {
+
+    // defines the schema for the geometry's attribute
+    List<Field> polygonFields = new ArrayList<>();
+    polygonFields.add(Field.createString("Area", "Area Name", 50));
+
+    // a feature collection table that creates polygon geometry
+    FeatureCollectionTable polygonTable = new FeatureCollectionTable(polygonFields, GeometryType.POLYGON, WGS84);
+
+    // set a default symbol for features in the collection table
+    SimpleLineSymbol lineSymbol = new SimpleLineSymbol(SimpleLineSymbol.Style.SOLID, 0xFF0000FF, 2);
+    SimpleFillSymbol fillSymbol = new SimpleFillSymbol(SimpleFillSymbol.Style.DIAGONAL_CROSS, 0xFF00FFFF, lineSymbol);
+    SimpleRenderer renderer = new SimpleRenderer(fillSymbol);
+    polygonTable.setRenderer(renderer);
+
+    // add feature collection table to feature collection
+    featureCollection.getTables().add(polygonTable);
+
+    // create feature using the collection table by passing an attribute and geometry
+    Map<String, Object> attributes = new HashMap<>();
+    attributes.put(polygonFields.get(0).getName(), "Restricted area");
+    PolygonBuilder builder = new PolygonBuilder(WGS84);
+    builder.addPoint(new Point(-79.497238, 8.849289, WGS84));
+    builder.addPoint(new Point(-79.337936, 8.638903, WGS84));
+    builder.addPoint(new Point(-79.11409, 8.895422, WGS84));
+    Feature addedFeature = polygonTable.createFeature(attributes, builder.toGeometry());
+
+    // add feature to collection table
+    polygonTable.addFeatureAsync(addedFeature);
+  }
+
+  /**
+   * Stops and releases all resources used in application.
+   */
+  @Override
+  public void stop() throws Exception {
+
+    if (mapView != null) {
+      mapView.dispose();
+    }
+  }
+
+  /**
+   * Opens and runs application.
+   *
+   * @param args arguments passed to this application
+   */
+  public static void main(String[] args) {
+
+    Application.launch(args);
+  }
+}

src/main/java/com/esri/samples/featurelayers/feature_collection_layer/FeatureCollectionLayer.PNG

@@ -0,0 +1,36 @@
+<h1>Feature Collection Layer</h1>
+
+<p>Demonstrates how to create a new Feature Collection with a Point, Polyline, and Polygon Feature Collection Table. The Feature Collection is then displayed on the ArcGISMap as a Layer.</p>
+
+<p><img src="FeatureCollectionLayer.PNG"/></p>
+
+<h2>How it works</h2>
+
+<p>To display a <code>FeatureCollection</code> as a <code>FeatureCollectionLayer</code> on an <code>ArcGISMap</code> using different <code>FeatureCollectionTable</code>s:</p>
+
+<ol>
+    <li>Create a feature collection layer using a new feature collection, <code>new FeatureCollectionLayer(featureCollection)</code></li>
+    <li>The layer is then added to the map, <code>ArcGISap.getOperationalLayers().add(featureCollectionLayer)</code>.</li>
+    <li>A feature collection table is then created for the <code>GeometryType</code>s <code>Point</code> <code>Polyline</code> <code>Polygon</code>, <code>new FeatureCollectionTable(fields, geometryType, spatialRefernce)</code></li>
+      <ol>
+        <li><code>Field</code>s is a list of the feature's attributes, which this one defines it's name.</li>
+      </ol>
+    <li>A <code>SimpleRenderer</code> is then assigned to each table which will render any <code>Feature</code>s from that table using the <code>Symbol</code> that was set.</li>
+    <li>The table is then added to the feature collection, <code>FeatureCollection.getTables().add(featureCollectionTable)</code>.</li>
+    <li>To create a feature from the feature collection table use the createFeature method passing an attribute and geometry for that feature, <code>FeatureCollectionTable.createFeature(attributes, geometry)</code>.</li>
+    <li>Add new feature to the table,  <code>FeatureCollectionTable.addFeatureAsync(feature)</code>.</li>
+</ol>
+
+<h2>Features</h2>
+
+<ul>
+    <li>FeatureCollection</li>
+    <li>FeatureCollectionLayer</li>
+    <li>FeatureCollectionTable</li>
+    <li>Feature</li>
+    <li>Field</li>
+    <li>SimpleFillSymbol</li>
+    <li>SimpleLineSymbol</li>
+    <li>SimpleMarkerSymbol</li>
+    <li>SimpleRenderer</li>
+</ul>

src/main/java/com/esri/samples/featurelayers/feature_collection_layer/FeatureCollectionLayerSample.java

@@ -0,0 +1,106 @@
+/*
+ * Copyright 2016 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.samples.featurelayers.feature_layer_geodatabase;
+
+import java.io.File;
+
+import javafx.application.Application;
+import javafx.scene.Scene;
+import javafx.scene.layout.StackPane;
+import javafx.stage.Stage;
+
+import com.esri.arcgisruntime.data.Geodatabase;
+import com.esri.arcgisruntime.data.GeodatabaseFeatureTable;
+import com.esri.arcgisruntime.layers.FeatureLayer;
+import com.esri.arcgisruntime.mapping.ArcGISMap;
+import com.esri.arcgisruntime.mapping.Basemap;
+import com.esri.arcgisruntime.mapping.view.MapView;
+
+public class FeatureLayerGeodatabase extends Application {
+
+  private MapView mapView;
+
+  @Override
+  public void start(Stage stage) throws Exception {
+
+    try {
+
+      // create stack pane and JavaFX app scene
+      StackPane stackPane = new StackPane();
+      Scene fxScene = new Scene(stackPane);
+
+      // set title, size, and add JavaFX scene to stage
+      stage.setTitle("Feature Layer Geodatabase Sample");
+      stage.setWidth(800);
+      stage.setHeight(700);
+      stage.setScene(fxScene);
+      stage.show();
+
+      // create map and add to view
+      ArcGISMap map = new ArcGISMap(Basemap.createStreets());
+      mapView = new MapView();
+      mapView.setMap(map);
+
+      // create geodatabase from local resource
+      String geodatabaseUrl = new File("samples-data/los_angeles/LA_Trails.geodatabase").getAbsolutePath();
+      Geodatabase geodatabase = new Geodatabase(geodatabaseUrl);
+      geodatabase.addDoneLoadingListener(() -> {
+        // access the geodatabase's feature table Trailheads
+        GeodatabaseFeatureTable geodatabaseFeatureTable = geodatabase.getGeodatabaseFeatureTable("Trailheads");
+
+        // create a layer from the geodatabase feature table above and add to map
+        FeatureLayer featureLayer = new FeatureLayer(geodatabaseFeatureTable);
+        featureLayer.addDoneLoadingListener(() -> {
+          // set viewpoint to the location of feature layer's features
+          mapView.setViewpointCenterAsync(featureLayer.getFullExtent().getCenter(), 1000000);
+        });
+        // display feature layer to the map view
+        map.getOperationalLayers().add(featureLayer);
+      });
+      // load geodatabase
+      geodatabase.loadAsync();
+
+      // add the map view to stack pane
+      stackPane.getChildren().addAll(mapView);
+    } catch (Exception e) {
+      // on any error, display the stack trace.
+      e.printStackTrace();
+    }
+  }
+
+  /**
+   * Stops and releases all resources used in application.
+   */
+  @Override
+  public void stop() {
+
+    if (mapView != null) {
+      mapView.dispose();
+    }
+  }
+
+  /**
+   * Opens and runs application.
+   *
+   * @param args arguments passed to this application
+   */
+  public static void main(String[] args) {
+
+    Application.launch(args);
+  }
+
+}