Add graphics to a map view

You can use graphics to display objects on top of the data in your map view while your app is running. A graphic is a type of geoelement that has a shape (geometry) and attributes. A graphic can have its own symbol, or can be displayed using a renderer. Graphics are added to a graphics overlay for display in the map view.

Graphics displayed on a map view.

Graphics and graphics overlays allow you to do things like:

  • Show updated locations for objects in the map view, such as moving vehicles.
  • Display results from an analysis, geocoding, or routing operation.
  • Allow the user to draw temporary sketches on top of the map.
  • Store user input, such as a set of route stops to visit.
  • Show ad hoc text labels to describe things on the map.

How graphics work

A map view has a graphics overlay collection that may contain zero or more graphics overlays. Each graphics overlay manages a collection of graphics that display on top of all data inside the map view. The graphics you add to a graphics overlay can have a mix of geometry types and attribute fields. Because they offer so much flexibility, graphics and graphics overlays are ideal for working with temporary geoelements that you need to display as your app runs.

Graphics in map views and scene views

The pattern for working with graphics is the same whether in a map view or scene view. In either case, the geoview has a collection of graphics overlays that contain a collection of graphics. When working with a scene view, additional 3D properties and symbol types are available that are not applicable when working with a map view.

For more more information about working with graphics in 3D, see Add graphics to a scene view.

Graphics overlays

A GraphicsOverlay is a container for temporary graphics that display in your geoview. Graphics you add to graphics overlays are created at run time and are not persisted when the application closes.

The following code shows how to create a new graphics overlay and add it to your map view.

                                                                                                              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
// --- Add graphics to map view ---


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

// create a map point for the Santa Monica pier
Point pierPoint = new Point(-118.4978, 34.0086, SpatialReferences.getWgs84());

// create a red (0xFFFF0000) circle simple marker symbol
SimpleMarkerSymbol redCircleSymbol = new SimpleMarkerSymbol(SimpleMarkerSymbol.Style.CIRCLE, 0xFFFF0000, 10);

// create a graphic from the point and symbol
Graphic pierGraphic = new Graphic(pierPoint, redCircleSymbol);

// add the graphic to the graphics overlay
graphicsOverlay.getGraphics().add(pierGraphic);

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



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

// add graphics overlay to the geo view
geoView.getGraphicsOverlays().add(graphicsOverlay);



// create the geographic point
Point pierPoint = new Point(-118.4978, 34.0086, 500, SpatialReferences.getWgs84());

// create text symbol
TextSymbol pierTextSymbol =
    new TextSymbol(
        10, "Santa Monica Pier", Color.argb(255, 255, 0, 0),
        HorizontalAlignment.LEFT, VerticalAlignment.BOTTOM);

// create a graphic from the point and symbol
Graphic pierGraphic = new Graphic(pierPoint, pierTextSymbol);



// identify graphics on the graphics overlay
final ListenableFuture<IdentifyGraphicsOverlayResult> identifyFuture = mGeoView.identifyGraphicsOverlayAsync(overlay,
    screenPoint, 10, false, 10);

identifyFuture.addDoneListener(new Runnable() {
  @Override
  public void run() {
    try {
      // get the list of graphics returned by identify
      List<Graphic> identifiedGraphics = identifyFuture.get().getGraphics();

      // iterate the graphics
      for (Graphic graphic : identifiedGraphics) {
        // Use identified graphics as required, for example access attributes or geometry, select, build a table, etc...
        graphic.setSelected(true);
      }
    } catch (InterruptedException | ExecutionException ex) {
      dealWithException(ex); // must deal with checked exceptions
    }

  }
});



// iterate a set of graphics (from an identify operation, for example)
for (Graphic graphic : identifiedGraphics) {
  // select each graphic
  graphic.setSelected(true);
}



// create a point from location clicked
geoView.setOnMouseClicked(e -> {
  if (e.getButton() == MouseButton.PRIMARY) {
    Point2D geoViewPoint = new Point2D(e.getX(), e.getY());
    // add new location to selected graphic
    Point geoPoint = geoView.screenToLocation(geoViewPoint);
    selectedGraphic.setGeometry(geoPoint);
  }
});


//-- Add graphics to a scene view


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

// create a point for the Santa Monica pier
Point pierPoint = new Point(-118.4978, 34.0086, SpatialReferences.getWgs84());

// create a red (0xFFFF0000) sphere marker symbol
SimpleMarkerSceneSymbol redSphereSymbol = new SimpleMarkerSceneSymbol(SimpleMarkerSceneSymbol.Style.SPHERE, 0xFFFF0000, 500,
  500, 500, SceneSymbol.AnchorPosition.CENTER);

// create a graphic from the point and symbol
Graphic pierGraphic = new Graphic(pierPoint, redSphereSymbol);

// add the graphic to the graphics overlay
graphicsOverlay.getGraphics().add(pierGraphic);

// add graphics overlay to the scene view's graphics overlay collection
sceneView.getGraphicsOverlays().add(graphicsOverlay);

Unlike a feature layer, which always contains features of a single geometry type, a graphics overlay can contain graphics with a variety of geometry types (a mix of points, lines, and polygons, in other words). A feature layer has a consistent schema (the same set of attributes), while graphics in a graphics overlay can each have a distinct set of attributes.

For more information and a description of when to use each, see the Features and graphics topic.

Graphics

Graphics are created at run time and only persist for as long as the app is running. You can create them to show geocode candidates, routes, results from analysis operations, and so on. They are also commonly used to show input from the user, such as a click or touch on the display.

A Graphic uses the following to represent an object on the map view:

  • Geometry: a point, line, or polygon that represents the object's location and shape.
  • Attributes: a collection of one or more pairs of fields and values that describe the object.
  • Symbol: an object that controls the visual representation of the graphic's geometry on the display.

Draw order (z-index)

A graphic's z-index defines the draw order of that graphic within its graphics overlay. It is primarily intended for use when working with graphics in a 2D map view.

If the z-index is not set, the graphics will render in the order in which they were added to the graphics overlay, the first graphic added is rendered lowermost and subsequent graphics on top. In rare cases, the rendering algorithm may change the display order to provide more efficient rendering. If ordering is important, set the z-index explicitly on each graphic. You can also place graphics of the same geometry type in their own graphics overlay and manage the order of the graphics overlays in the map view.

Work with graphics

Because they are both geoelements, you can work with graphics in much the same way as you would with features. Graphics can be symbolized using attribute values, identified using a tap or click from the user, and selected in the display. You can update graphics' geometry to move them on the view and update their attributes to reflect their current state. Unlike features, graphics are not persisted when the app closes.

Add a graphics overlay and a graphic

The following example shows how to create a graphics overlay, add a single graphic, and add the overlay to a map view.

  1. Create a new GraphicsOverlay.

  2. Create a Geometry to define the graphic's shape and geographic location.

  3. Create a symbol to display the graphic.

  4. Create a new Graphic using the geometry and symbol.

    • Optionally, you can define a set of attributes for the graphic.
  5. Add the graphic to the graphics overlay.

  6. Add the graphics overlay to the map view.

                                                                                                              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
// --- Add graphics to map view ---


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

// create a map point for the Santa Monica pier
Point pierPoint = new Point(-118.4978, 34.0086, SpatialReferences.getWgs84());

// create a red (0xFFFF0000) circle simple marker symbol
SimpleMarkerSymbol redCircleSymbol = new SimpleMarkerSymbol(SimpleMarkerSymbol.Style.CIRCLE, 0xFFFF0000, 10);

// create a graphic from the point and symbol
Graphic pierGraphic = new Graphic(pierPoint, redCircleSymbol);

// add the graphic to the graphics overlay
graphicsOverlay.getGraphics().add(pierGraphic);

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



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

// add graphics overlay to the geo view
geoView.getGraphicsOverlays().add(graphicsOverlay);



// create the geographic point
Point pierPoint = new Point(-118.4978, 34.0086, 500, SpatialReferences.getWgs84());

// create text symbol
TextSymbol pierTextSymbol =
    new TextSymbol(
        10, "Santa Monica Pier", Color.argb(255, 255, 0, 0),
        HorizontalAlignment.LEFT, VerticalAlignment.BOTTOM);

// create a graphic from the point and symbol
Graphic pierGraphic = new Graphic(pierPoint, pierTextSymbol);



// identify graphics on the graphics overlay
final ListenableFuture<IdentifyGraphicsOverlayResult> identifyFuture = mGeoView.identifyGraphicsOverlayAsync(overlay,
    screenPoint, 10, false, 10);

