Expose platform bindings for Indoor API and setup iOS Example (#7635)

**Content**
- Generate experimental Swift(!) API for IndoorManager and make it
separate from the map to allow that
- Setup backbones of IndoorManager example in iOS ExampleApp to
facilitate testing
- Add Swift build artifact to .gitignore

cc @mapbox/core-sdk
cc @mapbox/maps-ios
cc @mapbox/gl-native

GitOrigin-RevId: 6bd7cc2fd2c5a8ecad237542967e77cb8e104207

Author: aleksproger

Examples.xcodeproj/project.pbxproj

@@ -4,6 +4,8 @@
 	classes = {
 	};
 	objectVersion = 63;
+	objectVersion = 54;
+	objectVersion = 77;
 	objects = {
 
 /* Begin PBXBuildFile section */
@@ -36,6 +38,8 @@
 		2997D21A7DB20098C6D03D3B /* StandardStyleImportExample.swift in Sources */ = {isa = PBXBuildFile; fileRef = 640198169EEDFC7CBEFCFCCF /* StandardStyleImportExample.swift */; };
 		2B44F3E8EF3A50D9AE6B825F /* route.geojson in Resources */ = {isa = PBXBuildFile; fileRef = 450C8D5E4B84428FE51BCA97 /* route.geojson */; };
 		2C03342240D5487880316518 /* AddOneMarkerSymbolExample.swift in Sources */ = {isa = PBXBuildFile; fileRef = 4DCBE814694CF08A9C2E4A42 /* AddOneMarkerSymbolExample.swift */; platformFilter = ios; };
+		2C03342240D5487880316518 /* AddOneMarkerSymbolExample.swift in Sources */ = {isa = PBXBuildFile; fileRef = 4DCBE814694CF08A9C2E4A42 /* AddOneMarkerSymbolExample.swift */; platformFilters = (ios, ); };
+		2D3DF43CEE3D4C2B0B012E0E /* IndoorExample.swift in Sources */ = {isa = PBXBuildFile; fileRef = F1109CA9B9EDD4DEB302501A /* IndoorExample.swift */; platformFilters = (ios, ); };
 		2EC3AAE5D54ACFB90E98CD43 /* ElevatedLineMapView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 09BBD2991186A6B98F730454 /* ElevatedLineMapView.swift */; };
 		30589E5AB307FC934E466332 /* radar2.gif in Resources */ = {isa = PBXBuildFile; fileRef = D8730F8FB259A4F889609108 /* radar2.gif */; };
 		312CE7CED726F0A572301622 /* PinView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 6DC3D7884D057238010CB6E4 /* PinView.swift */; };
@@ -384,6 +388,7 @@
 		F033C8EFB89A90D6705B047D /* GeoJSONSourceExample.geojson */ = {isa = PBXFileReference; lastKnownFileType = text; path = GeoJSONSourceExample.geojson; sourceTree = "<group>"; };
 		F0A6063E57EC170F558A3F74 /* ExampleTableViewController.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ExampleTableViewController.swift; sourceTree = "<group>"; };
 		F0CE51977FA6E83B6F11BE5C /* Examples.app */ = {isa = PBXFileReference; includeInIndex = 0; lastKnownFileType = wrapper.application; path = Examples.app; sourceTree = BUILT_PRODUCTS_DIR; };
+		F1109CA9B9EDD4DEB302501A /* IndoorExample.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = IndoorExample.swift; sourceTree = "<group>"; };
 		F1356FEA44593D43FBC3F74B /* ColorPaletteView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ColorPaletteView.swift; sourceTree = "<group>"; };
 		F26EC4DB977D4C2DDBCA1924 /* MarkersExample.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MarkersExample.swift; sourceTree = "<group>"; };
 		F393DF039D7AD2F35C8DE4CE /* ViewExtensions.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ViewExtensions.swift; sourceTree = "<group>"; };
@@ -761,6 +766,7 @@
 				50F519EC4AF0B4BEE0FDCABC /* ColorThemeMapExample.swift */,
 				8DBF737C9C7FBF46BB5F7B78 /* CombineExample.swift */,
 				A4EE8F38428A64B5B9D4DBBE /* CombineLocationExample.swift */,
+				F1109CA9B9EDD4DEB302501A /* IndoorExample.swift */,
 				60A8CD8A69D3429FCF8ACBDD /* Lights3DExample.swift */,
 				370DFCA52EB6C7F119BF81DA /* MapEventsExample.swift */,
 				E612275E3042D0D0AF8B583E /* MapRecorderExample.swift */,
@@ -880,6 +886,8 @@
 				AC4B0DE570C38B503D03669A /* XCRemoteSwiftPackageReference "Fingertips" */,
 				4F0A03F138FCA51E80A1893D /* XCLocalSwiftPackageReference "." */,
 			);
