このページは Cloud Translation API によって翻訳されました。

Switch to English

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

課金を有効にして API キーを作成したら、アプリの開発に使用する Xcode プロジェクトを設定する準備が整いました。

手順 1: 必要なソフトウェアをインストールする

Maps SDK for iOS を使ってプロジェクトを作成するには、以下をダウンロードしてインストールする必要があります。

Xcode バージョン 14.0 以降
Cocoapods または Carthage

注: Maps SDK for iOS は Cocoapods または Carthage を使用せずに手動でインストールできますが、ほとんどのデベロッパーはパッケージマネージャーを使用することをおすすめします。

ステップ 2: Xcode プロジェクトを作成し、Maps SDK for iOS をインストールする

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 とその依存関係をインストールします。

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

platform :ios, '14.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '8.0.0'
end
```
常に pod outdated を実行して、新しいバージョンがインストールされていることを検出し、常に最新バージョンであることを確認してください。必要に応じて、最新バージョンにアップグレードしてください。
Podfile を保存します。
ターミナルを開いて、Podfile を含むディレクトリに移動します。
```
cd <path-to-project>
```
pod install コマンドを実行します。Podfile で指定した API とその依存関係がインストールされます。
```
pod install
```
Xcode を終了し、プロジェクトの .xcworkspace ファイルを（ダブルクリックして）開いて、Xcode を起動します。これ以降、このプロジェクトを開くには .xcworkspace ファイルを使用する必要があります。

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

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

Carthage を使用する

Maps SDK for iOS は、Swift および Objective-C Cocoa プロジェクト用のシンプルな分散型依存関係マネージャーである Carthage と併用できます。

Carthage をインストールします。いくつかのメソッドがあります。正確な手順については、Carthage の README ファイルをご覧ください。
Xcode プロジェクトがない場合は、ここで作成してローカルマシンに保存します。iOS 開発が初めての場合:
1. 新しいプロジェクトを作成します。
2. [iOS] > [App] テンプレートを選択します。
3. プロジェクトのオプション画面で、以下の操作を行います。
  1. プロジェクト名を入力します。
  2. [Bundle ID] フィールドの値を記録します。この値を使用して、以下の API キーを制限できます。
  3. プロジェクトの [インターフェース] を [ストーリーボード] に設定します。
  4. [Language] を [Swift] または [Objective-C] に設定します。
プロジェクトのディレクトリに、Cartfile という名前のファイルを作成します。このファイルは、プロジェクトの依存関係を定義します。
Cartfile を編集して、依存関係をバージョンとともに追加します。
```
binary "https://dl.google.com/geosdk/GoogleMaps.json" == 6.2.1
```
carthage outdated を定期的に実行して、新しいバージョンがインストールされていることを検出し、常に最新バージョンであることを確認します。必要に応じて、最新バージョンにアップグレードしてください。
Cartfile を保存します。
ターミナルウィンドウで、Cartfile があるディレクトリに移動します。
```
cd <path-to-project>
```
carthage update コマンドを実行します。Cartfile で指定した API とその依存関係がインストールされます。
Finder のプロジェクトディレクトリで、Carthage/Build/iOS の下にあるダウンロードしたフレームワークファイルに移動します。
次のバンドルをプロジェクトにドラッグします（プロンプトが表示されたら、[Copy items if needed, use using the above?] を選択します）。
- GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.xcframework
- GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.xcframework
- GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.xcframework
- （プレミアムプランのお客様のみ）GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.xcframework
プロジェクトで GoogleMaps.xcframework を右クリックし、[Show In Finder] を選択します。
GoogleMaps.bundle を Resources フォルダから Xcode プロジェクトの最上位ディレクトリにドラッグします。プロンプトが表示されたら、[転送先グループのフォルダにアイテムをコピー] が選択されていないことを確認します。
プロジェクトナビゲータで目的のプロジェクトを選択し、アプリのターゲットを選択します。
アプリのターゲットの [Build Phases] タブを開き、[Link Binary with Libraries で次のフレームワークとライブラリを追加します。
- Accelerate.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
- QuartzCore.framework
- SystemConfiguration.framework
- UIKit.framework
（特定のターゲットではなく）プロジェクトを選択して、[Build Settings] タブを開きます。[Other Linker Flags] セクションで -ObjC を追加します。これらの設定が表示されない場合は、[Build Settings] バーのフィルタを [Basic] から [All] に変更します。
Places SDK for iOS をインストールする方法は、Places SDK for iOS スタートガイドをご覧ください。

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

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

手動でインストールする

このガイドでは、Maps SDK for iOS を手動でプロジェクトに追加し、Xcode でビルド設定を構成する方法について説明します。

SDK のソースファイル GoogleMaps-8.0.0 をダウンロードします。
ダウンロードしたソースファイルを解凍します。
Xcode プロジェクトがない場合は、ここで作成してローカルマシンに保存します。iOS 開発が初めての場合:
1. 新しいプロジェクトを作成します。
2. [iOS] > [App] テンプレートを選択します。
3. プロジェクトのオプション画面で、以下の操作を行います。
  1. プロジェクト名を入力します。
  2. [Bundle ID] フィールドの値を記録します。この値を使用して、以下の API キーを制限できます。
  3. プロジェクトの [インターフェース] を [ストーリーボード] に設定します。
  4. [Language] を [Swift] または [Objective-C] に設定します。
次のバンドルをプロジェクトにドラッグします（プロンプトが表示されたら、[Copy items if needed, use using the above?] を選択します）。
- GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.xcframework
- GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.xcframework
- GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.xcframework
- （プレミアムプランのお客様のみ）GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.xcframework
プロジェクトで GoogleMaps.xcframework を右クリックし、[Show In Finder] を選択します。
GoogleMaps.bundle を Resources フォルダから Xcode プロジェクトの最上位ディレクトリにドラッグします。プロンプトが表示されたら、[転送先グループのフォルダにアイテムをコピー] が選択されていないことを確認します。
プロジェクトナビゲータで目的のプロジェクトを選択し、アプリのターゲットを選択します。
アプリのターゲットの [Build Phases] タブを開き、[Link Binary with Libraries で次のフレームワークとライブラリを追加します。
- Accelerate.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
- QuartzCore.framework
- SystemConfiguration.framework
- UIKit.framework
（特定のターゲットではなく）プロジェクトを選択して、[Build Settings] タブを開きます。[Other Linker Flags] セクションで -ObjC を追加します。これらの設定が表示されない場合は、[Build Settings] バーのフィルタを [Basic] から [All] に変更します。
Places SDK for iOS をインストールする方法は、Places SDK for iOS スタートガイドをご覧ください。

XCFramework をインストールする

XCFramework は、M1 チップセットを使用するマシンなど、複数のプラットフォームで使用できる Maps SDK for iOS のインストールに使用できるバイナリパッケージです。このガイドでは、Maps SDK for iOS を含む XCFramework をプロジェクトに追加し、Xcode でビルド設定を構成する方法について説明します。

Carthage を使用

Maps SDK for iOS は、Swift および Objective-C Cocoa プロジェクト用のシンプルな分散型依存関係マネージャーである Carthage で使用できます。

Carthage をインストールします。いくつかのメソッドがあります。正確な手順については、Carthage の README ファイルをご覧ください。
Xcode プロジェクトがない場合は、ここで作成してローカルマシンに保存します。iOS 開発が初めての場合:
1. 新しいプロジェクトを作成します。
2. [iOS] > [App] テンプレートを選択します。
3. プロジェクトのオプション画面で、以下の操作を行います。
  1. プロジェクト名を入力します。
  2. [Bundle ID] フィールドの値を記録します。この値を使用して、以下の API キーを制限できます。
  3. プロジェクトの [インターフェース] を [ストーリーボード] に設定します。
  4. [Language] を [Swift] または [Objective-C] に設定します。
プロジェクトディレクトリに Cartfile という名前のファイルを作成します。このファイルは、プロジェクトの依存関係を定義します。
Cartfile を編集して、依存関係とそれらのバージョンを追加します。
```
binary "https://dl.google.com/geosdk/GoogleMaps.json" == 6.2.1-beta
```
Cartfile を保存します。
ターミナルウィンドウで、Cartfile があるディレクトリに移動します。
```
cd <path-to-project>
```
carthage update コマンドを実行します。これにより、Cartfile で指定された API とその依存関係がインストールされます。
Finder のプロジェクトディレクトリで、Carthage/Build の下にあるダウンロードしたフレームワークファイルに移動します。
[Framework, Libraries, and Embedded Content] の下の XCFrameworks をプロジェクトにドラッグします。XCFramework ごとに [表示しない] を選択します。
- GoogleMaps-x.x.x/GoogleMapsBase.xcframework
- GoogleMaps-x.x.x/GoogleMaps.xcframework
- GoogleMaps-x.x.x/GoogleMapsCore.xcframework
- （プレミアムプランのお客様のみ）GoogleMaps-x.x.x/GoogleMapsM4B.xcframework
プロジェクトで GoogleMaps.xcframework を右クリックし、[Show In Finder] を選択します。
GoogleMaps.bundle を ios-arm64_x86_64-simulator/GoogleMaps.framework/Resources フォルダから Xcode プロジェクトの最上位ディレクトリにドラッグします。プロンプトが表示されたら、[必要に応じてアイテムをコピー] が選択されていないことを確認します。
プロジェクトナビゲータからプロジェクトを選択し、アプリケーションのターゲットを選択します。
アプリのターゲットの [Build Phases] タブを開き、[Link Binary with Libraries] で次のフレームワークとライブラリを追加します。
- Accelerate.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
- QuartzCore.framework
- SystemConfiguration.framework
- UIKit.framework
特定のターゲットではなく、プロジェクトを選択し、[Build Settings] タブを開きます。[その他のリンカーフラグ] セクションで、-ObjC を追加します。これらの設定が表示されていない場合は、[Build Settings] バーのフィルタを [Basic] から [All] に変更します。
Places SDK for iOS XCFramework をインストールするには、Places SDK for iOS を使ってみるをご覧ください。

手動

このガイドでは、Maps SDK for iOS を手動でプロジェクトに追加し、Xcode でビルド設定を構成する方法について説明します。

SDK のソースファイル GoogleMaps-8.0.0 をダウンロードします。
ソースファイルを解凍します。[Frameworks] フォルダに移動して XCFramework にアクセスします。
Xcode プロジェクトがない場合は、ここで作成してローカルマシンに保存します。iOS 開発が初めての場合:
1. 新しいプロジェクトを作成します。
2. [iOS] > [App] テンプレートを選択します。
3. プロジェクトのオプション画面で、以下の操作を行います。
  1. プロジェクト名を入力します。
  2. [Bundle ID] フィールドの値を記録します。この値を使用して、以下の API キーを制限できます。
  3. プロジェクトの [インターフェース] を [ストーリーボード] に設定します。
  4. [Language] を [Swift] または [Objective-C] に設定します。
[Framework, Libraries, and Embedded Content] の下の XCFrameworks をプロジェクトにドラッグします。XCFramework ごとに [表示しない] を選択します。
- GoogleMaps-x.x.x/GoogleMapsBase.xcframework
- GoogleMaps-x.x.x/GoogleMaps.xcframework
- GoogleMaps-x.x.x/GoogleMapsCore.xcframework
- （プレミアムプランのお客様のみ）GoogleMaps-x.x.x/GoogleMapsM4B.xcframework
プロジェクトで GoogleMaps.xcframework を右クリックし、[Show In Finder] を選択します。
GoogleMaps.bundle を ios-arm64_x86_64-simulator/GoogleMaps.framework/Resources フォルダから Xcode プロジェクトの最上位ディレクトリにドラッグします。プロンプトが表示されたら、[必要に応じてアイテムをコピー] が選択されていないことを確認します。
プロジェクトナビゲータからプロジェクトを選択し、アプリケーションのターゲットを選択します。
アプリのターゲットの [Build Phases] タブを開き、[Link Binary with Libraries] で次のフレームワークとライブラリを追加します。
- Accelerate.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
- QuartzCore.framework
- SystemConfiguration.framework
- UIKit.framework
特定のターゲットではなく、プロジェクトを選択し、[Build Settings] タブを開きます。[その他のリンカーフラグ] セクションで、-ObjC を追加します。これらの設定が表示されていない場合は、[Build Settings] バーのフィルタを [Basic] から [All] に変更します。
Places SDK for iOS XCFramework をインストールするには、Places SDK for iOS を使ってみるをご覧ください。

ステップ 3: API キーをプロジェクトに追加する

[API キーを取得する] で、アプリの API キーを生成しました。そのキーを Xcode プロジェクトに追加します。

次の例では、YOUR_API_KEY を API キーに置き換えます。

Swift

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

import ステートメント
```
import GoogleMaps
```
を追加します。
API キーを使用して、application(_:didFinishLaunchingWithOptions:) メソッドに次の行を追加します。
```
GMSServices.provideAPIKey("YOUR_API_KEY")
```
Places API も使用している場合は、次のようにキーを再度追加します。
```
GMSPlacesClient.provideAPIKey("YOUR_API_KEY")
```

Objective-C

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

import ステートメント
```
@import GoogleMaps;
```
を追加します。
API キーを使用して、application:didFinishLaunchingWithOptions: メソッドに次の行を追加します。
```
[GMSServices provideAPIKey:@"YOUR_API_KEY"];
```
Places API も使用している場合は、次のようにキーを再度追加します。
```
[GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];
```

ステップ 4（省略可）: Metal レンダリングフレームワークの使用を許可する

Maps SDK for iOS を使用すると、Apple の Metal レンダリングフレームワークの使用をオプトインできます。アプリで Metal レンダラを試すには、地図ビューを作成する前に、Objective-C で [GMSServices setMetalRendererEnabled:YES] または Swift で GMSServices.setMetalRendererEnabled(true) を呼び出します。

SDK を手動でインストールする場合は、Xcode で Metal.framework も追加する必要があります。

ステップ 5: 地図を追加する

次のコードは、既存の地図に既存の地図を追加する方法を示しています。ViewController

アプリのデフォルトの ViewController にメソッドを追加または更新して、GMSMapView のインスタンスを作成して初期化します。

サンプルコード内のすべてのViewControllerインスタンスを、ビューコントローラの名前に置き換えます。

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 camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
        let mapView = GMSMapView.map(withFrame: self.view.frame, camera: camera)
        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.
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                          longitude:151.20
                                                               zoom:6];
  GMSMapView *mapView = [GMSMapView mapWithFrame:self.view.frame camera:camera];
  mapView.myLocationEnabled = YES;
  [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
ViewController.m

アプリを実行すると、1 つのマーカーが配置され、オーストラリアのシドニーが中央に配置された地図が表示されます。マーカーが表示されても地図が表示されない場合は、API キーを指定していることを確認してください。

ステップ 6（省略可）: API が使用する URL スキームを宣言する

iOS 9 および Xcode 7 以降では、アプリの Info.plist ファイルでスキームを指定することにより、開く URL スキームを宣言できます。ユーザーが地図上の Google ロゴをクリックすると、Maps SDK for iOS によって Google マップモバイルアプリが開き、関連する URL スキームを宣言できます。

Maps SDK for iOS で使用される URL スキームを宣言するには、次の行を Info.plist に追加します。

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>googlechromes</string>
    <string>comgooglemaps</string>
</array>

次のスクリーンショットは、Xcode でのユーザーインターフェースでの設定を示しています。

Xcode の LSApplicationQueriesSchemes 構成

上記の宣言がないと、ユーザーが地図上の Google ロゴをタップしたときに次のエラーが発生する可能性があります。

-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"

これらのエラーを排除するには、上記のように Info.plist に宣言を追加します。

次のステップ

API キーと Xcode プロジェクトが作成されたので、アプリを作成して実行できます。Maps SDK for iOS には、利用の開始に役立つ多くのチュートリアルとサンプルアプリが用意されています。詳しくは以下をご覧ください。

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

手順 1: 必要なソフトウェアをインストールする

ステップ 2: Xcode プロジェクトを作成し、Maps SDK for iOS をインストールする

CocoaPods を使用

Carthage を使用する

手動でインストールする

XCFramework をインストールする

Carthage を使用

手動

ステップ 3: API キーをプロジェクトに追加する

Swift

Objective-C

ステップ 4（省略可）: Metal レンダリング フレームワークの使用を許可する

ステップ 5: 地図を追加する

Swift

Objective-C

ステップ 6（省略可）: API が使用する URL スキームを宣言する

次のステップ

ステップ 4（省略可）: Metal レンダリングフレームワークの使用を許可する