identifyFuture.addDoneListener(new Runnable() {
  @Override
  public void run() {
    try {
      // get the list of graphics returned by identify
      List<Graphic> identifiedGraphics = identifyFuture.get().getGraphics();

      // iterate the graphics
      for (Graphic graphic : identifiedGraphics) {
        // Use identified graphics as required, for example access attributes or geometry, select, build a table, etc...
        graphic.setSelected(true);
      }
    } catch (InterruptedException | ExecutionException ex) {
      dealWithException(ex); // must deal with checked exceptions
    }

  }
});



// iterate a set of graphics (from an identify operation, for example)
for (Graphic graphic : identifiedGraphics) {
  // select each graphic
  graphic.setSelected(true);
}



// create a point from location clicked
geoView.setOnMouseClicked(e -> {
  if (e.getButton() == MouseButton.PRIMARY) {
    Point2D geoViewPoint = new Point2D(e.getX(), e.getY());
    // add new location to selected graphic
    Point geoPoint = geoView.screenToLocation(geoViewPoint);
    selectedGraphic.setGeometry(geoPoint);
  }
});


//-- Add graphics to a scene view


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

// create a point for the Santa Monica pier
Point pierPoint = new Point(-118.4978, 34.0086, SpatialReferences.getWgs84());

// create a red (0xFFFF0000) sphere marker symbol
SimpleMarkerSceneSymbol redSphereSymbol = new SimpleMarkerSceneSymbol(SimpleMarkerSceneSymbol.Style.SPHERE, 0xFFFF0000, 500,
  500, 500, SceneSymbol.AnchorPosition.CENTER);

// create a graphic from the point and symbol
Graphic pierGraphic = new Graphic(pierPoint, redSphereSymbol);

// add the graphic to the graphics overlay
graphicsOverlay.getGraphics().add(pierGraphic);

// add graphics overlay to the scene view's graphics overlay collection
sceneView.getGraphicsOverlays().add(graphicsOverlay);

Symbolize

ArcGIS Runtime provides a comprehensive API for creating and modifying symbols for every type of geometry. Symbols define properties such as color, size, and style that define how the graphic is displayed. There are specialized symbols for representing objects with text or images and you can create advanced symbols that combine multiple symbol layers. See Styles and data visualization to learn about the available symbol types.

There are two ways to symbolize a graphic.

  1. Apply a symbol directly to the graphic. Graphics expose a symbol property that you can use to define the symbol.
  2. Apply a renderer to the graphics overlay. A renderer is a collection of one or more symbols that are applied to all graphics in the graphics overlay. A renderer allows you to do things like control symbology based on attribute values.

If you define a renderer for a graphics overlay, you do not need to assign symbols to the individual graphics it contains. Assigning a symbol directly to a graphic overrides the symbology defined by the renderer of the graphics overlay.

Display text

To display text on the map view as a graphic, create a graphic with a point, line, or polygon to define the location for your text. You can then provide a TextSymbol that defines the font, color, size, and text to display.

                                                                                                              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
// --- Add graphics to map view ---


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

// create a map point for the Santa Monica pier
Point pierPoint = new Point(-118.4978, 34.0086, SpatialReferences.getWgs84());

// create a red (0xFFFF0000) circle simple marker symbol
SimpleMarkerSymbol redCircleSymbol = new SimpleMarkerSymbol(SimpleMarkerSymbol.Style.CIRCLE, 0xFFFF0000, 10);

// create a graphic from the point and symbol
Graphic pierGraphic = new Graphic(pierPoint, redCircleSymbol);

// add the graphic to the graphics overlay
graphicsOverlay.getGraphics().add(pierGraphic);

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



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

// add graphics overlay to the geo view
geoView.getGraphicsOverlays().add(graphicsOverlay);



// create the geographic point
Point pierPoint = new Point(-118.4978, 34.0086, 500, SpatialReferences.getWgs84());

// create text symbol
TextSymbol pierTextSymbol =
    new TextSymbol(
        10, "Santa Monica Pier", Color.argb(255, 255, 0, 0),
        HorizontalAlignment.LEFT, VerticalAlignment.BOTTOM);

// create a graphic from the point and symbol
Graphic pierGraphic = new Graphic(pierPoint, pierTextSymbol);



// identify graphics on the graphics overlay
final ListenableFuture<IdentifyGraphicsOverlayResult> identifyFuture = mGeoView.identifyGraphicsOverlayAsync(overlay,
    screenPoint, 10, false, 10);

