Xcode プロジェクトを設定する

Swift Package Manager

Maps SDK for iOS は Swift Package Manager からインストールできます。この SDK を追加するには、既存の Maps SDK for iOS の依存関係をすべて削除してください。

新規または既存のプロジェクトに SDK を追加する手順は次のとおりです。

1. Xcode project または workspace を開き、[File] > [Add Package Dependencies] に移動します。
2. URL として「https://github.com/googlemaps/ios-maps-sdk」と入力し、Enter キーを押してパッケージを取得して、[Add Package] をクリックします。
3. 特定の version をインストールするには、[依存関係ルール] フィールドをバージョン ベースのオプションのいずれかに設定します。新しいプロジェクトの場合は、最新バージョンを指定して [正確なバージョン] オプションを使用することをおすすめします。完了したら、[Add Package] をクリックします。
4. [Choose Package Products] ウィンドウで、GoogleMaps（9.0.0 より前のバージョンの場合は、GoogleMaps、GoogleMapsBase、GoogleMapsCore）が指定の main ターゲットに追加されることを確認します。完了したら、[Add Package] をクリックします。
5. インストールを確認するには、ターゲットの General ペインに移動します。[Frameworks, Libraries, and Embedded Content] に、インストールされたパッケージが表示されます。 [Project Navigator] の [Package Dependencies] セクションで、パッケージとそのバージョンを確認することもできます。

既存のプロジェクトの package を更新する手順は次のとおりです。

1. 9.0.0 より前のバージョンからアップグレードする場合は、アップグレード後に GoogleMapsBase、GoogleMapsCore、GoogleMapsM4B の依存関係を削除する必要があります。GoogleMaps の依存関係は削除しないでください。詳細については、バージョン 9.0.0 リリースノートをご覧ください。

   Xcode のプロジェクト構成で、[Frameworks, Libraries, and Embedded Content] を見つけます。マイナス記号（-）を使用して、次のフレームワークを削除します。

   • GoogleMapsBase（9.0.0 より前のバージョンからのアップグレードのみ）
   • GoogleMapsCore（9.0.0 より前のバージョンからのアップグレードのみ）
   • GoogleMapsM4B（9.0.0 より前のバージョンからのアップグレードのみ）
2. Xcode で、[File] > [Packages] > [Update To Latest Package Versions] に移動します。
3. インストールを確認するには、Project Navigator の [Package Dependencies] セクションに移動し、パッケージとそのバージョンを確認します。

CocoaPods を使用して追加された既存の Maps SDK for iOS 依存関係を削除する手順は次のとおりです。

1. Xcode ワークスペースを閉じます。ターミナルを開いて、次のコマンドを実行します。

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. Podfile、Podfile.resolved、Xcode の workspace を CocoaPods 以外に使用していない場合は、削除します。

1. Xcode のプロジェクト構成で、[Frameworks, Libraries, and Embedded Content] を見つけます。マイナス記号（-）を使用して、次のフレームワークを削除します。
   • GoogleMaps
   • GoogleMapsBase（バージョン 9.0.0 より前のインストールのみ）
   • GoogleMapsCore（バージョン 9.0.0 より前のインストールのみ）
   • GoogleMapsM4B（バージョン 9.0.0 より前のインストールのみ）
2. Xcode プロジェクトの最上位ディレクトリから、GoogleMaps バンドルを削除します。

CocoaPods

Maps SDK for iOS は CocoaPods ポッドとして提供されています。CocoaPods は、Swift と Objective-C の Cocoa プロジェクトで依存関係を管理するためのオープンソース ツールです。

CocoaPods ツールがない場合は、ターミナルから以下のコマンドを実行して、macOS 上に CocoaPods ツールをインストールします。詳しくは、CocoaPods スタートガイドをご覧ください。

sudo gem install cocoapods

Maps SDK for iOS の Podfile を作成し、これを使用して API とその依存関係をインストールします。

1. Xcode プロジェクトがまだない場合は、ここで作成してローカルマシンに保存します。iOS 開発を初めて行う場合:
   1. 新しいプロジェクトを作成する。
   2. [iOS] > [App] テンプレートを選択します。
   3. プロジェクト オプション画面で次の操作を行います。
      1. [Project Name] を入力します。
      2. [バンドル ID] フィールドの値を記録します。この値を使用して、以下の API キーを制限できます。
      3. プロジェクトの [Interface] を [Storyboard] に設定します。
      4. [言語] を [Swift] または [Objective-C] に設定します。
2. プロジェクトのディレクトリに、Podfile という名前のファイルを作成します。このファイルでプロジェクトの依存関係を定義します。
3. Podfile を編集して、依存関係とそのversionsを追加します。Maps SDK for iOS に必要な依存関係の例を次に示します。

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleMaps', '8.4.0'
   end
   

   pod outdated を定期的に実行して新しいバージョンが検出されると、常に最新の状態に保たれます。必要に応じて、最新バージョンにアップグレードしてください。
4. Podfile を保存します。

5. ターミナルを開き、Podfile を含むディレクトリに移動します。

   cd <path-to-project>

6. pod install コマンドを実行します。Podfile で指定した API とその依存関係がインストールされます。

   pod install

