AR: World scale

Examples/Examples.xcodeproj/project.pbxproj

@@ -16,6 +16,7 @@
 		75C37C9227BEDBD800FC9DCE /* BookmarksExampleView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 75C37C9127BEDBD800FC9DCE /* BookmarksExampleView.swift */; };
 		75D41B2B27C6F21400624D7C /* ScalebarExampleView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 75D41B2A27C6F21400624D7C /* ScalebarExampleView.swift */; };
 		882899FD2AB5099300A0BDC1 /* FlyoverExampleView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 882899FC2AB5099300A0BDC1 /* FlyoverExampleView.swift */; };
+		885554952ACB4D9600ECBB4A /* WorldScaleExampleView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 885554942ACB4D9600ECBB4A /* WorldScaleExampleView.swift */; };
 		E42BFBE92672BF9500159107 /* SearchExampleView.swift in Sources */ = {isa = PBXBuildFile; fileRef = E42BFBE82672BF9500159107 /* SearchExampleView.swift */; };
 		E4624A25278CE815000D2A38 /* FloorFilterExampleView.swift in Sources */ = {isa = PBXBuildFile; fileRef = E4624A24278CE815000D2A38 /* FloorFilterExampleView.swift */; };
 		E47ABE442652FE0900FD2FE3 /* ExamplesApp.swift in Sources */ = {isa = PBXBuildFile; fileRef = E47ABE432652FE0900FD2FE3 /* ExamplesApp.swift */; };
@@ -55,6 +56,7 @@
 		75C37C9127BEDBD800FC9DCE /* BookmarksExampleView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BookmarksExampleView.swift; sourceTree = "<group>"; };
 		75D41B2A27C6F21400624D7C /* ScalebarExampleView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ScalebarExampleView.swift; sourceTree = "<group>"; };
 		882899FC2AB5099300A0BDC1 /* FlyoverExampleView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = FlyoverExampleView.swift; sourceTree = "<group>"; };
+		885554942ACB4D9600ECBB4A /* WorldScaleExampleView.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = WorldScaleExampleView.swift; sourceTree = "<group>"; };
 		E42BFBE82672BF9500159107 /* SearchExampleView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SearchExampleView.swift; sourceTree = "<group>"; };
 		E4624A24278CE815000D2A38 /* FloorFilterExampleView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = FloorFilterExampleView.swift; sourceTree = "<group>"; };
 		E47ABE402652FE0900FD2FE3 /* Toolkit Examples.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = "Toolkit Examples.app"; sourceTree = BUILT_PRODUCTS_DIR; };
@@ -110,6 +112,7 @@
 				75230DAD28614369009AF501 /* UtilityNetworkTraceExampleView.swift */,
 				882899FC2AB5099300A0BDC1 /* FlyoverExampleView.swift */,
 				1CC376D32ABA0B3700A83300 /* TableTopExampleView.swift */,
+				885554942ACB4D9600ECBB4A /* WorldScaleExampleView.swift */,
 			);
 			name = Examples;
 			sourceTree = "<group>";
@@ -287,6 +290,7 @@
 				4D19FCB52881C8F3002601E8 /* PopupExampleView.swift in Sources */,
 				882899FD2AB5099300A0BDC1 /* FlyoverExampleView.swift in Sources */,
 				E48A73462658227100F5C118 /* ExampleView.swift in Sources */,
+				885554952ACB4D9600ECBB4A /* WorldScaleExampleView.swift in Sources */,
 				E42BFBE92672BF9500159107 /* SearchExampleView.swift in Sources */,
 				E4C389D526B8A12C002BC255 /* BasemapGalleryExampleView.swift in Sources */,
 				75D41B2B27C6F21400624D7C /* ScalebarExampleView.swift in Sources */,

Examples/Examples/WorldScaleExampleView.swift

@@ -0,0 +1,92 @@
+// Copyright 2023 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 SwiftUI
+import ArcGIS
+import ArcGISToolkit
+import CoreLocation
+
+/// An example that utilizes the `WorldScaleSceneView` to show an augmented reality view
+/// of your current location. Because this is an example that can be run from anywhere,
+/// it places a red circle around your initial location which can be explored.
+struct WorldScaleExampleView: View {
+    @State private var scene: ArcGIS.Scene = {
+        // Creates an elevation source from Terrain3D REST service.
+        let elevationServiceURL = URL(string: "https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer")!
+        let elevationSource = ArcGISTiledElevationSource(url: elevationServiceURL)
+        let surface = Surface()
+        surface.addElevationSource(elevationSource)
+        let scene = Scene()
+        scene.baseSurface = surface
+        scene.baseSurface.backgroundGrid.isVisible = false
+        scene.baseSurface.navigationConstraint = .unconstrained
+        scene.basemap = Basemap(style: .arcGISImagery)
+        return scene
+    }()
+
+    /// Basemap opacity.
+    @State private var opacity: Float = 1
+    /// Graphics overlay to show a graphic around your initial location.
+    @State private var graphicsOverlay = GraphicsOverlay()
+    /// The location datasource that is used to access the device location.
+    @State private var locationDatasSource = SystemLocationDataSource()
+
+    var body: some View {
+        VStack {
+            WorldScaleSceneView { proxy in
+                SceneView(scene: scene, graphicsOverlays: [graphicsOverlay])
+                    .onSingleTapGesture { screen, _ in
+                        print("Identifying...")
+                        Task.detached {
+                            let results = try await proxy.identifyLayers(screenPoint: screen, tolerance: 20)
+                            print("\(results.count) identify result(s).")
+                        }
+                    }
+            }
+            // A slider to adjust the basemap opacity.
+            Slider(value: $opacity, in: 0...1.0)
+                .padding(.horizontal)
+        }
+        .onChange(of: opacity) { opacity in
+            guard let basemap = scene.basemap else { return }
+            for layer in basemap.baseLayers {
+                layer.opacity = opacity
+            }
+        }
+        .task {
+            // Request when-in-use location authorization.
+            // This is necessary for 2 reasons:
+            // 1. Because we use location datasource to get the initial location in this example
+            // in order to display a ring around the initial location.
+            // 2. Because the `WorldScaleSceneView` utilizes a location datasource and that
+            // datasource will not start until authorized.
+            let locationManager = CLLocationManager()
+            if locationManager.authorizationStatus == .notDetermined {
+                locationManager.requestWhenInUseAuthorization()
+            }
+
+            do {
+                try await locationDatasSource.start()
+            } catch {
+                print("Failed to start location datasource: \(error.localizedDescription)")
+            }
+
+            // Retrieve initial location
+            guard let initialLocation = await locationDatasSource.locations.first(where: { _ in true }) else { return }
+
+            // Put a circle graphic around the initial location
+            let circle = GeometryEngine.geodeticBuffer(around: initialLocation.position, distance: 20, distanceUnit: .meters, maxDeviation: 1, curveType: .geodesic)
+            graphicsOverlay.addGraphic(Graphic(geometry: circle, symbol: SimpleLineSymbol(color: .red, width: 3)))
+        }
+    }
+}