identifyFuture.addDoneListener(new Runnable() {
  @Override
  public void run() {
    try {
      // get the list of graphics returned by identify
      List<Graphic> identifiedGraphics = identifyFuture.get().getGraphics();

      // iterate the graphics
      for (Graphic graphic : identifiedGraphics) {
        // Use identified graphics as required, for example access attributes or geometry, select, build a table, etc...
        graphic.setSelected(true);
      }
    } catch (InterruptedException | ExecutionException ex) {
      dealWithException(ex); // must deal with checked exceptions
    }

  }
});



// iterate a set of graphics (from an identify operation, for example)
for (Graphic graphic : identifiedGraphics) {
  // select each graphic
  graphic.setSelected(true);
}



// create a point from location clicked
geoView.setOnMouseClicked(e -> {
  if (e.getButton() == MouseButton.PRIMARY) {
    Point2D geoViewPoint = new Point2D(e.getX(), e.getY());
    // add new location to selected graphic
    Point geoPoint = geoView.screenToLocation(geoViewPoint);
    selectedGraphic.setGeometry(geoPoint);
  }
});


//-- Add graphics to a scene view


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

// create a point for the Santa Monica pier
Point pierPoint = new Point(-118.4978, 34.0086, SpatialReferences.getWgs84());

// create a red (0xFFFF0000) sphere marker symbol
SimpleMarkerSceneSymbol redSphereSymbol = new SimpleMarkerSceneSymbol(SimpleMarkerSceneSymbol.Style.SPHERE, 0xFFFF0000, 500,
  500, 500, SceneSymbol.AnchorPosition.CENTER);

// create a graphic from the point and symbol
Graphic pierGraphic = new Graphic(pierPoint, redSphereSymbol);

// add the graphic to the graphics overlay
graphicsOverlay.getGraphics().add(pierGraphic);

// add graphics overlay to the scene view's graphics overlay collection
sceneView.getGraphicsOverlays().add(graphicsOverlay);

Identify

A graphic can contain descriptive information in the form of attributes. Attributes are a collection of pairs of keys (field names) and values that are defined when you create a graphic. Your app can identify a graphic in the view from a click or tap and return its attributes. You can then display these attributes in a suitable UI element, such as a callout, pop-up, or dialog.

The following example shows how you can identify a graphics overlay in response to a tap on the map view.

                                                                                                              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
// --- Add graphics to map view ---


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

// create a map point for the Santa Monica pier
Point pierPoint = new Point(-118.4978, 34.0086, SpatialReferences.getWgs84());

// create a red (0xFFFF0000) circle simple marker symbol
SimpleMarkerSymbol redCircleSymbol = new SimpleMarkerSymbol(SimpleMarkerSymbol.Style.CIRCLE, 0xFFFF0000, 10);

// create a graphic from the point and symbol
Graphic pierGraphic = new Graphic(pierPoint, redCircleSymbol);

// add the graphic to the graphics overlay
graphicsOverlay.getGraphics().add(pierGraphic);

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



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

// add graphics overlay to the geo view
geoView.getGraphicsOverlays().add(graphicsOverlay);



// create the geographic point
Point pierPoint = new Point(-118.4978, 34.0086, 500, SpatialReferences.getWgs84());

// create text symbol
TextSymbol pierTextSymbol =
    new TextSymbol(
        10, "Santa Monica Pier", Color.argb(255, 255, 0, 0),
        HorizontalAlignment.LEFT, VerticalAlignment.BOTTOM);

// create a graphic from the point and symbol
Graphic pierGraphic = new Graphic(pierPoint, pierTextSymbol);



// identify graphics on the graphics overlay
final ListenableFuture<IdentifyGraphicsOverlayResult> identifyFuture = mGeoView.identifyGraphicsOverlayAsync(overlay,
    screenPoint, 10, false, 10);

identifyFuture.addDoneListener(new Runnable() {
  @Override
  public void run() {
    try {
      // get the list of graphics returned by identify
      List<Graphic> identifiedGraphics = identifyFuture.get().getGraphics();

      // iterate the graphics
      for (Graphic graphic : identifiedGraphics) {
        // Use identified graphics as required, for example access attributes or geometry, select, build a table, etc...
        graphic.setSelected(true);
      }
    } catch (InterruptedException | ExecutionException ex) {
      dealWithException(ex); // must deal with checked exceptions
    }

  }
});



