Update Graphics

View on GitHub

Demonstrates how to identify a Graphic and change it's symbol, attributes, and geometry.

Geometry explains the graphic's location on a map, a symbol controls how a graphic will be displayed to a map, and the attributes help store information about the graphic in a key value pair.

The following image is the after state of changing the purple triangle graphic's location and the blue diamond graphic's symbol from a triangle.

How it works

How to change a Graphic's Symbol, attributes, and geometry:

1. Create aGraphicsOverlay and attach it to the MapView.
2. Create Graphics using a Point and SimpleMarkerSymbol.
   • point gives the x,y-coordinate location of where SimpleMarkerSymbol will be located
3. Add two Attributes to each graphic,Graphic.getAttributes().put() .
   • first attribute key NAME and value the name for that graphic
   • second attribute key DESCRIPTION and value a description for that graphic
4. Add graphics to the graphics overlay, GraphicsOverlay.getGraphics().add(graphic).
5. Identify graphic that user has selected using MapView.identifyGraphicsOverlayAsync(GraphicsOverlay,Point2D, tolerance, maximumResults).
   • graphics overlay, the one that was created above
   • point2D, from the user mouse click
   • tolerance, places buffer around the point2d
   • maxiumum result, sets the maximum amount of graphics to return near that point2d
6. Select graphic that user selected.
   • the identify will return a list of graphics
   • go through that list and set each graphic's selection to true, Graphic.setSelected()
7. To update graphic's location.
   • create a point from the user mouse click, MapView.screenToLocation()
   • set that point as the selected graphic's new geometry, Graphic.setGeometry()
8. To update graphic's attribute.
   • get attrubutes of selected graphic and set DESCRIPTION key, Graphic.getAttributes().put("DESCRIPTION",)
9. To update graphic's symbol.
   • get symbol from the drop down box
   • assign that symbol to the selected graphic, Graphic.setSymbol()

Code

UpdateGraphicsSample.java

