Setup and Demo

Use Swift Package Manager

1. If you don't have an Xcode project yet, create one now and save it to your local machine. (If you're new to iOS development, create a new project and select the iOS App template. On Xcode 11.7 or older, create a Single View Application.)
2. Add the Maps SDK for iOS as a dependency. See Installing the SDK for options.
3. In your Xcode project, navigate to File -> Swift Packages -> Add Package Dependency.
4. In the presented window, enter the Maps SDK for iOS Utility Library repository URL https://github.com/googlemaps/google-maps-ios-utils and select Next.

• At this point, you may be prompted to authenticate with your GitHub account. Follow the instructions to create a GitHub personal access token to continue the process.

Use CocoaPods

1. If you don't have an Xcode project yet, create one now and save it to your local machine. (If you're new to iOS development, create a Single View Application.)
2. If you don't already have a pod file for your project, create a file named Podfile in your project directory. This file defines your project's dependencies.
3. Edit your project's pod file and add a dependency on the Google-Maps-iOS-Utils pod. Here is an example which includes the dependencies you need for the Maps SDK for iOS and the utility library:

   source 'https://github.com/CocoaPods/Specs.git'
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '9.0.0'
     pod 'Google-Maps-iOS-Utils', '6.0.0' # x-release-please-version
   end

4. Run pod install.
5. Close Xcode, and then open (double-click) your project's .xcworkspace file to launch Xcode. From this time onwards, you must use the .xcworkspace file to open the project.

Note: The marker clustering utility is dependent on the quadtree, but you can use the quadtree without marker clustering. If you want only the quadtree utility, you can change pod 'Google-Maps-iOS-Utils' to 'Google-Maps-iOS-Utils/QuadTree' in your pod file.

Use files from GitHub

1. Download the code sample archive from GitHub and unpack the archive.
2. Open a terminal window, navigate to the directory where you expanded the sample files, and drill down into the appropriate samples directory for the language you want to use:
   • For Swift, run cd google-maps-ios-utils-master/samples/SwiftDemoApp
   • For Objective-C, run cd google-maps-ios-utils-master/samples/ObjCDemoApp
3. Run the following command:
   

   pod install

4. Close Xcode, and then open (double-click) your project's .xcworkspace file to launch Xcode. From this time onwards, you must use the .xcworkspace file to open the project.

Use CocoaPods v1.6.1

1. Open a terminal window and install version 1.6.1:

   sudo gem install cocoapods -v1.6.1

2. Fetch the Google Maps files using Cocoapods:

   pod try Google-Maps-iOS-Utils

   Choose either Swift or Objective-C when prompted. CocoaPods updates your spec repositories, then opens the demo in a temporary Xcode project named SwiftDemoApp.xcodeproj or ObjCDemoApp.xcodeproj.

Swift

Add your API key to your AppDelegate.swift as follows:

1. Add the following import statement:

   import GoogleMaps

2. Edit the following line to add your API key between the double quotes:

   // Change this key to a valid key registered with the demo app bundle id.
   let mapsAPIKey = ""

Objective-C

Add your API key to your AppDelegate.m as follows:

1. Add the following import statement:

   @import GoogleMaps;

2. Edit the following line to add your API key between the double quotes:

   // Change this key to a valid key registered with the demo app bundle id.
   static NSString *const kMapsAPIKey = @"";