Set Up Your Environment

Now that you have taken care of all the preliminary issues, we can start building the app. Throughout this guide, you will continously modify this project to extend its functionality to cover a number of basic features.

KNOWN IOS ISSUES

1. Developing on the new Arm-based Apple Silicon (M1) Macs requires building and running on a physical iOS device or using an iOS simulator running iOS 13.7, e.g. iPhone 11. This is a temporary limitation in Google Maps SDK for iOS, and as such also a limitation in MapsIndoors, due to the dependency to Google Maps.

2. Due to a bug in CocoaPods it is necessary to include the post_install hook in your Podfile described in the PodFile post_install wiki.

Create an Xcode Project​

We recommend using Xcode for following along, for this guide we will be using Xcode 13.0. Note that an iOS mobile device is not required, as Xcode allows the use of a simulator. Furthermore, in accordance with the known issues with Google Maps and Arm-based Apple Silicon (M1) Macs, we will be using an iPhone 11 (iOS 13.7) simulator throughout.

We start off by creating an Xcode project using the App template,

For the project settings, you can call it anything you like, however ensure the following settings are set to follow along easier,

• Interface: Storyboard

• Language: Swift

You should now have a project folder with the following files,

For the sake of simplicity we will only be operating on these pre-generated files throughout the guide.

Installing the MapsIndoors SDK​

MapsIndoors can either be installed using CocoaPods (Getting Started with CocoaPods) or through a manual installation.

Cocoapods

Installing MapsIndoors Using CocoaPods​

From MapsIndoors SDK version 3.32.0 and up, in order for CocoaPods to fetch the SDK properly it is necessary to install git-lfs (Install Guide).

1. Create an empty text file named Podfile in your project directory (same folder as your .xcodeproj).

2. Add your dependencies to the Podfile as followed (replace YOUR_APPLICATION_TARGET_NAME_HERE with your project name),

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '15.0' # Replace 15.0 with you iOS Minimum Deployment Target
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
   
     pod 'MapsIndoors', '~>3.50'
   end

3. Add the post_install to the end of the Podfile. (In the line containing pod 'MapsIndoors', '~>3.50', where it currently says 3.50, be sure to replace this number with whatever the latest version of the iOS SDK is.)

4. Save the Podfile and close Xcode.

5. Open a terminal in the directory of the project. cd \<path-to-project>

6. Run pod install in the terminal.

7. From this time onwards, use the .xcworkspace file to open the project.

Manually

Install MapsIndoors Manually​

• Download the Google Maps iOS SDK 4.2.0

• Copy the following frameworks to the folder of your app project (in Finder, not in Xcode)

  • GoogleMaps-4.2.0/Base/Frameworks/GoogleMapsBase.framework

  • GoogleMaps-4.2.0/Maps/Frameworks/GoogleMaps.framework

  • GoogleMaps-4.2.0/Maps/Frameworks/GoogleMapsCore.framework

• Drag the GoogleMaps.bundle from the GoogleMaps.framework/Resources folder into the top level directory of your Xcode project. When prompted, ensure Copy items into destination group's folder is not selected.

• Download and unzip the latest v3 MapsIndoors.xcframework

• Drag and drop the MapsInbdoors XCFramework into your XCode project. In the dialog that pops up, choose “Copy items if needed” and make sure the XCFramework is added to the correct target

• In Xcode, go to "General" and expand "Frameworks, Libraries, and Embedded Content" and make sure the MapsIndoors.xcframework is marked as "Embed & Sign"

• In Xcode, go to "Build Settings" for your target and make sure the following entries are present in the FRAMEWORK_SEARCH_PATHS

  • $(inherited)

  • $(PROJECT_DIR)/**

This "Getting Started" guide is created using a specific version of the SDK. When moving beyond the "Getting Started" guide, please be sure to use the latest version of the SDK.

Adding API Credentials​

Open back up the project and navigate to the file AppDelegate.swift.

1. Add the following import statements to the top of the file,

   import GoogleMaps  
   import MapsIndoors

2. Insert the following into the application(_:didFinishLaunchingWithOptions:) method,

GMSServices.provideAPIKey("YOUR_GOOGLE_API_KEY")  
MapsIndoors.provideAPIKey("YOUR_MAPSINDOORS_API_KEY",  
            googleAPIKey:"YOUR_GOOGLE_API_KEY")

Finally, remember to replace YOUR_GOOGLE_API_KEY with your Google API key and YOUR_MAPSINDOORS_API_KEY with your MapsIndoors API demo key d876ff0e60bb430b8fabb145.