Maps SDK for iOS sample code

The Maps SDK for iOS repository on GitHub contains samples illustrating the use of the Maps SDK for iOS in your iOS app. The sample app contains code for feature highlights of the SDK, and can be used starting point for your app.

Maps SDK for iOS samples list

Key sample activities from the demo app are listed below and reproduced at the linked pages for quick reference. See the GitHub samples folder for the full list of available samples.

• Display a basic map
• Display an info window for a marker
• Add a marker to a map
• Reverse geocode a location
• Enable and disable map gestures
• Handle marker events
• Enable the My Location Button
• Draw polygons on a map
• Draw polylines on a map

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.

1. Run git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git to clone the samples repository into a local directory.

2. Open a terminal window, navigate to the directory where you cloned 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 
   

3. 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 or SDKDemoAPIKey.h file for Objective-C.
4. Get an API key from your project with the Maps SDK for iOS enabled .
5. Edit the SDKConstants.swift file for Swift or SDKDemoAPIKey.h file for Objective-C and paste your API key into the definition of either the apiKey or kAPIKey constant. For example:

   Swift

    static 
     
    let 
     
    apiKey 
     
    = 
     
    " YOUR_API_KEY 
   " 
   

   Objective-C

    static 
     
    NSString 
     
    * 
    const 
     
    kAPIKey 
     
    = 
     
    @" YOUR_API_KEY 
   " 
    ; 
   

6. In the SDKConstants.swift file (Swift) or SDKDemoAPIKey.h file (Objective-C), 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. 
   

7. Build and run the project. The iOS simulator window appears, showing a list of Maps SDK Demos.
8. Choose one of the options displayed, to experiment with a feature of the Maps SDK for iOS.
9. If prompted to allow GoogleMapsDemos to access your location, choose Allow.