+			preferredProjectObjectVersion = 54;
+			preferredProjectObjectVersion = 77;
 			projectDirPath = "";
 			projectRoot = "";
 			targets = (
@@ -1051,6 +1059,7 @@
 				0414AD72988F405F5BA1D843 /* GlobeFlyToExample.swift in Sources */,
 				49F6209402BF34C06C90107A /* HeatmapLayerGlobeExample.swift in Sources */,
 				B9B1EE72E6203358F2785916 /* IconSizeChangeExample.swift in Sources */,
+				2D3DF43CEE3D4C2B0B012E0E /* IndoorExample.swift in Sources */,
 				423A42B555DD0B3AD4856FCF /* InsetMapExample.swift in Sources */,
 				94DB7E8C829041DC5F5B2300 /* InstrumentClusterCarPlaySceneDelegate.swift in Sources */,
 				AD0922FA7F69AEE4C23F2351 /* InteractionsPlayground.swift in Sources */,

Sources/Examples/All Examples/Lab/IndoorExample.swift

@@ -0,0 +1,39 @@
+import UIKit
+@_spi(Experimental) import MapboxMaps
+
+// EXPERIMENTAL: Not intended for usage in current stata. Subject to change or deletion.
+final class IndoorExample: UIViewController, ExampleProtocol {
+    private var mapView: MapView!
+    // Set indoor style. Do not commit staging style URIs.
+    private var styleURI: String?
+
+    override func viewDidLoad() {
+        super.viewDidLoad()
+
+        let cameraOptions = CameraOptions(
+            center: CLLocationCoordinate2D(latitude: 40.6441, longitude: -73.7824),
+            zoom: 16,
+            bearing: 12,
+            pitch: 60)
+        let options = MapInitOptions(cameraOptions: cameraOptions)
+
+        mapView = MapView(frame: view.bounds, mapInitOptions: options)
+        mapView.mapboxMap.styleURI = StyleURI(rawValue: styleURI!)!
+
+        mapView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
+        mapView.ornaments.options.scaleBar.visibility = .visible
+        // EXPERIMENTAL: Not intended for usage in current stata. Subject to change or deletion.
+        // mapView.mapboxMap.indoor.selectFloor(selectedFloorId: "b937e2aa3423453ab0552d9f")
+        // mapView.mapboxMap.indoor.onIndoorUpdate { indoorState in
+        //     print(indoorState)
+        // }
+
+        view.addSubview(mapView)
+    }
+
+    override func viewDidAppear(_ animated: Bool) {
+        super.viewDidAppear(animated)
+        // The below line is used for internal testing purposes only.
+        finish()
+    }
+}

Sources/Examples/Models/Examples.swift

@@ -150,6 +150,9 @@ struct Examples {
         Example(title: "Edit polygon with drag/drop",
                 description: "Shows how to update a polygon with drag",
                 type: EditPolygonExample.self)
+        Example(title: "Display an indoor map",
+                description: "Create and display a map that uses the indoor data and renders it.",
+                type: IndoorExample.self)
     }
 
     // Examples that focus on displaying the user's location.

Sources/MapboxMaps/Documentation.docc/API Catalogs/Indoor.md

@@ -0,0 +1,9 @@
+#  Indoor
+
+## Topics
+
+### Indoor
+
+- ``IndoorFloor``
+- ``IndoorState``
+- ``IndoorManager``

Sources/MapboxMaps/Documentation.docc/Documentation.md

@@ -47,6 +47,7 @@ The Mapbox Maps SDK for iOS is a public library for displaying interactive, thor
 - <doc:Ornaments>
 - <doc:Gestures>
 - <doc:Settings-and-Constants>
+- <doc:Indoor>
 
 
 ### Dependencies

Sources/MapboxMaps/Foundation/MapboxMap.swift

@@ -1,6 +1,6 @@
 // swiftlint:disable file_length
 import UIKit
-@_spi(Internal) @_spi(Marshalling) import MapboxCoreMaps
+@_spi(Internal) @_spi(Marshalling) @_spi(Experimental) import MapboxCoreMaps
 @_implementationOnly import MapboxCommon_Private
 import Turf
 
@@ -200,6 +200,9 @@ public final class MapboxMap: StyleManager {
     @_spi(Internal)
     public lazy var map: MapboxCoreMaps.Map = .Marshaller.toSwift(__map)
 
+    // @_spi(Experimental)
+    // public lazy var indoor: IndoorManager = .Marshaller.toSwift(__map.getIndoorManager())
+
     deinit {
         __map.destroyRenderer()
     }