// iterate a set of graphics (from an identify operation, for example)
for (Graphic graphic : identifiedGraphics) {
  // select each graphic
  graphic.setSelected(true);
}



// create a point from location clicked
geoView.setOnMouseClicked(e -> {
  if (e.getButton() == MouseButton.PRIMARY) {
    Point2D geoViewPoint = new Point2D(e.getX(), e.getY());
    // add new location to selected graphic
    Point geoPoint = geoView.screenToLocation(geoViewPoint);
    selectedGraphic.setGeometry(geoPoint);
  }
});


//-- Add graphics to a scene view


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

// create a point for the Santa Monica pier
Point pierPoint = new Point(-118.4978, 34.0086, SpatialReferences.getWgs84());

// create a red (0xFFFF0000) sphere marker symbol
SimpleMarkerSceneSymbol redSphereSymbol = new SimpleMarkerSceneSymbol(SimpleMarkerSceneSymbol.Style.SPHERE, 0xFFFF0000, 500,
  500, 500, SceneSymbol.AnchorPosition.CENTER);

// create a graphic from the point and symbol
Graphic pierGraphic = new Graphic(pierPoint, redSphereSymbol);

// add the graphic to the graphics overlay
graphicsOverlay.getGraphics().add(pierGraphic);

// add graphics overlay to the scene view's graphics overlay collection
sceneView.getGraphicsOverlays().add(graphicsOverlay);

Select

Select graphics to highlight them on the display. You can select zero, one, or several graphics in a graphics overlay. Each graphic's selection state is represented with an isSelected() property that is either true or false.

Use setSelected(true) to select a graphic in the view.

                                                                                                              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
// --- Add graphics to map view ---


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

// create a map point for the Santa Monica pier
Point pierPoint = new Point(-118.4978, 34.0086, SpatialReferences.getWgs84());

// create a red (0xFFFF0000) circle simple marker symbol
SimpleMarkerSymbol redCircleSymbol = new SimpleMarkerSymbol(SimpleMarkerSymbol.Style.CIRCLE, 0xFFFF0000, 10);

// create a graphic from the point and symbol
Graphic pierGraphic = new Graphic(pierPoint, redCircleSymbol);

// add the graphic to the graphics overlay
graphicsOverlay.getGraphics().add(pierGraphic);

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



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

// add graphics overlay to the geo view
geoView.getGraphicsOverlays().add(graphicsOverlay);



// create the geographic point
Point pierPoint = new Point(-118.4978, 34.0086, 500, SpatialReferences.getWgs84());

// create text symbol
TextSymbol pierTextSymbol =
    new TextSymbol(
        10, "Santa Monica Pier", Color.argb(255, 255, 0, 0),
        HorizontalAlignment.LEFT, VerticalAlignment.BOTTOM);

// create a graphic from the point and symbol
Graphic pierGraphic = new Graphic(pierPoint, pierTextSymbol);



// identify graphics on the graphics overlay
final ListenableFuture<IdentifyGraphicsOverlayResult> identifyFuture = mGeoView.identifyGraphicsOverlayAsync(overlay,
    screenPoint, 10, false, 10);

identifyFuture.addDoneListener(new Runnable() {
  @Override
  public void run() {
    try {
      // get the list of graphics returned by identify
      List<Graphic> identifiedGraphics = identifyFuture.get().getGraphics();

      // iterate the graphics
      for (Graphic graphic : identifiedGraphics) {
        // Use identified graphics as required, for example access attributes or geometry, select, build a table, etc...
        graphic.setSelected(true);
      }
    } catch (InterruptedException | ExecutionException ex) {
      dealWithException(ex); // must deal with checked exceptions
    }

  }
});



// iterate a set of graphics (from an identify operation, for example)
for (Graphic graphic : identifiedGraphics) {
  // select each graphic
  graphic.setSelected(true);
}



// create a point from location clicked
geoView.setOnMouseClicked(e -> {
  if (e.getButton() == MouseButton.PRIMARY) {
    Point2D geoViewPoint = new Point2D(e.getX(), e.getY());
    // add new location to selected graphic
    Point geoPoint = geoView.screenToLocation(geoViewPoint);
    selectedGraphic.setGeometry(geoPoint);
  }
});


//-- Add graphics to a scene view


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

// create a point for the Santa Monica pier
Point pierPoint = new Point(-118.4978, 34.0086, SpatialReferences.getWgs84());

