View inWPFWinUIMAUIUWPView on GitHubSample viewer app
Perform a line of sight analysis between two points in real time.
Use case
A line of sight analysis can be used to assess whether a view is obstructed between an observer and a target. Obstructing features could either be natural, like topography, or man-made, like buildings. Consider an events planning company wanting to commemorate a national event by lighting sequential beacons across hill summits or roof tops. To guarantee a successful event, ensuring an unobstructed line of sight between neighboring beacons would allow each beacon to be activated as intended.
How to use the sample
Tap to place the starting point for the line. Tap again to place the end point.
How it works
Create an AnalysisOverlay and add it to the scene view.
Create a LocationLineOfSight with initial observer and target locations and add it to the analysis overlay.
Listen for taps on the scene view.
Update the target location with lineOfSight.TargetLocation = scenePoint.
Relevant API
AnalysisOverlay
LocationLineOfSight
SceneView
Tags
3D, line of sight, visibility, visibility analysis
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
// 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.using Esri.ArcGISRuntime.Geometry;
using Esri.ArcGISRuntime.Mapping;
using Esri.ArcGISRuntime.UI.GeoAnalysis;
using System;
using System.Drawing;
namespaceArcGIS.WPF.Samples.LineOfSightLocation{
[ArcGIS.Samples.Shared.Attributes.Sample(
name: "Line of sight (location)",
category: "Analysis",
description: "Perform a line of sight analysis between two points in real time.",
instructions: "Tap to place the starting point for the line. Tap again to place the end point.",
tags: new[] { "3D", "line of sight", "visibility", "visibility analysis" })]
publicpartialclassLineOfSightLocation {
// URL for an image service to use as an elevation sourceprivatestring _elevationSourceUrl = @"https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer";
// Location line of sight analysisprivate LocationLineOfSight _lineOfSightAnalysis;
// Observer location for line of sightprivate MapPoint _observerLocation;
// Target location for line of sightprivate MapPoint _targetLocation;
// Offset (meters) to use for the observer/target height (z-value for the points)privatedouble _zOffset = 2.0;
publicLineOfSightLocation() {
InitializeComponent();
// Create the Scene, basemap, line of sight analysis, and analysis overlay Initialize();
// Handle taps on the scene view to define the observer or target point for the line of sight MySceneView.GeoViewTapped += SceneViewTapped;
}
privatevoidInitialize() {
// Create a new Scene with an imagery basemap Scene myScene = new Scene(BasemapStyle.ArcGISImageryStandard);
// Create an elevation source for the Scene ArcGISTiledElevationSource elevationSrc = new ArcGISTiledElevationSource(new Uri(_elevationSourceUrl));
myScene.BaseSurface.ElevationSources.Add(elevationSrc);
// Add the Scene to the SceneView MySceneView.Scene = myScene;
// Set the viewpoint with a new camera Camera newCamera = new Camera(new MapPoint(-121.7, 45.4, SpatialReferences.Wgs84), 10000, 0, 45, 0);
MySceneView.SetViewpointCameraAsync(newCamera);
// Create a new line of sight analysis with arbitrary points (observer and target will be defined by the user) _lineOfSightAnalysis = new LocationLineOfSight(new MapPoint(0.0, 0.0, SpatialReferences.Wgs84), new MapPoint(0.0, 0.0, SpatialReferences.Wgs84));
// Set the visible and obstructed colors (default would be green/red)// These are static properties that apply to all line of sight analyses in the scene view LineOfSight.VisibleColor = Color.Cyan;
LineOfSight.ObstructedColor = Color.Magenta;
// Create an analysis overlay to contain the analysis and add it to the scene view AnalysisOverlay lineOfSightOverlay = new AnalysisOverlay();
lineOfSightOverlay.Analyses.Add(_lineOfSightAnalysis);
MySceneView.AnalysisOverlays.Add(lineOfSightOverlay);
}
privatevoidSceneViewTapped(object sender, Esri.ArcGISRuntime.UI.Controls.GeoViewInputEventArgs e) {
// Ignore if tapped out of bounds (e.g. the sky).if (e.Location == null)
{
return;
}
// When the view is tapped, define the observer or target location with the tap point as appropriateif (_observerLocation == null)
{
// Define the observer location (plus an offset for observer height) and set the target to the same point _observerLocation = new MapPoint(e.Location.X, e.Location.Y, e.Location.Z + _zOffset);
_lineOfSightAnalysis.ObserverLocation = _observerLocation;
_lineOfSightAnalysis.TargetLocation = _observerLocation;
// Clear the target location (if any) so the next click will define the target _targetLocation = null;
}
elseif (_targetLocation == null)
{
// Define the target _targetLocation = new MapPoint(e.Location.X, e.Location.Y, e.Location.Z + _zOffset);
_lineOfSightAnalysis.TargetLocation = _targetLocation;
// Clear the observer location so it can be defined again _observerLocation = null;
}
}
}
}