Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

マーカーが配置された地図を追加する

このチュートリアルでは、マーカーが配置された Google マップを iOS アプリに追加する方法を説明します。Swift または Objective-C の初心者または中級者で、Xcode の一般的な知識がある方を対象としています。地図の作成に関する高度なガイドについては、デベロッパーガイドをご覧ください。

このチュートリアルでは、次の地図を作成します。マーカーはオーストラリアのシドニーに配置されています。

シドニーにマーカーが配置された地図のスクリーンショット

コードを取得する

GitHub で Google Maps iOS サンプルリポジトリをクローンするかダウンロードします。

または、次のボタンをクリックしてソースコードをダウンロードすることもできます。

コードを取得する

Swift

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

#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

始める

Swift Package Manager

Maps SDK for iOS は、Swift Package Manager を使用してインストールできます。

既存の Maps SDK for iOS の依存関係を削除します。
ターミナルウィンドウを開いて、tutorials/map-with-marker ディレクトリに移動します。

Xcode ワークスペースを閉じて、次のコマンドを実行します。

sudo gem install cocoapods-deintegrate cocoapods-clean
pod deintegrate
pod cache clean --all
rm Podfile
rm map-with-marker.xcworkspace

Xcode プロジェクトを開き、podfile を削除します。
[File] > [Add Package Dependencies] に移動します。
URL として「https://github.com/googlemaps/ios-maps-sdk」と入力し、[Enter] キーを押してパッケージをプルし、[Add Package] をクリックします。
[File] > [Packages] > [Reset Package Cache] を使用して、パッケージキャッシュをリセットする必要がある場合があります。

CocoaPods を使用

Xcode バージョン 26.0 以降をダウンロードしてインストールします。
CocoaPods
```
sudo gem install cocoapods
```
tutorials/map-with-marker ディレクトリに移動します。
pod install コマンドを実行します。これにより、Maps SDK が Podfile で指定された依存関係とともにインストールされます。
pod outdated を実行して、インストールされている pod のバージョンと新しいアップデートを比較します。新しいバージョンが検出された場合は、pod update を実行して Podfile を更新し、最新の SDK をインストールします。詳しくは、CocoaPods ガイドをご覧ください。
プロジェクトの map-with-marker.xcworkspace ファイルを（ダブルクリックして）開いて、Xcode で開きます。プロジェクトを開くには、.xcworkspace ファイルを使用する必要があります。

API キーを取得して必要な API を有効にする

このチュートリアルを完了するには、Maps SDK for iOS の使用が許可されている Google API キーが必要です。次のボタンをクリックしてキーを取得し、API を有効にしてください。

始める

詳しくは、 API キーを取得するをご覧ください。

API キーをアプリに追加する

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

次のインポート文がファイルに追加されていることに注意してください。
```
import GoogleMaps
```
application(_:didFinishLaunchingWithOptions:) メソッドの次の行を編集し、「YOUR_API_KEY」をお客様の API キーに置き換えます。
```
GMSServices.provideAPIKey("YOUR_API_KEY")
```

アプリをビルドして実行する

iOS デバイスをパソコンに接続するか、Xcode スキームメニューからシミュレータを選択します。
デバイスを使用している場合は、位置情報サービスが有効になっていることを確認してください。シミュレータを使用している場合は、[Features] メニューから場所を選択します。
Xcode で、[Product/Run] メニューオプション（またはプレイボタンアイコン）をクリックします。

Xcode がアプリをビルドし、デバイスまたはシミュレータでアプリを実行します。
このページの画像のように、オーストラリア東海岸のシドニーにマーカーが立った地図が表示されます。

トラブルシューティング:

地図が表示されない場合は、前述の手順どおりに API キーを取得してアプリに追加しているかご確認ください。Xcode のデバッグコンソールで、API キーに関するエラーメッセージを確認してください。
API キーを iOS バンドル ID で制限している場合は、アプリのバンドル ID（com.google.examples.map-with-marker）を追加してキーを編集します。
Wi-Fi または GPS の接続状態が良好であることを確認します。
ログを表示してアプリをデバッグするには、Xcode デバッグツールを使用します。

コードを理解する

地図を作成し、viewDidLoad() でビューとして設定します。

Swift

// 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: CGRect.zero, camera: camera)
view = mapView

Objective-C

// 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.0];
GMSMapView *mapView = [[GMSMapView alloc] initWithFrame: CGRectZero camera:camera];
self.view = mapView;

viewDidLoad() でマップにマーカーを追加します。

Swift

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

// 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;

デフォルトでは、Maps SDK for iOS は、ユーザーがマーカーをタップすると、情報ウィンドウのコンテンツを表示します。このデフォルト動作で問題ない場合は、マーカーのクリックリスナーを追加する必要はありません。

これで完了です。特定の場所を示すマーカーが配置された Google マップを表示する iOS アプリが作成されました。また、 Maps SDK for iOS の使用方法も確認しました。

次のステップ

地図オブジェクトと、マーカーを使ってできることについて、詳しく確認します。