The SDK demo app on GitHub supplied with the Maps SDK for iOS includes samples for the feature highlights of the SDK. Examine the code in the demo app to see how each sample is implemented. Import and build the app, add your API key, view the demo, and use the sample code supplied as a starting point for your app.
When you run the sample app, it displays a list of available samples that you can run on your own device. Select one of the options.
Run the full sample app locally
The Maps SDK for iOS sample app is available as a download archive from GitHub. Follow these steps to install and try the Maps SDK for iOS sample app.
- Download the code sample archive from GitHub and unpack the archive.
Open a terminal window, navigate to the directory where you expanded the sample files, and drill down into the GoogleMaps directory:
Swift
cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
pod install
open GoogleMapsSwiftDemos.xcworkspace
Objective-C
cd maps-sdk-for-ios-samples-main/GoogleMaps
pod install
open GoogleMapsDemos.xcworkspace
- In Xcode, press the compile button to
build the app
with the current scheme. The build produces an error, prompting you to enter your API key
in the
SDKConstants.swift
file for Swift orSDKDemoAPIKey.h
file for Objective-C. - If you don't yet have an API key, follow the
instructions to set up
a project on the Google Cloud Console and get an API key. When configuring the
key on the Cloud Console, you can
restrict the key to the
sample app's bundle identifier to
ensure that only your app can use the key. The default bundle identifier of
the SDK samples app is
com.example.GoogleMapsDemos
. - Edit the
SDKConstants.swift
file for Swift orSDKDemoAPIKey.h
file for Objective-C and paste your API key into the definition of either theapiKey
orkAPIKey
constant. For example:Swift
static let apiKey = "YOUR_API_KEY"
Objective-C
static NSString *const kAPIKey = @"YOUR_API_KEY";
- Remove the following line, because it's used to register the user-defined issue:
Swift
#error (Register for API Key and insert here. Then delete this line.)
Objective-C
#error Register for API Key and insert here.
- Build and run the project. The iOS simulator window appears, showing a list of Maps SDK Demos.
- Choose one of the options displayed, to experiment with a feature of the Maps SDK for iOS.
- If prompted to allow GoogleMapsDemos to access your location, choose Allow.