Point, line, and polygon styles

USA weather stations, highways, and states displayed using symbols and simple renderers

What are point, line, and polygon styles?

You can style and display points, lines, and polygons in a map or scene by defining symbols for features. To style features in a feature layer, you define symbols and apply them with a renderer. Styling points, lines, and polygons is also known as styling features because every feature contains a geometry and is styled with a symbol.

There are many different types of symbols you can use to style features. The type of symbol you use depends on the type of visualization you would like to create. 2D symbols are used to display features in a map, and 3D symbols are used to display features in a scene. The most common type of symbol is a simple symbol.

This document covers how to use different symbols and a renderer to style features in a map or scene.

How to style points, lines, and polygons

In general, there are two ways to style features:

  1. Apply symbols to graphics: You use this approach when you need to display the location for temporary graphics in a map or scene. The symbol type must match the geometry type of the graphic. Learn more about how to create graphics in Graphics.

  2. Apply a renderer (with symbols) to a data layer: You use this approach when you want to style all features in a data layer in a map or scene. A renderer defines the "rules" for applying symbols to features, and the symbols define the style used to display the feature. Learn more about layers that support features in Data layers.

Simple renderer

The most common type of renderer is a simple renderer. You use a simple renderer to style all of the features in a data layer the same way. Using a simple renderer, all visual properties of the symbol (e.g. size, color, opacity, texture, etc.) are fixed for each feature. The primary purpose of the visualization is to show where a feature is located, not specifics about the feature's attributes. For example, if you want to know the locations of weather stations, but you doen't need to know additional attribute information about each station, you should render all points with the same symbol.

ArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for .NETArcGIS Maps SDK for JavaArcGIS Maps SDK for SwiftArcGIS Maps SDK for Qt (C++)ArcGIS Maps SDK for Qt (QML)
Expand
Use dark colors for code blocksCopy
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
        const renderer = new SimpleRenderer({
          symbol: new SimpleMarkerSymbol({
            size: 4,
            color: [0, 255, 255],
            outline: null
          })
        });
Expand

Symbols

The style for features in a map are defined by a symbol. The symbol should represent the data with either what the symbol represents or how the feature is related to other features with respect to location and the data attributes being mapped.

The symbol chosen for a layer depends on the view in which it is rendered (2D or 3D), and the geometry type of the features in the layer (point, polyline, polygon, or mesh).

2D Symbols

You use 2D symbols to style point, line, and polygon geometries and display them in a map. The main types are marker, picture, and text symbols. See below for more examples.

ArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for .NETArcGIS Maps SDK for JavaArcGIS Maps SDK for SwiftArcGIS Maps SDK for Qt (C++)ArcGIS Maps SDK for Qt (QML)
Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
const symbol = new SimpleMarkerSymbol({
  color: "rgba(0,128,155,0.8)",
  size: "10px",
  outline: new SimpleLineSymbol({
    width: 0.5,
    color: "rgba(255,255,255,0.3)"
  })
});

3D Symbols

You use 3D symbols to style point, line, polygon, and mesh geometries and display them in a scene. In a scene, you can choose between two types of symbols:

  • 2D symbols such as marker symbols, line symbols and polygon fill symbols.
  • 3D symbols such as 3D model symbols, path symbols and extruded polygon symbols.

See below for more examples.

ArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for .NETArcGIS Maps SDK for JavaArcGIS Maps SDK for SwiftArcGIS Maps SDK for Qt (C++)ArcGIS Maps SDK for Qt (QML)
Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
const pointSymbol = new PointSymbol3D({
  symbolLayers: [ new IconSymbol3DLayer({
    resource: { href: "pin.svg" },
    size: 15,
    material: {
      color: "#4c397f"
    },
    anchor: "bottom"
  })]
});

2D examples

Points

To visualize the location of point features in a map, set a simple marker symbol, picture marker symbol, or a CIM symbol in a simple renderer, and set the renderer on the layer. All features will display in the view with the same symbol.

This example visualizes the locations of weather stations.

  1. Create a simple marker symbol and add it to a simple renderer.
  2. Set the renderer to a data layer.
ArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for .NETArcGIS Maps SDK for JavaArcGIS Maps SDK for SwiftArcGIS Maps SDK for Qt (C++)ArcGIS Maps SDK for Qt (QML)
Expand
Use dark colors for code blocksCopy
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
        const renderer = new SimpleRenderer({
          symbol: new SimpleMarkerSymbol({
            size: 4,
            color: [0, 255, 255],
            outline: null
          })
        });
Expand

Lines

To visualize the location of line features in a map, use a simple line symbol or a CIM symbol, and a simple renderer .

This example displays the locations of major highways using a single symbol.

Steps

  1. Create a simple line symbol and add it to a simple renderer .
  2. Set the renderer to the data layer.
ArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for .NETArcGIS Maps SDK for JavaArcGIS Maps SDK for SwiftArcGIS Maps SDK for Qt (C++)ArcGIS Maps SDK for Qt (QML)
Expand
Use dark colors for code blocksCopy
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
        const renderer = new SimpleRenderer({
          symbol: new SimpleLineSymbol({
            width: 1,
            color: "#fb12ff",
          }),
        })
Expand

Polygons

To visualize the location of polygon features in a map, you can use a number of different symbol types such as a simple fill symbol, picture fill symbol, simple marker symbol, picture marker symbol, web style symbol, or a CIM symbol.

This example visualizes the borders of the states in the U.S. with very transparent polygons.

Steps

  1. Create a simple fill symbol and add it to a simple renderer.
  2. Set the renderer to the data layer.
ArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for .NETArcGIS Maps SDK for JavaArcGIS Maps SDK for SwiftArcGIS Maps SDK for Qt (C++)ArcGIS Maps SDK for Qt (QML)
Expand
Use dark colors for code blocksCopy
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
        const renderer = new SimpleRenderer({
          symbol: new SimpleFillSymbol({
            color: "rgba(249, 249, 199, .05)",
            outline: {
              color: "white",
              width: .15
            }
          })
        });
Expand

3D examples

Points

To visualize the location of point features in a scene, set a marker symbol or a 3D model symbol in a simple renderer, and set the renderer on the layer. All features will display in the view with the same symbol. This example shows how to create a globe that displays cities all over the world. The symbol for the cities is a pin marker.

Steps

  1. Create a marker symbol and add it to a simple renderer .
  2. Apply the renderer to the data layer so that each feature is displayed with the marker symbol.
ArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for .NETArcGIS Maps SDK for JavaArcGIS Maps SDK for SwiftArcGIS Maps SDK for Qt (C++)ArcGIS Maps SDK for Qt (QML)
Expand
Use dark colors for code blocksCopy
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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
        const renderer = new SimpleRenderer({
          symbol: new PointSymbol3D({
            symbolLayers: [
              new IconSymbol3DLayer({
                resource: {
                  href:
                    "https://static.arcgis.com/arcgis/styleItems/Icons/web/resource/Pushpin3.svg",
                },
                size: 15,
                material: {
                  color: "#4c397f",
                },
                anchor: "bottom",
              }),
            ],
          }),
        });
Expand

Lines

To visualize the location of line features in a scene, set a line symbol or a 3D path symbol in a simple renderer, and set the renderer on the layer. This example shows how to style the streets in Manhattan using a path symbol.

Steps

  1. Create a path symbol with a width and a height of 10 meters.
  2. Add it to a simple renderer.
  3. Apply the renderer to the data layer.
ArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for .NETArcGIS Maps SDK for JavaArcGIS Maps SDK for SwiftArcGIS Maps SDK for Qt (C++)ArcGIS Maps SDK for Qt (QML)
Expand
Use dark colors for code blocksCopy
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
111
112
113
        const renderer = new SimpleRenderer({
          symbol: new LineSymbol3D({
            symbolLayers: [
              new PathSymbol3DLayer({
                profile: "quad",
                material: {
                  color: [46, 255, 238],
                },
                width: 10,
                height: 10,
                join: "miter",
                cap: "round",
                anchor: "bottom",
                profileRotation: "all",
              }),
            ],
          }),
        })
Expand

Polygons

To visualize polygon features in a scene, use a fill symbol or extrude the polygon based on real-world heights. The example below extrudes building footprints with a fixed height to display schematic buildings in a city.

Steps

  1. Create an extruded polygon symbol and add it to a simple renderer.
  2. Apply the renderer to the data layer.
ArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for .NETArcGIS Maps SDK for JavaArcGIS Maps SDK for SwiftArcGIS Maps SDK for Qt (C++)ArcGIS Maps SDK for Qt (QML)
Expand
Use dark colors for code blocksCopy
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
        const renderer = new SimpleRenderer({
          symbol: new PolygonSymbol3D({
            symbolLayers: [
              new ExtrudeSymbol3DLayer({
                material: {
                  color: "#ffc53d",
                },
                size: 10,
                edges: {
                  type: "solid",
                  color: "#a67400",
                  size: 1.5,
                },
              }),
            ],
          }),
        })
Expand

Tutorials

Services

Feature service

Add, update, delete, and query feature data.

API support

Basemap stylesPoint, line, and polygon stylesData-driven visualization3D visualization
ArcGIS Maps SDK for JavaScript
ArcGIS Maps SDK for Kotlin
ArcGIS Maps SDK for Swift
ArcGIS Maps SDK for Java
ArcGIS Maps SDK for .NET
ArcGIS Maps SDK for Qt
ArcGIS API for Python12
Full supportPartial supportNo support
  • 1. Define renderers with JavaScript.
  • 2. Supports web scenes only.

Tools

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