7. Xcode を終了し、プロジェクトの .xcworkspace ファイルを（ダブルクリックして）開いて、Xcode を起動します。これ以降、このプロジェクトを開くには .xcworkspace ファイルを使用する必要があります。

既存のプロジェクトの API を更新する手順は次のとおりです。

1. ターミナルを開き、Podfile を含むプロジェクト ディレクトリに移動します。
2. pod update コマンドを実行します。これにより、Podfile で指定されたすべての API が最新バージョンに更新されます。

手動インストール

1. 次の SDK バイナリとリソース ファイルをダウンロードします。
   • GoogleMaps
   • GoogleMapsBase
   • GoogleMapsCore
   • Google マップ M4B
   • GoogleMapsResources
2. ファイルを解凍して、XCFrameworks とリソースにアクセスします。
3. Xcode プロジェクトがまだない場合は、ここで作成してローカルマシンに保存します。iOS 開発を初めて行う場合:
   1. 新しいプロジェクトを作成する。
   2. [iOS] > [App] テンプレートを選択します。
   3. プロジェクト オプション画面で次の操作を行います。
      1. [Project Name] を入力します。
      2. [バンドル ID] フィールドの値を記録します。この値を使用して、以下の API キーを制限できます。
      3. プロジェクトの [Interface] を [Storyboard] に設定します。
      4. [言語] を [Swift] または [Objective-C] に設定します。
4. [全般] タブを開きます。次の XCFrameworks を、プロジェクトの [フレームワーク、ライブラリ、埋め込みコンテンツ] にドラッグします。XCFramework ごとに [Do Not Embed] を選択します。
   • GoogleMaps.xcframework
   • GoogleMapsBase.xcframework
   • GoogleMapsCore.xcframework
5. ダウンロードした GoogleMapsResources から Xcode プロジェクトの最上位ディレクトリに GoogleMaps.bundle をコピーします。プロンプトが表示されたら、[Copy items into destination group's folder] を選択してください。
6. プロジェクト ナビゲータからプロジェクトを選択し、アプリのターゲットを選択します。
7. アプリケーションのターゲットの [Build Phases] タブを開きます。[Link Binary with Libraries] 内で、次のフレームワークとライブラリを追加します。
   • Accelerate.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework（OpenGL を使用している場合のみ）
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. 特定のターゲットではなくプロジェクトを選択し、[Build Settings] タブを開きます。[Linking - General] -> [Other Linker Flags] セクションで、[Debug] と [Release] に -ObjC を追加します。これらの設定が表示されない場合は、[Build Settings] バーのフィルタを [Basic] から [All] に変更します。

9. Places SDK for iOS XCFramework をインストールするには、Places SDK for iOS のスタートガイドをご覧ください。

Swift

次のように、API キーを AppDelegate.swift に追加します。

1. 次の import ステートメントを追加します。

   import GoogleMaps

2. API キーを使用して、application(_:didFinishLaunchingWithOptions:) メソッドに以下を追加します:

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. Places API も使用している場合は、次のようにキーをもう一度追加します。

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

次のように、API キーを AppDelegate.m に追加します。

1. 次の import ステートメントを追加します。

   @import GoogleMaps;

2. API キーを使用して、application:didFinishLaunchingWithOptions: メソッドに以下を追加します:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. Places API も使用している場合は、次のようにキーをもう一度追加します。

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Swift

/*
 *   Copyright 2020 Google Inc. All rights reserved.
 *
 *
 *   Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
 *   file except in compliance with the License. You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 *   Unless required by applicable law or agreed to in writing, software distributed under
 *   the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
 *   ANY KIND, either express or implied. See the License for the specific language governing
 *   permissions and limitations under the License.
 */

import UIKit
import GoogleMaps

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        // Create a GMSCameraPosition that tells the map to display the
        // coordinate -33.86,151.20 at zoom level 6.

        let options = GMSMapViewOptions()
        options.camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
        options.frame = self.view.bounds

        let mapView = GMSMapView(options: options)
        self.view.addSubview(mapView)

        // Creates a marker in the center of the map.
        let marker = GMSMarker()
        marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
        marker.title = "Sydney"
        marker.snippet = "Australia"
        marker.map = mapView
  }
}

Objective-C

/*
*   Copyright 2020 Google Inc. All rights reserved.
*
*
*   Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
*   file except in compliance with the License. You may obtain a copy of the License at
*
*   http://www.apache.org/licenses/LICENSE-2.0
*
*   Unless required by applicable law or agreed to in writing, software distributed under
*   the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
*   ANY KIND, either express or implied. See the License for the specific language governing
*   permissions and limitations under the License.
*/

#import "ViewController.h"
#import <GoogleMaps/GoogleMaps.h>

@interface ViewController()

@end

@implementation ViewController

-   (void)viewDidLoad {
  [super viewDidLoad];
  // Do any additional setup after loading the view.
  // Create a GMSCameraPosition that tells the map to display the
  // coordinate -33.86,151.20 at zoom level 6.
  GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
  options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
  options.frame = self.view.bounds;
  GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

  [self.view addSubview:mapView];

  // Creates a marker in the center of the map.
  GMSMarker *marker = [[GMSMarker alloc] init];
  marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
  marker.title = @"Sydney";
  marker.snippet = @"Australia";
  marker.map = mapView;
}

@end