/*
 * Copyright 2017 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.displayinformation.update_graphics;

import java.util.ArrayList;
import java.util.List;
import java.util.Optional;

import javafx.application.Application;
import javafx.geometry.Insets;
import javafx.geometry.Point2D;
import javafx.geometry.Pos;
import javafx.scene.Scene;
import javafx.scene.control.Alert;
import javafx.scene.control.Button;
import javafx.scene.control.ComboBox;
import javafx.scene.control.Label;
import javafx.scene.control.TextInputDialog;
import javafx.scene.input.MouseButton;
import javafx.scene.layout.StackPane;
import javafx.scene.layout.VBox;
import javafx.stage.Stage;

import com.esri.arcgisruntime.concurrent.ListenableFuture;
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.view.Graphic;
import com.esri.arcgisruntime.mapping.view.GraphicsOverlay;
import com.esri.arcgisruntime.mapping.view.IdentifyGraphicsOverlayResult;
import com.esri.arcgisruntime.mapping.view.MapView;
import com.esri.arcgisruntime.symbology.SimpleMarkerSymbol;

public class UpdateGraphicsSample extends Application {

  private boolean isUpdateLocationActive;
  private List<SimpleMarkerSymbol> markers;

  private MapView mapView;
  private Graphic selectedGraphic;
  private GraphicsOverlay graphicsOverlay;
  private ListenableFuture<IdentifyGraphicsOverlayResult> identifyGraphics;

  // colors for symbols
  private static final int PURPLE = 0xFF800080;
  private static final int BLUE = 0xFF0000FF;
  private static final int RED = 0xFFFF0000;
  private static final int GREEN = 0xFF00FF00;

  @Override
  public void start(Stage stage) throws Exception {

    try {
      // create stack pane and application scene
      StackPane stackPane = new StackPane();
      Scene scene = new Scene(stackPane);
      scene.getStylesheets().add(getClass().getResource("/css/style.css").toExternalForm());

      // set title, size, and add scene to stage
      stage.setTitle("Update Graphics Sample");
      stage.setWidth(800);
      stage.setHeight(700);
      stage.setScene(scene);
      stage.show();

      // create a control panel
      VBox vBoxControl = new VBox(6);
      vBoxControl.setMaxSize(180, 150);
      vBoxControl.getStyleClass().add("panel-region");

      // create buttons for user interaction
      Button updateLocationButton = new Button("Update Location");
      Button updateDescriptionButton = new Button("Update Description");
      updateLocationButton.setMaxWidth(Double.MAX_VALUE);
      updateDescriptionButton.setMaxWidth(Double.MAX_VALUE);
      updateLocationButton.setDisable(true);
      updateDescriptionButton.setDisable(true);

      // when clicked allow user to move graphic's location
      updateLocationButton.setOnAction(e -> {
        if (selectedGraphic.isSelected()) {
          isUpdateLocationActive = true;
        }
      });

      updateDescriptionButton.setOnAction(e -> {
        if (selectedGraphic.isSelected()) {
          // get attributes from selected graphic
          java.util.Map<String, Object> attributes = selectedGraphic.getAttributes();

          // create input dialog
          TextInputDialog dialog = new TextInputDialog();
          dialog.setTitle(attributes.get("NAME").toString());
          dialog.setGraphic(null);
          dialog.setHeaderText(attributes.get("DESCRIPTION").toString());
          dialog.setContentText("New Description");

          // set the graphic's description is text entered
          Optional<String> result = dialog.showAndWait();
          result.ifPresent(text -> {
            if (!text.isEmpty()) {
              attributes.put("DESCRIPTION", text);
            }
          });
        }
      });

      // create section for combo box
      Label symbolLabel = new Label("Update Symbol:");
      symbolLabel.getStyleClass().add("panel-label");
      ComboBox<String> symbolBox = new ComboBox<>();
      symbolBox.getItems().addAll("CIRCLE", "TRIANGLE", "CROSS", "DIAMOND");
      symbolBox.getSelectionModel().selectFirst();
      symbolBox.setMaxWidth(Double.MAX_VALUE);
      symbolBox.setDisable(true);

      // set the symbol of the graphic
      symbolBox.showingProperty().addListener((obs, wasShowing, isShowing) -> {
        if (selectedGraphic.isSelected() && !isShowing) {
          selectedGraphic.setSymbol(markers.get(symbolBox.getSelectionModel().getSelectedIndex()));
        }
      });

      // add label, dropdown and buttons to the control panel
      vBoxControl.getChildren().addAll(updateLocationButton, updateDescriptionButton, symbolLabel, symbolBox);

      // create a graphics overlay
      graphicsOverlay = new GraphicsOverlay();
      selectedGraphic = new Graphic();

      // create a ArcGISMap with basemap light gray canvas
      ArcGISMap map = new ArcGISMap(Basemap.Type.LIGHT_GRAY_CANVAS, 56.075844, -2.681572, 13);

      // enable buttons when map view is done loading
      map.addDoneLoadingListener(() -> {
        if (map.getLoadStatus() == LoadStatus.LOADED) {
          symbolBox.setDisable(false);
          updateLocationButton.setDisable(false);
          updateDescriptionButton.setDisable(false);
        } else {
          Alert alert = new Alert(Alert.AlertType.ERROR, "Map Failed to Load!");
          alert.show();
        }
      });

      // create a map view and set the map to it
      mapView = new MapView();
      mapView.setMap(map);

      // add graphics overlay to the map view
      mapView.getGraphicsOverlays().add(graphicsOverlay);

      // create default graphics for graphics overlay
      createGraphics();

      mapView.setOnMouseClicked(e -> {
        if (e.getButton() == MouseButton.PRIMARY) {
          // clear any selected graphic
          graphicsOverlay.clearSelection();

          // create a point from location clicked
          Point2D mapViewPoint = new Point2D(e.getX(), e.getY());

          if (isUpdateLocationActive) {
            // add new location to selected graphic
            Point mapPoint = mapView.screenToLocation(mapViewPoint);
            selectedGraphic.setGeometry(mapPoint);
            isUpdateLocationActive = false;
          } else {
            // identify the graphic that was selected
            identifyGraphics = mapView.identifyGraphicsOverlayAsync(graphicsOverlay, mapViewPoint, 10, false);

            identifyGraphics.addDoneListener(() -> {
              try {
                if (!identifyGraphics.get().getGraphics().isEmpty()) {
                  // store the selected graphic
                  selectedGraphic = identifyGraphics.get().getGraphics().get(0);
                  selectedGraphic.setSelected(true);
                  String style = ((SimpleMarkerSymbol) selectedGraphic.getSymbol()).getStyle().toString();
                  symbolBox.getSelectionModel().select(style);
                }
              } catch (Exception x) {
                // on any error, display the stack trace
                x.printStackTrace();
              }
            });
          }
        }
      });

      // add the map view and control panel to stack pane
      stackPane.getChildren().addAll(mapView, vBoxControl);
      StackPane.setAlignment(vBoxControl, Pos.TOP_LEFT);
      StackPane.setMargin(vBoxControl, new Insets(10, 0, 0, 10));
    } catch (Exception e) {
      // on any error, display the stack trace
      e.printStackTrace();
    }
  }

  /**
   * Creates four Graphics with a location, a symbol, and two attributes. Then
   * adds those Graphics to the GraphicsOverlay.
   */
  private void createGraphics() {

    Graphic graphic;
    // create spatial reference for the points
    SpatialReference spatialReference = SpatialReference.create(4326);

    // create points to place markers
    List<Point> points = new ArrayList<>();
    points.add(new Point(-2.641, 56.077, spatialReference));
    points.add(new Point(-2.669, 56.058, spatialReference));
    points.add(new Point(-2.718, 56.060, spatialReference));
    points.add(new Point(-2.720, 56.073, spatialReference));

    // create simple marker symbols for the points
    markers = new ArrayList<>();
    markers.add(new SimpleMarkerSymbol(SimpleMarkerSymbol.Style.CIRCLE, RED, 10));
    markers.add(new SimpleMarkerSymbol(SimpleMarkerSymbol.Style.TRIANGLE, PURPLE, 10));
    markers.add(new SimpleMarkerSymbol(SimpleMarkerSymbol.Style.CROSS, GREEN, 10));
    markers.add(new SimpleMarkerSymbol(SimpleMarkerSymbol.Style.DIAMOND, BLUE, 10));

    // create a list of names for graphics
    List<String> names = new ArrayList<>();
    names.add("LAMB");
    names.add("CANTY BAY");
    names.add("NORTH BERWICK");
    names.add("FIDRA");

    // create a list of descriptions for graphics
    List<String> descriptions = new ArrayList<>();
    descriptions.add("Just opposite of Bass Rock.");
    descriptions.add("100m long and 50m wide.");
    descriptions.add("Lighthouse in northern section.");
    descriptions.add("Also known as Barley Farmstead.");

    // create four graphics with attributes and add to graphics overlay
    for (int i = 0; i < 4; i++) {
      graphic = new Graphic(points.get(i), markers.get(i));
      graphic.getAttributes().put("NAME", names.get(i));
      graphic.getAttributes().put("DESCRIPTION", descriptions.get(i));
      graphicsOverlay.getGraphics().add(graphic);
    }
  }

  /**
   * 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);
  }

}