You're all set!

To start developing, please head over to our developer documentation.

Activate the Google Maps SDK for iOS

To get you started we'll guide you through the Google Developers Console to do a few things first:

  1. Create or choose a project
  2. Activate the Google Maps SDK for iOS
  3. Create appropriate keys

Code Samples Overview

The SDK demo app supplied with the Google Maps SDK for iOS includes samples for the feature highlights of the SDK. In addition, you can find code snippets on each page of this developer's guide.

Try the SDK demos using CocoaPods

The Google Maps SDK for iOS is available as a CocoaPods pod. CocoaPods is an open source dependency manager for Swift and Objective-C Cocoa projects.

The Google Maps SDK for iOS supplies an SDK demo app that you can install and run using the pod try GoogleMaps command. Follow these steps to install CocoaPods and try the Google Maps SDK for iOS.

  1. If you don't already have the CocoaPods tool, install it on macOS by running the following command from the terminal. For details, see the CocoaPods Getting Started guide.
    sudo gem install cocoapods
  2. Open a terminal window and run the following command:
    pod try GoogleMaps

    CocoaPods updates your spec repositories, then opens the SDK demos in a temporary Xcode project, GoogleMapsDemos.xcworkspace.

  3. In Xcode, press the compile button to build and then run the current scheme. The build produces an error, prompting you to enter your API key in the SDKDemoAPIKey.h file.
  4. If you don't yet have an API key, follow the instructions to set up a project on the Google API Console and get an API key. When configuring the key on the Google API Console, you can specify your 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.
  5. Edit the SDKDemoAPIKey.h file and paste your API key into the definition of the kAPIKey constant. For example:
    static NSString *const kAPIKey = @"YOUR_API_KEY";
  6. If Xcode prompts you to unlock the SDKDemoAPIKey.h file for editing, choose Unlock.
  7. Remove the following line, because it's used to register the user-defined issue:
    #error Register for API Key and insert here.
  8. Build and run the project. The iOS simulator window appears, showing a list of Maps SDK Demos.
  9. Choose one of the options displayed, to experiment with a feature of the Google Maps SDK for iOS.
  10. If prompted to allow GoogleMapsDemos to access your location, choose Allow.

Use code snippets from the developer's guide

Each page in the developer's guide includes code snippets illustrating a particular feature of the API. For example, see the guides for map objects, markers, shapes, and other pages in this guide.

Send feedback about...

Google Maps SDK for iOS
Google Maps SDK for iOS
Need help? Visit our support page.