Display a line of sight

Learn how to perform and display a line of sight analysis in a 3D scene.

A line of sight analysis is a type of visibility analysis that calculates visibility (visible or obstructed) between a designated observer and target. It calculates whether the target is visible to the observer based on the environment and renders a line indicating visibility on the map.

In this tutorial, you will perform and display a line of sight analysis in a web scene. Your line of sight analysis will show which targets (hot spots) are visible, based on the terrain, from specified observation points in the Yosemite Valley.

Prerequisites

Before starting this tutorial:

You need an ArcGIS Location Platform or ArcGIS Online account.
Your system meets the system requirements.

Steps

Open the Xcode project

To start this tutorial, first complete the Display a web scene tutorial or download and unzip the solution.
Open the .xcodeproj file in Xcode.
If you downloaded the solution, get an access token and set the API key.
An API Key gives your app access to secure resources used in this tutorial.
1. Go to the Create an API key tutorial to obtain a new API key access token. Ensure that the following privilege is enabled: Location services > Basemaps > Basemap styles service. Copy the access token as it will be used in the next step.
2. In Xcode, in the Project Navigator, click AppDelegate.swift.
3. In the editor, set the APIKey property on the AGSArcGISRuntimeEnvironment with your access token.
  AppDelegate.swift
  Expand
  Use dark colors for code blocks
  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 func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { AGSArcGISRuntimeEnvironment.apiKey = "YOUR_ACCESS_TOKEN" return true }
  Expand
  Warning
  The access token is stored directly in the code as a convenience for this tutorial. Storing access tokens in the source code is not best practice.

Get the web scene item ID

You can use ArcGIS tools to create and view web scenes. Use the Scene Viewer to identify the web scene item ID. This item ID will be used later in the tutorial.

Go to the Yosemite Valley Hotspots web scene in the Scene Viewer in ArcGIS Online. This web scene displays terrain and hotspots in the Yosemite Valley.
Make a note of the item ID at the end of the browser's URL. The item ID should be 7558ee942b2547019f66885c44d4f0b1.

Update the scene

In Xcode, in the Project Navigator, click ViewController.swift.

In the editor, modify the setupScene() method to create an AGSScene for the web scene. To do this, create a portal item providing the web scene's item ID and an AGSPortal referencing ArcGIS Online.

ViewController.swift
Expand
Use dark colors for code blocks
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
32
31
30
29
28
27
27
27
27
27
28
29
30
31
32
33
34
35
36
37
37
37
38
38
38
38
37
36
35
34
33
32
31
30
29
28
28
28
27
26
25
24
23
22
21
20
19
18
17
16
15
14
13
12
11
10
9
8
7
6
5
4
3
2
1
0
0
0
-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
-39
-39
-39
-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
Change line    private func setupScene() {
        let scene: AGSScene = {
            let portal = AGSPortal.arcGISOnline(withLoginRequired: false)

            let item = AGSPortalItem(portal: portal, itemID: "7558ee942b2547019f66885c44d4f0b1")

            return AGSScene(item: item)
        }()
        sceneView.scene = scene

    }
Expand

Add a UI to control the line of sight analyses

To control the line of sight analyses, some UI is required.

Define a private method named setupUI(). Create a "Clear" button and assign it to the navigation bar. The clear button will remove the line of sight analyses from the scene. You set an action on the clear button using a selector for a method that will be added in a later step.