// create a red (0xFFFF0000) sphere marker symbol
SimpleMarkerSceneSymbol redSphereSymbol = new SimpleMarkerSceneSymbol(SimpleMarkerSceneSymbol.Style.SPHERE, 0xFFFF0000, 500,
  500, 500, SceneSymbol.AnchorPosition.CENTER);

// create a graphic from the point and symbol
Graphic pierGraphic = new Graphic(pierPoint, redSphereSymbol);

// add the graphic to the graphics overlay
graphicsOverlay.getGraphics().add(pierGraphic);

// add graphics overlay to the scene view's graphics overlay collection
sceneView.getGraphicsOverlays().add(graphicsOverlay);

Move graphics

To move a graphic, you only need to update its geometry. This is much more efficient than creating a new graphic and replacing the existing one. Updating a graphic's geometry will cause it to immediately display at the new location. Use this technique to animate the display of moving geoelements.

The following example moves a selected graphic to the location specified by the user.

                                                                                                              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
// --- Add graphics to map view ---


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

// create a map point for the Santa Monica pier
Point pierPoint = new Point(-118.4978, 34.0086, SpatialReferences.getWgs84());

// create a red (0xFFFF0000) circle simple marker symbol
SimpleMarkerSymbol redCircleSymbol = new SimpleMarkerSymbol(SimpleMarkerSymbol.Style.CIRCLE, 0xFFFF0000, 10);

// create a graphic from the point and symbol
Graphic pierGraphic = new Graphic(pierPoint, redCircleSymbol);

// add the graphic to the graphics overlay
graphicsOverlay.getGraphics().add(pierGraphic);

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



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

// add graphics overlay to the geo view
geoView.getGraphicsOverlays().add(graphicsOverlay);



// create the geographic point
Point pierPoint = new Point(-118.4978, 34.0086, 500, SpatialReferences.getWgs84());

// create text symbol
TextSymbol pierTextSymbol =
    new TextSymbol(
        10, "Santa Monica Pier", Color.argb(255, 255, 0, 0),
        HorizontalAlignment.LEFT, VerticalAlignment.BOTTOM);

// create a graphic from the point and symbol
Graphic pierGraphic = new Graphic(pierPoint, pierTextSymbol);



// identify graphics on the graphics overlay
final ListenableFuture<IdentifyGraphicsOverlayResult> identifyFuture = mGeoView.identifyGraphicsOverlayAsync(overlay,
    screenPoint, 10, false, 10);

identifyFuture.addDoneListener(new Runnable() {
  @Override
  public void run() {
    try {
      // get the list of graphics returned by identify
      List<Graphic> identifiedGraphics = identifyFuture.get().getGraphics();

      // iterate the graphics
      for (Graphic graphic : identifiedGraphics) {
        // Use identified graphics as required, for example access attributes or geometry, select, build a table, etc...
        graphic.setSelected(true);
      }
    } catch (InterruptedException | ExecutionException ex) {
      dealWithException(ex); // must deal with checked exceptions
    }

  }
});



// iterate a set of graphics (from an identify operation, for example)
for (Graphic graphic : identifiedGraphics) {
  // select each graphic
  graphic.setSelected(true);
}



// create a point from location clicked
geoView.setOnMouseClicked(e -> {
  if (e.getButton() == MouseButton.PRIMARY) {
    Point2D geoViewPoint = new Point2D(e.getX(), e.getY());
    // add new location to selected graphic
    Point geoPoint = geoView.screenToLocation(geoViewPoint);
    selectedGraphic.setGeometry(geoPoint);
  }
});


//-- Add graphics to a scene view


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

// create a point for the Santa Monica pier
Point pierPoint = new Point(-118.4978, 34.0086, SpatialReferences.getWgs84());

// create a red (0xFFFF0000) sphere marker symbol
SimpleMarkerSceneSymbol redSphereSymbol = new SimpleMarkerSceneSymbol(SimpleMarkerSceneSymbol.Style.SPHERE, 0xFFFF0000, 500,
  500, 500, SceneSymbol.AnchorPosition.CENTER);

// create a graphic from the point and symbol
Graphic pierGraphic = new Graphic(pierPoint, redSphereSymbol);

// add the graphic to the graphics overlay
graphicsOverlay.getGraphics().add(pierGraphic);

// add graphics overlay to the scene view's graphics overlay collection
sceneView.getGraphicsOverlays().add(graphicsOverlay);

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.