地図を追加する

プラットフォームを選択: Android iOS JavaScript

API では、地図は UIView のサブクラスである GMSMapView クラスによって表されます。地図は Maps SDK for iOS の最も重要なオブジェクトであり、マーカーやポリラインなどの他のオブジェクトを追加、削除、管理するために必要なメソッドを備えています。

はじめに

Maps SDK for iOS を使用すると、iOS アプリに Google マップを表示できます。これらの地図の外観は、iOS 版の Google マップ アプリに表示される地図と同じであり、SDK によって同じ機能の多くが公開されます。

マッピング機能に加えて、API は iOS UI モデルと一致するさまざまな操作もサポートしています。たとえば、タップやダブルタップなどのユーザーの操作に反応するレスポンダーを定義することで、地図とのインタラクションを設定できます。

Map オブジェクトを操作する場合の主要なクラスは GMSMapView クラスです。GMSMapView は次のオペレーションを自動的に処理します。

  • Google マップサービスに接続する。
  • 地図タイルをダウンロードする。
  • タイルをデバイスの画面に表示する。
  • 移動やズームといった各種コントロールを表示する。
  • 移動やズームのジェスチャーに対し、地図を移動したり拡大縮小したりして反応する。
  • 2 本指でのジェスチャーに対し、地図の表示角度を傾けて反応する。

これらの自動操作に加えて、GMSMapView クラスで公開されるプロパティとメソッドを使用して、地図の動作や外観を制御できます。GMSMapViewGMSCameraPosition クラスを使用すると、マーカー、地面オーバーレイ、ポリラインの追加と削除、表示される地図のタイプの変更、地図上に表示される内容の制御を行うことができます。

SwiftUI で地図を作成する

SwiftUI では、宣言型のアプローチで UI を作成できます。ビューの表示形式とさまざまな状態を SwiftUI に指定すれば、あとはシステムが処理します。SwiftUI は、イベントやユーザーの操作によって基になる状態が変化するたびにビューを更新します。

Maps SDK for iOS は UIKit 上に構築されており、SwiftUI 対応のビューはまだ提供されていません。SwiftUI で地図を追加するには、UIViewRepresentable または UIViewControllerRepresentable に準拠している必要があります。詳しくは、Codelab の SwiftUI を使って iOS アプリに地図を追加するをご覧ください。

地図を追加する

地図を追加する基本的な手順は次のとおりです。

  1. SDK の入手、API キーの取得、必要なフレームワークの追加は、次の手順に沿って行います。

    1. Google Cloud コンソールでセットアップする

    2. API キーを使用する

    3. Xcode プロジェクトをセットアップする

  2. AppDelegate で、API キーを GMSServicesprovideAPIKey: クラスメソッドに渡します。

  3. ViewController を作成または更新します。このビュー コントローラが表示されたときに地図が表示される場合は、必ず loadView メソッド内で地図を作成してください。

    1. 地図の中心とズームレベルを指定する GMSCameraPosition オブジェクトを作成します。GMSMapView オブジェクトをインスタンス化する場合は、GMSCameraPosition オブジェクトを必須パラメータとして渡す必要があります。

    2. GMSMapView mapWithFrame: メソッドを使用して、GMSMapView クラスを作成してインスタンス化します。この地図をビュー コントローラの唯一のビューとして使用する場合は、CGRectZero を地図のフレームとして使用できます。これにより、地図のサイズが自動的に変更されます。

    3. GMSMapView オブジェクトをビュー コントローラのビューとして設定します(例: self.view = mapView;)。

次の例では、シンガポールの繁華街を中心としたマップをアプリに追加しています。

Swift

import GoogleMaps

class MapObjects : UIViewController {
  override func viewDidLoad() {
    super.viewDidLoad()
    let camera = GMSCameraPosition(latitude: 1.285, longitude: 103.848, zoom: 12)
    let mapView = GMSMapView(frame: .zero, camera: camera)
    self.view = mapView
  }
}
      

Objective-C

#import "MapObjects.h"
@import GoogleMaps;

@implementation MapObjects

- (void)viewDidLoad {
  [super viewDidLoad];
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:1.285
                                                          longitude:103.848
                                                               zoom:12];
  GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
  self.view = mapView;
}

@end
      

以上の手順を完了したら、GMSMapView オブジェクトをさらに構成できます。

次のステップ

これらの手順を完了したら、地図の設定を変更できます。