Labeling features is useful to visually display information or attributes on a scene. For example, city officials or maintenance crews may want to show installation dates of features of a gas network.
How to use the sample
Pan and zoom to explore the scene. Notice the labels showing installation dates of features in the 3D gas network.
How it works
Create an AGSScene using a URL.
Assign the scene to an AGSSceneView and load it.
After loading is complete, obtain the AGSFeatureLayer from the scene's operationalLayers property.
Set the feature layer's labelsEnabled property to true.
Create an AGSTextSymbol to use for displaying the label text.
Create an AGSLabelDefinition using an AGSArcadeLabelExpression.
Add the definition to the feature layer's labelDefinitions array.
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
// Copyright 2021 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.import UIKit
import ArcGIS
classShowLabelsOnLayer3DViewController: UIViewController{
@IBOutletvar sceneView: AGSSceneView! {
didSet {
// Set the scene to the scene view. sceneView.scene = makeScene()
}
}
funcmakeScene() -> AGSScene {
let scene =AGSScene(
item: AGSPortalItem(
portal: AGSPortal.arcGISOnline(withLoginRequired: false),
itemID: "850dfee7d30f4d9da0ebca34a533c169" )
)
// Load the scene. scene.load { [weakself] error inguardletself=selfelse { return }
// Get the "Gas Main" feature layer.iflet groupLayer = scene.operationalLayers.lazy.compactMap({ $0as?AGSGroupLayer }).first(where: { $0.name =="Gas" }),
let layers = groupLayer.layers as? [AGSLayer],
let gasFeatureLayer = layers.first(where: { $0.name =="Gas Main" }) as?AGSFeatureLayer {
let labelDefinition =self.makeLabelDefinition()
// Enable labels on the feature layer. gasFeatureLayer.labelsEnabled =true// Set the layer's label definitions. gasFeatureLayer.labelDefinitions.setArray([labelDefinition])
} elseiflet error = error {
self.presentAlert(error: error)
}
}
return scene
}
funcmakeLabelDefinition() -> AGSLabelDefinition {
// Make and stylize the text symbol.let textSymbol =AGSTextSymbol()
textSymbol.color = .orange
textSymbol.haloColor = .white
textSymbol.haloWidth =2 textSymbol.size =16// Create and return a label definition using the text symbol.let labelDefinition =AGSLabelDefinition()
// Set an arcade expression to provide better formatting. labelDefinition.expression =AGSArcadeLabelExpression(arcadeString: "Text($feature.INSTALLATIONDATE, `DD MMM YY`)")
labelDefinition.placement = .lineAboveAlong
labelDefinition.useCodedValues =true labelDefinition.textSymbol = textSymbol
return labelDefinition
}
// MARK: UIViewControlleroverridefuncviewDidLoad() {
super.viewDidLoad()
// Add the source code button item to the right of navigation bar. (navigationItem.rightBarButtonItem as?SourceCodeBarButtonItem)?.filenames = ["ShowLabelsOnLayer3DViewController"]
}
}