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

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

このチュートリアルでは、Google マップを iOS アプリに追加する方法を紹介します。地図には、特定の場所を示すマーカー（ピンとも呼ばれます）が配置されています。

コードの取得

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

< > 地図表示コントローラの 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

開発プロジェクトの設定

Maps SDK for iOS をインストールする手順は次のとおりです。

Xcode バージョン 13.0 以降をダウンロードしてインストールします。
CocoaPods がまだインストールされていない場合は、ターミナルから次のコマンドを実行して macOS にインストールします。
```
sudo gem install cocoapods
```
Google Maps iOS サンプルリポジトリのクローンを作成するか、ダウンロードします。
tutorials/map-with-marker ディレクトリに移動します。
pod install コマンドを実行します。これにより、Podfile で指定された API と、それらの依存関係（存在する場合）がインストールされます。
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 ステートメントがファイルに追加されています。
```
import GoogleMaps
```
application(_:didFinishLaunchingWithOptions:) メソッドの次の行を編集します。YOUR_API_KEY は API キーに置き換えます。
```
GMSServices.provideAPIKey("YOUR_API_KEY")
```

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

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

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

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

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

コードについて

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

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;

loadView() の地図にマーカーを追加します。

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 の使用方法も確認しました。

次のステップ

詳しくは、地図オブジェクトとマーカーを使ってできることをご覧ください。