Sunday, October 25, 2015

Using Google Maps SDK for iOS in Swift

Update: 
December 14, 2015 - Modify step 13 and add step 14 for the V1.11.1 SDK release.
January 7, 2016 - Update step 6 images for the new Google Developers Console interface.
January 13, 2016 - Add more information about CocoaPods at the bottom of this post.
May 27, 2016 - Update Step 3 for CocoaPods 1.0.

This tutorial shows how to add a mapView using Google Maps SDK for iOS and add a segmented control to switch between normal, satellite, and hybrid types. This tutorial is created with Xcode 6.4 and successfully tested with Xcode 7.1.

1. Install CocoaPods. (More information about CocoaPods is written at the bottom of this post.)

Type this command in the terminal:

sudo gem install cocoapods

2. Create an Xcode project and close it.

3. In the Xcode project directory, create a Podfile as below:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'

pod 'GoogleMaps'


(You may open the Podfile with this command: open -a Xcode Podfile)

Update May 27, 2016:

The above code may not work with the new CocoaPods 1.0. If you see error like this:


The dependency `GoogleMaps` is not used in any concrete target.

Try modify your Podfile as below:

target "ProjectName" do
    pod 'GoogleMaps'

end

4. Run the terminal and type the command below in the project directory:

pod install

You may see something like this in the terminal:





5. Open the projectName.xcworkspace file just automatically created. (Don't open the original .xcodeproj file)




You may see the project navigator like this with a new Pods folder:


6. Go to Google Developers Console. Create a new project.  Select the "Products & services" button at the Google Developers Console title.



Select API Manager.


Select Google APIs and enable Google Maps SDK for iOS.

Select Credentials.


Select Add credentials -> API Key. (The image below is the previous interface.)



Select "iOS key" and then name the key.

You may leave the "Accept requests from an iOS application with one of these bundle identifiers" field as blank since it is optional, or fill in your app bundle identifier.

Now you should be able to see your iOS API key.

7. Add a temporary Objective-C file to your project. You may give it any name you like.


Select Yes to configure an Objective-C bridging header. (Update: Select Create Bridging Header.)


Delete the temporary Objective-C file you just created.

8. In the projectName-Bridging-Header.h file just created, add this line:


#import <GoogleMaps/GoogleMaps.h>


9. Edit the AppDelegate.swift file:

    func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
        
        GMSServices.provideAPIKey("AIza....") //iOS API key
        
        return true

    }

10. Modify ViewController.swift as below:

import UIKit

class ViewController: UIViewController, GMSMapViewDelegate {
    
    var mapView : GMSMapView!

    override func viewDidLoad() {
        super.viewDidLoad()
        
        mapView = GMSMapView(frame: CGRectMake(0, 100, view.bounds.width, view.bounds.height - 100))
        
        //Default position at Chungli (Zhongli) Railway Station, Taoyuan, Taiwan.
        mapView.camera = GMSCameraPosition.cameraWithLatitude(24.953232, longitude: 121.225353, zoom: 15.0)
        
        mapView.mapType = kGMSTypeNormal
        mapView.delegate = self
        
        view.addSubview(mapView)
        
        //Add a segmented control for selecting the map type.
        let items = ["Normal", "Satellite", "Hybrid"]
        let segmentedControl = UISegmentedControl(items: items)
        segmentedControl.frame = CGRectMake(50, 60, 200, 20)
        segmentedControl.addTarget(self, action: "mapType:", forControlEvents: UIControlEvents.ValueChanged)
        view.addSubview(segmentedControl)
        
    }
    
    func mapType(sender: UISegmentedControl) {
        switch sender.selectedSegmentIndex {
        case 0:
            mapView.mapType = kGMSTypeNormal
        case 1:
            mapView.mapType = kGMSTypeSatellite
        default:
            mapView.mapType = kGMSTypeHybrid
        }
    }
    
    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
    }
}

11. Edit the Info.plist file (Required for Xcode 7 and iOS 9):

Key: LSApplicationQueriesSchemes
Type: Array

Key: Item 0
Type: String
Value: googlechromes

Key: Item 1
Type: String
Value: comgooglemaps



Without modifying Info.plist, you'll get


Pressing the Google logo on the map in the iOS simulator shows:


canOpenURL: failed for URL: "comgooglemaps://" - error: "This app is not allowed to query for scheme comgooglemaps"


canOpenURL: failed for URL: "googlechromes://" - error: "This app is not allowed to query for scheme googlechromes"

This is because the iOS simulator does not include Google Maps and Chrome apps. So check this feature with a device.


12. Run the iOS simulator and get this:




Update:

December 14, 2015 - Step 13 is no longer required since Google has resolved this issue in SDK V1.11.0 - December 2015. 
Google Maps SDK for iOS Release notes Google Maps API Bug Reports: Bitcode Build

13. Xcode 7.1: If failing to run with iPhone/iPad with this error:


clang: error: linker command failed with exit code 1 (use -v to see invocation)


Try to disable the bitcode:

Targets -> Build Settings -> Build Options -> Enable Bitcode -> No



And build the code again. The build should succeed.

Update:
December 14, 2015 - Add Step 14.

14. The ITMS-90535 error happened during app submission has been resolved in  V1.11.1 SDK, which has updated the GoogleMaps.bundle info.plist file. Make sure that you have downloaded the latest SDK.

Google Maps SDK for iOS Release Notes
Google Maps API Bug Reports: Bug: unexpected CFBundleExecutable Key in GoogleMaps 1.10.1

=============
January 13, 2016

Additional Information

Some CocoaPods commands for reference:

1. Check the CocoaPods version installed:
pod --version

2. Check if CocoaPods framework of a project is outdated:

Go to the directory including the Podfile. Type:

pod outdated



The pod outdated command also checks if new CocoaPods version is available.

3. Update CocoaPods using the install command:

sudo gem install cocoapods

4. Update CocoaPods to a pre-release version:

sudo gem install cocoapods --pre

5. Update local repositories:

pod update



Related Information:

Google Sign-In for iOS - Create a GIDSignInButton programmatically in Swift
Marker Clustering with Google's Utility library for Maps SDK (Google-Maps-iOS-Utils)
Carthage Tutorial -  Reachability.swift

1 comment: