Display a Map

Now that we have the prerequisite API keys, and the project set up, we can start adding basic functionality to the app. We will start by having the app display a map.

Display a Map with MapsIndoors​

Examples

1. Check out this Github repo for the full Getting Started code: iOS v4 Getting Started.

2. Note: Later in the Examples, Map Engine and Map Provider can refer to Google Maps and/or Mapbox.

In order to accomplish this we will be utilizing the MPMapControl Class and adding code to initialize MapsIndoors and show a map.

Import MapsIndoors and use MPMapControl

Mapbox

Within the ViewController class, make the following changes:

https://github.com/MapsPeople/MapsIndoorsGettingStarted-Mapbox/blob/12aaf3c15d8516842e76effddec95416f3a7e3c4/MapsIndoorsGettingStarted-Mapbox/ViewController.swift#L1-L52

import MapboxMaps
import MapsIndoorsCore
import MapsIndoorsMapbox
import UIKit

class ViewController: UIViewController {

    var mapView: MapView!
    var mapControl: MPMapControl?

    override func viewDidLoad() {
        super.viewDidLoad()
        setupMapboxView()

        Task {
            do {
                // Load MapsIndoors with the MapsIndoors API key.
                try await MPMapsIndoors.shared.load(apiKey: AppDelegate.mApiKey)

                // Initialize the MPMapConfig with the Mapbox map view. A MPMapConfig is needed to initialise a MPMapsIndoors map control – to interact with the map.
                let mapConfig = MPMapConfig(mapBoxView: mapView, accessToken: "mapBoxApiKey")
                mapConfig.setShowRoadLabels(show: false)
                mapConfig.setMapsIndoorsTransitionLevel(zoom: 16)
                if let mapControl = MPMapsIndoors.createMapControl(mapConfig: mapConfig) {
                    // Retain the mapControl object, or lose the ability to interact with the map
                    self.mapControl = mapControl

                    // Create a query to locate a specific Location
                    let query = MPQuery()
                    let filter = MPFilter()

                    query.query = "The Crow"
                    filter.take = 1

                    let locations = await MPMapsIndoors.shared.locationsWith(query: query, filter: filter)
                    if let firstLocation = locations.first {
                        mapControl.goTo(entity: firstLocation)
                        mapControl.select(location: firstLocation, behavior: .default)
                        // Set the origin for directions to "The Crow" meeting room
                        origin = firstLocation
                    }
                }
            } catch {
                print("Error loading MapsIndoors: \(error.localizedDescription)")
            }
        }

        // Set up UI for search bar, table view for search results, and buttons to toggle live data
        ExampleUI.create(parentView: view, searchDelegate: self)
        tableView.dataSource = self
        tableView.delegate = self
    }

Google Maps

The MPMapControl Class is the connective class between the Map Engine and MapsIndoors. It allows the two services to collaborate by overlaying the MapsIndoors information over the Map Engine information.

We have now added a very simple, non-interactive search feature! Running the app now should yield a combined map of The White House, showing both the external and internal geographical information. However, let us try and understand what is actually happening.

Expected Result​

Feel free to change the query from the solution "mapspeople3d" to a known building in your MapsIndoors dataset.

Next, let us look into how we can add a search feature and interact with it. We set up a Query and Filter based on the MPQuery Class and MPFilter Class, respectively. These serve as our search specifications. Finally, we call the MPMapsIndoors.shared.locationsWith(query:filter:) method, which searches through the full collection of locations based on our previously established query and filter. We then select the desired location and floor index on the map using the mapControl instance. This handles the selection for MapsIndoors.