Examples/ExamplesApp/Examples.swift

@@ -37,7 +37,8 @@ extension ExampleList {
         name: "Augmented Reality",
         examples: [
             AnyExample("Flyover", content: FlyoverExampleView()),
-            AnyExample("Tabletop", content: TableTopExampleView())
+            AnyExample("Tabletop", content: TableTopExampleView()),
+            AnyExample("World Scale", content: WorldScaleExampleView())
         ]
     )
 

Examples/ExamplesApp/Info.plist

@@ -2,8 +2,8 @@
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
-	<key>NSCameraUsageDescription</key>
-	<string>This app uses augmented reality to overlay imagery over your real-world environment. Camera access is required for this functionality.</string>
+	<key>NSLocationWhenInUseUsageDescription</key>
+	<string>Tracking location in an augmented reality experience.</string>
 	<key>CFBundleDevelopmentRegion</key>
 	<string>$(DEVELOPMENT_LANGUAGE)</string>
 	<key>CFBundleExecutable</key>
@@ -59,6 +59,8 @@
 	<string>1</string>
 	<key>LSRequiresIPhoneOS</key>
 	<true/>
+	<key>NSCameraUsageDescription</key>
+	<string>This app uses augmented reality to overlay imagery over your real-world environment. Camera access is required for this functionality.</string>
 	<key>UIApplicationSceneManifest</key>
 	<dict>
 		<key>UIApplicationSupportsMultipleScenes</key>

Sources/ArcGISToolkit/Components/AR/TableTopSceneView.swift

@@ -84,7 +84,7 @@ public struct TableTopSceneView: View {
         ZStack {
             ARSwiftUIView(proxy: arViewProxy)
                 .onDidUpdateFrame { _, frame in
-                    guard let sceneViewProxy, let interfaceOrientation else { return }
+                    guard let sceneViewProxy, let interfaceOrientation, let initialTransformation else { return }
                     sceneViewProxy.updateCamera(
                         frame: frame,
                         cameraController: cameraController,
@@ -236,27 +236,6 @@ public struct TableTopSceneView: View {
     }
 }
 
-private extension View {
-    /// Sets a closure to perform when a single tap occurs on the view.
-    /// - Parameters:
-    ///   - action: The closure to perform upon single tap.
-    ///   - screenPoint: The location of the tap in the view's coordinate space.
-    func onSingleTapGesture(perform action: @escaping (_ screenPoint: CGPoint) -> Void) -> some View {
-        if #available(iOS 16.0, *) {
-            return self.onTapGesture { screenPoint in
-                action(screenPoint)
-            }
-        } else {
-            return self.gesture(
-                DragGesture()
-                    .onEnded { dragAttributes in
-                        action(dragAttributes.location)
-                    }
-            )
-        }
-    }
-}
-
 private extension ARSwiftUIViewProxy {
     /// Performs a hit test operation to get the transformation matrix representing the corresponding real-world point for `screenPoint`.
     /// - Parameter screenPoint: The screen point to determine the real world transformation matrix from.
@@ -312,26 +291,6 @@ private extension SceneViewProxy {
 
         return initialTransformation
     }
-
-    /// Sets the field of view for the scene view's camera for a given augmented reality frame.
-    /// - Parameters:
-    ///   - frame: The current AR frame.
-    ///   - orientation: The interface orientation.
-    func setFieldOfView(for frame: ARFrame, orientation: InterfaceOrientation) {
-        let camera = frame.camera
-        let intrinsics = camera.intrinsics
-        let imageResolution = camera.imageResolution
-
-        setFieldOfViewFromLensIntrinsics(
-            xFocalLength: intrinsics[0][0],
-            yFocalLength: intrinsics[1][1],
-            xPrincipal: intrinsics[2][0],
-            yPrincipal: intrinsics[2][1],
-            xImageSize: Float(imageResolution.width),
-            yImageSize: Float(imageResolution.height),
-            interfaceOrientation: orientation
-        )
-    }
 }
 
 private extension String {