ViewController.swift
Expand
Use dark colors for code blocks
49
49
49
49
49
49
49
49
49
49
49
49
49
49
49
49
49
49
49
49
49
49
49
48
47
46
45
44
43
43
43
43
43
43
43
43
43
43
43
43
43
43
43
42
41
41
41
41
41
42
43
44
45
46
46
46
46
46
45
45
45
44
43
42
41
40
39
38
37
36
35
34
33
32
31
30
29
28
27
26
25
24
23
22
21
20
19
18
17
17
17
16
15
14
13
12
11
10
9
8
7
6
5
4
3
2
1
0
-1
-2
-3
-4
-5
-6
-7
-8
-9
-10
-11
-12
-13
-14
-15
-16
-17
-18
-19
-20
-21
-22
-22
-22
-22
-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
Add line.Add line.Add line.Add line.    private func setupUI() {
        let clear = UIBarButtonItem(title: "Clear", style: .plain, target: self, action: #selector(clearScene))
        navigationItem.rightBarButtonItem = clear
    }

Expand

Define a method named clearScene(_:) and assign it the @objc keyword. This method removes the line of sight analyses from the scene view. The @objc method keyword exposes the method to Objective-C, a necessary step for using the UIBarButtonItem API.

ViewController.swift
Expand
Use dark colors for code blocks
49
49
49
49
49
49
49
49
49
49
49
49
49
49
49
49
49
49
49
49
49
49
49
48
47
46
45
44
43
43
43
43
43
43
43
43
43
43
43
43
43
43
43
42
41
41
41
41
41
42
43
44
45
46
47
48
49
50
50
50
50
49
48
47
46
45
44
43
42
41
40
39
38
37
36
35
34
33
32
31
30
29
28
27
26
25
24
23
22
22
22
21
20
19
18
17
16
15
14
13
12
11
10
9
8
7
6
5
4
3
2
1
0
-1
-2
-3
-4
-5
-6
-7
-8
-9
-10
-11
-12
-13
-14
-15
-16
-17
-17
-17
-17
-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
Add line.Add line.Add line.Add line.    private func setupUI() {
        let clear = UIBarButtonItem(title: "Clear", style: .plain, target: self, action: #selector(clearScene))
        navigationItem.rightBarButtonItem = clear
    }

    @objc
    func clearScene(_ sender: UIBarButtonItem) {
        clearAnalyses()
    }
Expand

In viewDidLoad(), call setupUI().

ViewController.swift
Expand
Use dark colors for code blocks
19
19
19
19
19
19
19
19
19
19
19
19
19
19
19
19
19
19
19
20
21
22
23
24
25
25
25
25
25
26
26
26
26
26
26
26
26
26
26
26
26
26
26
25
24
24
24
24
24
24
24
24
24
24
24
24
24
24
24
24
24
23
22
21
20
19
18
17
16
15
14
13
12
11
10
9
8
7
6
5
4
3
2
1
0
-1
-2
-3
-4
-4
-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
-43
-43
-43
-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
Add line.    override func viewDidLoad() {
        super.viewDidLoad()
        setupScene()

        setupUI()

    }
Expand

In Xcode, in the Project Navigator, click Main.storyboard.
In the editor, select ViewController. In the menu bar, click Editor > Embed In > Navigation Controller.

Embedding ViewController within a Navigation Controller places a navigation bar at the top of ViewController. The navigation bar contains the UI elements.
To verify that your UI is set up properly, press <Command+R> to run the app. You should see a "Clear" button contained by the navigation bar and the app should load the Yosemite Valley Hotspots web scene.

Add observer and target graphics

Your app will use graphics to depict the locations of the analyses observer and targets.

In Xcode, in the Project navigator, click ViewController.swift.

Create a private AGSGraphicsOverlay named graphicsOverlay to display the observer and targets graphics.

A graphics overlay is a container for graphics. It is used with a scene view to display graphics on a scene. You can add more than one graphics overlay to a scene view. Graphics overlays are displayed on top of all the other layers.

ViewController.swift
Expand
Use dark colors for code blocks
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
60
59
58
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
56
55
55
55
55
55
55
55
55
55
55
55
55
55
55
55
55
55
56
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
56
56
56
55
54
53
52
51
50
49
48
47
46
45
44
43
42
41
40
39
38
37
36
35
34
33
32
31
30
29
28
27
26
25
24
23
22
21
20
19
18
17
17
17
17
17
16
15
14
13
12
11
10
9
8
7
6
5
4
3
2
1
0
-1
-2
-3
-4
-5
-6
-7
-8
-9
-10
-11
-12
-13
-14
-15
-16
Add line.    private let graphicsOverlay = AGSGraphicsOverlay()

Expand

Create a private AGSGraphic named observerGraphic with a black fill color and white outline. This graphic is used to depict the location of the line of sight analyses observer and is initialized with a nil geometry because the observer's location is not yet determined.

A graphic with nil geometry will not be rendered in the scene view, even if it has been added to a graphics overlay.

ViewController.swift
Expand
Use dark colors for code blocks
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
61
60
59
58
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
56
55
55
55
55
55
55
55
55
55
55
55
55
55
55
55
55
55
56
57
58
59
60
61
62
62
61
60
59
58
57
56
55
54
53
52
51
50
49
48
47
46
45
44
43
42
42
42
41
40
39
38
37
36
35
34
33
32
31
30
29
28
27
26
25
24
23
22
21
20
19
18
17
16
15
14
13
12
11
10
9
8
7
6
5
4
3
3
3
3
3
2
1
0
-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
Add line.Add line.Add line.Add line.Add line.    private let graphicsOverlay = AGSGraphicsOverlay()

    private let observerGraphic: AGSGraphic = {
        let symbol = AGSSimpleMarkerSymbol(style: .circle, color: .black, size: 16)
        symbol.outline = AGSSimpleLineSymbol(style: .solid, color: .white, width: 2)
        return AGSGraphic(geometry: nil, symbol: symbol)
    }()
Expand

Create a private method named addTargetGraphic(point:) that accepts an AGSPoint as a parameter. This method is used to create graphics with a white fill color and black outline to depict the locations of line of sight analyses targets.

ViewController.swift
Expand
Use dark colors for code blocks
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
62
61
60
59
59
59
59
59
59
59
59
59
59
59
59
59
59
59
58
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
71
70
69
68
67
66
65
64
63
62
61
60
60
60
59
58
57
56
55
54
53
52
51
50
49
48
47
46
45
44
43
42
41
40
39
38
37
36
35
34
33
32
31
30
29
28
27
26
25
24
23
22
21
21
21
21
21
20
19
18
17
16
15
14
13
12
11
10
9
8
7
6
5
4
3
2
1
0
-1
-2
-3
-4
-5
-6
-7
-8
-9
-10
-11
-12
Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.    private let observerGraphic: AGSGraphic = {
        let symbol = AGSSimpleMarkerSymbol(style: .circle, color: .black, size: 16)
        symbol.outline = AGSSimpleLineSymbol(style: .solid, color: .white, width: 2)
        return AGSGraphic(geometry: nil, symbol: symbol)
    }()

    @discardableResult
    private func addTargetGraphic(point: AGSPoint) -> AGSGraphic {
        let symbol = AGSSimpleMarkerSymbol(style: .circle, color: .white, size: 16)
        symbol.outline = AGSSimpleLineSymbol(style: .solid, color: .black, width: 2)
        let targetGraphic = AGSGraphic(geometry: point, symbol: symbol, attributes: nil)
        graphicsOverlay.graphics.add(targetGraphic)
        return targetGraphic
    }
Expand

Create a private computed variable named targetGraphics to filter and return all graphics contained by graphicsOverlay that depict target locations. The graphics overlay contains one observerGraphic and zero or several target graphics so any graphic that is not the observer is a target.

ViewController.swift
Expand
Use dark colors for code blocks
69
69
69
69
69
69
69
69
69
69
69
69
69
69
69
69
69
69
69
69
69
69
69
69
69
68
67
66
65
65
65
65
65
65
65
65
65
65
65
65
65
65
65
64
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
63
64
65
66
67
68
69
70
71
72
73
74
75
75
74
73
72
71
70
69
68
68
68
67
66
65
64
63
62
61
60
59
58
57
56
55
54
53
52
51
50
49
48
47
46
45
44
43
42
41
40
39
38
37
36
35
34
33
32
31
30
29
29
29
29
29
28
27
26
25
24
23
22
21
20
19
18
17
16
15
14
13
12
11
10
9
8
7
6
5
4
3
2
1
0
-1
-2
-3
-4
Add line.Add line.Add line.    @discardableResult
    private func addTargetGraphic(point: AGSPoint) -> AGSGraphic {
        let symbol = AGSSimpleMarkerSymbol(style: .circle, color: .white, size: 16)
        symbol.outline = AGSSimpleLineSymbol(style: .solid, color: .black, width: 2)
        let targetGraphic = AGSGraphic(geometry: point, symbol: symbol, attributes: nil)
        graphicsOverlay.graphics.add(targetGraphic)
        return targetGraphic
    }

    private var targetGraphics: [AGSGraphic] {
        graphicsOverlay.graphics.filter { ($0 as! AGSGraphic) != observerGraphic } as! [AGSGraphic]
    }
Expand

Define a private method named setupGraphicsOverlay() to specify various sceneProperties of the graphicsOverlay and add it to the scene view. Scene properties of the graphics overlay allow you to control 3D-specific rendering of graphics.

Specifying the surfacePlacement as absolute treats graphics geometry z-values as absolute altitude values. If the geometry does not contain a z-value or has a value of 0, the graphic will be rendered at surface level. Increasing the z-value renders the graphic at a higher altitude.
Specifying the altitudeOffset increases the altitude by adding the specified value to the z-value altitude.

ViewController.swift
Expand
Use dark colors for code blocks
78
78
78
78
78
78
78
78
78
78
78
78
78
78
78
78
78
78
78
78
78
78
78
78
78
77
76
75
74
74
74
74
74
74
74
74
74
74
74
74
74
74
74
73
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
73
74
75
76
77
78
79
80
81
82
82
82
82
81
80
79
78
77
76
75
74
73
72
71
70
69
68
67
66
65
64
63
62
61
60
59
58
57
56
55
54
53
52
51
50
49
48
47
46
45
44
43
43
43
43
43
42
41
40
39
38
37
36
35
34
33
32
31
30
29
28
27
26
25
24
23
22
21
20
19
18
17
16
15
14
13
12
11
10
Add line.Add line.Add line.Add line.Add line.Add line.    private var targetGraphics: [AGSGraphic] {
        graphicsOverlay.graphics.filter { ($0 as! AGSGraphic) != observerGraphic } as! [AGSGraphic]
    }

    private func setupGraphicsOverlay() {
        graphicsOverlay.graphics.add(observerGraphic)
        graphicsOverlay.sceneProperties?.surfacePlacement = .absolute
        graphicsOverlay.sceneProperties?.altitudeOffset = 5
        sceneView.graphicsOverlays.add(graphicsOverlay)
    }
Expand

In viewDidLoad(), call the method setupGraphicsOverlay().

ViewController.swift
Expand
Use dark colors for code blocks
19
19
19
19
19
19
19
19
19
19
19
19
19
19
19
19
19
19
19
20
21
22
23
24
25
26
27
27
27
28
28
28
28
28
28
28
28
28
28
28
28
28
28
27
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
26
25
24
23
22
21
20
19
18
17
16
15
14
13
12
11
10
9
8
7
6
5
4
3
2
1
0
-1
-2
-3
-4
-5
-6
-7
-8
-9
-10
-11
-12
-13
-13
-13
-13
-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
Add line.    override func viewDidLoad() {
        super.viewDidLoad()
        setupScene()

        setupUI()

        setupGraphicsOverlay()

    }
Expand

Create line of sight analyses

Visual analyses help you make sense of complex 3D data contained by a scene. Use an AGSGeoElementLineOfSight to perform and display a line of sight analysis using 3D geoelements to define observer and target locations.

Create a private AGSAnalysisOverlay named analysisOverlay to contain and display the line of sight analyses.

An analysis overlay is a container for analyses. It is used with a scene view to display visual analyses on a scene. You can add more than one analysis overlay to a scene view. Analysis overlays are displayed on top of all other layers and graphics overlays.

ViewController.swift
Expand
Use dark colors for code blocks
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
90
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
88
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
88
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
88
88
88
88
88
87
86
85
84
83
82
81
80
79
78
77
76
75
74
73
72
71
70
69
68
67
66
65
64
63
62
61
60
59
58
57
56
55
Add line.    private let analysisOverlay = AGSAnalysisOverlay()

Expand

Define a private method named setupAnalysisOverlay() to add the analysis overlay to the scene view.

ViewController.swift
Expand
Use dark colors for code blocks
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
90
89
89
89
89
89
89
89
89
89
89
89
89
89
89
89
88
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
87
88
89
90
91
92
92
91
90
89
88
87
86
85
84
83
82
81
80
79
78
77
76
75
74
73
72
71
70
69
68
67
66
65
64
63
62
61
60
59
59
59
59
59
58
57
56
55
54
53
52
51
50
49
48
47
46
45
44
43
42
41
40
39
38
37
36
35
34
33
32
31
30
29
28
27
26
Add line.Add line.Add line.    private let analysisOverlay = AGSAnalysisOverlay()

    private func setupAnalysisOverlay() {
        sceneView.analysisOverlays.add(analysisOverlay)
    }
Expand

In viewDidLoad(), call the method setupAnalysisOverlay().

ViewController.swift
Expand
Use dark colors for code blocks
19
19
19
19
19
19
19
19
19
19
19
19
19
19
19
19
19
19
19
20
21
22
23
24
25
26
27
28
29
30
30
30
30
30
30
30
30
30
30
30
30
30
30
29
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
28
27
26
25
24
23
22
21
20
19
18
17
16
15
14
13
12
11
10
9
8
7
6
5
4
3
2
1
0
-1
-2
-3
-4
-5
-5
-5
-5
-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
Add line.    override func viewDidLoad() {
        super.viewDidLoad()
        setupScene()

        setupUI()

        setupGraphicsOverlay()

        setupAnalysisOverlay()

    }
Expand

Define a private method named createLineOfSightAnalysis(observer:target:) that accepts an observer and a target as parameters, both are AGSGeoElement types. This method creates a AGSGeoElementLineOfSight analysis and adds it to the scene view analysis overlay.

A AGSGeoElementLineOfSight is used to perform and display a line of sight analysis between two AGSGeoElement types, like a feature or graphic. Alternatively, you can perform and display a line of sight analysis between two locations (3D points) using a AGSLocationLineOfSight.

ViewController.swift
Expand
Use dark colors for code blocks
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
93
92
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
91
92
93
94
95
96
97
98
99
99
98
97
96
95
94
93
92
91
90
89
88
87
86
85
84
83
82
81
80
79
78
77
76
75
74
73
72
71
71
71
71
71
70
69
68
67
66
65
64
63
62
61
60
59
58
57
56
55
54
53
52
51
50
49
48
47
46
45
44
43
42
41
40
39
38
Add line.Add line.Add line.Add line.    private func setupAnalysisOverlay() {
        sceneView.analysisOverlays.add(analysisOverlay)
    }

    private func createLineOfSightAnalysis(observer: AGSGeoElement, target: AGSGeoElement) {
        let line = AGSGeoElementLineOfSight(observerGeoElement: observer, targetGeoElement: target)
        analysisOverlay.analyses.add(line)
    }
Expand

Define a private method named clearAnalyses() to remove all line of sight analyses from the scene view. This method also removes observer and target graphics.

ViewController.swift
Expand
Use dark colors for code blocks
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
97
96
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
95
96
97
98
99
100
101
102
103
104
105
105
104
103
102
101
100
99
98
97
96
95
94
93
92
91
90
89
88
87
86
85
84
83
83
83
83
83
82
81
80
79
78
77
76
75
74
73
72
71
70
69
68
67
66
65
64
63
62
61
60
59
58
57
56
55
54
53
52
51
50
Add line.Add line.Add line.Add line.Add line.    private func createLineOfSightAnalysis(observer: AGSGeoElement, target: AGSGeoElement) {
        let line = AGSGeoElementLineOfSight(observerGeoElement: observer, targetGeoElement: target)
        analysisOverlay.analyses.add(line)
    }

    private func clearAnalyses() {
        analysisOverlay.analyses.removeAllObjects()
        observerGraphic.geometry = nil
        graphicsOverlay.graphics.removeObjects(in: targetGraphics)
    }
Expand

Define a private method named setObserver(point:) that accepts an AGSPoint as a parameter. This method is used to specify the location of observerGraphic and create line of sight analyses for targets, if they exist.

ViewController.swift
Expand
Use dark colors for code blocks
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
102
101
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
115
114
113
112
111
110
109
108
107
106
105
104
103
103
103
103
103
102
101
100
99
98
97
96
95
94
93
92
91
90
89
88
87
86
85
84
83
82
81
80
79
78
77
76
75
74
73
72
71
70
Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.    private func clearAnalyses() {
        analysisOverlay.analyses.removeAllObjects()
        observerGraphic.geometry = nil
        graphicsOverlay.graphics.removeObjects(in: targetGraphics)
    }

    private func setObserver(point: AGSPoint) {
        let shouldCreateAnalyses = observerGraphic.geometry == nil
        observerGraphic.geometry = point
        if shouldCreateAnalyses {
            targetGraphics.forEach { targetGraphic in
                createLineOfSightAnalysis(observer: observerGraphic, target: targetGraphic)
            }
        }
    }
Expand

Define a private method named clearObserver() to remove the observer.

ViewController.swift
Expand
Use dark colors for code blocks
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
108
107
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
120
119
118
117
116
115
114
113
113
113
113
113
112
111
110
109
108
107
106
105
104
103
102
101
100
99
98
97
96
95
94
93
92
91
90
89
88
87
86
85
84
83
82
81
80
Add line.Add line.Add line.Add line.    private func setObserver(point: AGSPoint) {
        let shouldCreateAnalyses = observerGraphic.geometry == nil
        observerGraphic.geometry = point
        if shouldCreateAnalyses {
            targetGraphics.forEach { targetGraphic in
                createLineOfSightAnalysis(observer: observerGraphic, target: targetGraphic)
            }
        }
    }

    private func clearObserver() {
        analysisOverlay.analyses.removeAllObjects()
        observerGraphic.geometry = nil
    }
Expand

Define a private method named addTarget(point:) that accepts an AGSPoint as a parameter. This method is used to create a new target and create a line of sight analysis between the observer and the new target.

ViewController.swift
Expand
Use dark colors for code blocks
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
118
117
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
116
117
118
119
120
121
122
123
124
125
126
127
127
127
127
127
127
126
125
124
123
122
121
120
119
118
117
116
115
114
113
112
111
110
109
108
107
106
105
104
103
102
101
100
99
98
97
96
95
94
Add line.Add line.Add line.Add line.Add line.Add line.    private func clearObserver() {
        analysisOverlay.analyses.removeAllObjects()
        observerGraphic.geometry = nil
    }

    private func addTarget(point: AGSPoint) {
        let targetGraphic = addTargetGraphic(point: point)
        if observerGraphic.geometry != nil {
            createLineOfSightAnalysis(observer: observerGraphic, target: targetGraphic)
        }
    }
Expand

Display the line of sight analyses with touch events

Touch events determine where to place the observer and targets as well as display line of sight analyses. A user taps to place targets and then long-press and drags to place the observer and display line of sight analyses.

Extend ViewController to conform to the AGSGeoViewTouchDelegate protocol and include the four long-press and single tap geoview touch delegate methods.

ViewController.swift
Expand
Use dark colors for code blocks
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
133
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
133
134
135
136
136
136
137
138
139
140
140
140
141
142
143
144
144
144
145
146
147
148
148
148
149
150
151
152
152
152
153
154
155
Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.Add line.extension ViewController: AGSGeoViewTouchDelegate {

    func geoView(_ geoView: AGSGeoView, didTapAtScreenPoint screenPoint: CGPoint, mapPoint: AGSPoint) {

    }

    func geoView(_ geoView: AGSGeoView, didLongPressAtScreenPoint screenPoint: CGPoint, mapPoint: AGSPoint) {

    }

    func geoView(_ geoView: AGSGeoView, didMoveLongPressToScreenPoint screenPoint: CGPoint, mapPoint: AGSPoint) {

    }

    func geoView(_ geoView: AGSGeoView, didEndLongPressAtScreenPoint screenPoint: CGPoint, mapPoint: AGSPoint) {

    }

    func geoViewDidCancelLongPress(_ geoView: AGSGeoView) {

    }

}

When the user taps the geoview, call addTarget(point:).

ViewController.swift
Expand
Use dark colors for code blocks
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
133
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
133
134
135
136
137
138
139
140
141
142
142
142
143
144
145
146
146
146
147
148
149
150
150
150
151
152
153
154
154
154
155
156
157
Add line.extension ViewController: AGSGeoViewTouchDelegate {

    func geoView(_ geoView: AGSGeoView, didTapAtScreenPoint screenPoint: CGPoint, mapPoint: AGSPoint) {

        addTarget(point: mapPoint)

    }

    func geoView(_ geoView: AGSGeoView, didLongPressAtScreenPoint screenPoint: CGPoint, mapPoint: AGSPoint) {

    }

    func geoView(_ geoView: AGSGeoView, didMoveLongPressToScreenPoint screenPoint: CGPoint, mapPoint: AGSPoint) {

    }

    func geoView(_ geoView: AGSGeoView, didEndLongPressAtScreenPoint screenPoint: CGPoint, mapPoint: AGSPoint) {

    }

    func geoViewDidCancelLongPress(_ geoView: AGSGeoView) {

    }

}

When the user begins, moves, and ends a long-press touch event, call setObserver(point:). Using all three touch delegate methods together allows the user to specify and move the location of the observer by long-pressing and dragging their finger around the screen.

ViewController.swift
Expand
Use dark colors for code blocks
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
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
162
162
163
164
165
Add line.Add line.Add line.extension ViewController: AGSGeoViewTouchDelegate {

    func geoView(_ geoView: AGSGeoView, didTapAtScreenPoint screenPoint: CGPoint, mapPoint: AGSPoint) {

        addTarget(point: mapPoint)

    }

    func geoView(_ geoView: AGSGeoView, didLongPressAtScreenPoint screenPoint: CGPoint, mapPoint: AGSPoint) {

        setObserver(point: mapPoint)

    }

    func geoView(_ geoView: AGSGeoView, didMoveLongPressToScreenPoint screenPoint: CGPoint, mapPoint: AGSPoint) {

        setObserver(point: mapPoint)

    }

    func geoView(_ geoView: AGSGeoView, didEndLongPressAtScreenPoint screenPoint: CGPoint, mapPoint: AGSPoint) {

        setObserver(point: mapPoint)

    }

    func geoViewDidCancelLongPress(_ geoView: AGSGeoView) {

    }

}

When the user cancels the long-press touch event, call clearObserver().

This may happen, for instance, when you have the magnifier visible and attempt to take a screenshot using the home/lock button combination.

ViewController.swift
Expand
Use dark colors for code blocks
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
134
133
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
132
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
Add line.extension ViewController: AGSGeoViewTouchDelegate {

    func geoView(_ geoView: AGSGeoView, didTapAtScreenPoint screenPoint: CGPoint, mapPoint: AGSPoint) {

        addTarget(point: mapPoint)

    }

    func geoView(_ geoView: AGSGeoView, didLongPressAtScreenPoint screenPoint: CGPoint, mapPoint: AGSPoint) {

        setObserver(point: mapPoint)

    }

    func geoView(_ geoView: AGSGeoView, didMoveLongPressToScreenPoint screenPoint: CGPoint, mapPoint: AGSPoint) {

        setObserver(point: mapPoint)

    }

    func geoView(_ geoView: AGSGeoView, didEndLongPressAtScreenPoint screenPoint: CGPoint, mapPoint: AGSPoint) {

        setObserver(point: mapPoint)

    }

    func geoViewDidCancelLongPress(_ geoView: AGSGeoView) {

        clearObserver()

    }

}

In the setupScene() method, assign ViewController to sceneView.touchDelegate.

This step connects the sceneView user touch interactions with ViewController via the AGSGeoViewTouchDelegate protocol.

ViewController.swift
Expand
Use dark colors for code blocks
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
33
34
35
36
37
38
39
40
41
42
43
44
45
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
46
Add line.    private func setupScene() {
        let scene: AGSScene = {
            let portal = AGSPortal.arcGISOnline(withLoginRequired: false)

            let item = AGSPortalItem(portal: portal, itemID: "7558ee942b2547019f66885c44d4f0b1")

            return AGSScene(item: item)
        }()
        sceneView.scene = scene

        sceneView.touchDelegate = self

    }
Expand

Run the app

Press Command + R to run the app.

If you are using the Xcode simulator your system must meet these minimum requirements: macOS Big Sur 11.3, Xcode 13, iOS 13. If you are using a physical device, then refer to the system requirements.

You should see a scene of hotspots in the Yosemite Valley. Long-press and drag to set the location of the observer and tap to add target locations. The application performs and displays line of sight analyses between the observer and its targets.

What's next?

Learn how to use additional API features, ArcGIS location services, and ArcGIS tools in these tutorials: