API では、地図は UIView
のサブクラスである GMSMapView
クラスで表されます。地図は、Maps SDK for iOS における最も重要なオブジェクトであり、マーカーやポリラインなどの他のオブジェクトを追加、削除、管理するために必要なメソッドを提供します。
はじめに
Maps SDK for iOS を使用すると、iOS アプリに Google マップを表示できます。これらの地図は、Google マップ iOS アプリに表示される地図と同じ外観を持ち、SDK では同じ機能の多くが公開されています。
API では、マッピング機能に加え、iOS UI モデルと同様の幅広い操作もサポートされています。たとえば、タップやダブルタップなどのユーザー操作に反応するレスポンスを定義して、マップとのインタラクションを設定できます。
マップ オブジェクトを操作する際に重要なクラスは GMSMapView
クラスです。GMSMapView
は次の操作を自動的に処理します。
- Google マップサービスに接続する。
- 地図タイルをダウンロードする。
- タイルをデバイスの画面に表示する。
- パンやズームといった各種コントロールを表示する。
- パン操作やズーム操作に対し、地図の移動やズームインまたはズームアウトで応答する。
- 2 本指でマップの表示角度を傾ける操作への応答。
これらの自動操作に加えて、GMSMapView
クラスが公開するプロパティやメソッドを使用してマップの動作や外観を制御できます。GMSMapView
を使用すると、マーカーや地面オーバーレイ、ポリラインの追加や削除、表示されているマップタイプの変更、GMSCameraPosition
クラスによる表示対象の制御を行うことができます。
SwiftUI で地図を作成する
SwiftUI では、宣言型アプローチによる UI 作成方法がさらに用意されています。ビューの外観とさまざまな状態を SwiftUI に伝えると、あとはシステムが自動的に処理してくれます。もとになっている状態がイベントやユーザー行動により変化すると、SwiftUI が自動的にビューを更新します。
Maps SDK for iOS は UIKit
を基盤として設計されており、SwiftUI 対応のビューは提供されていません。SwiftUI で地図を追加するには、UIViewRepresentable
または UIViewControllerRepresentable
に準拠する必要があります。詳細については、Codelab の SwiftUI を使って iOS アプリに地図を追加するをご覧ください。
地図を追加する
マップを追加するための基本的なステップは次のとおりです。
SDK の入手、API キーの取得、必要なフレームワークの追加は、次の手順に沿って行います。
AppDelegate
で、GMSServices
のprovideAPIKey:
クラスメソッドに API キーを渡します。ViewController
を作成または更新します。このビュー コントローラが表示される際に地図を表示する場合は、viewDidLoad
メソッド内で地図を作成してください。マップビューを初期化するときに、
GMSMapViewOptions
を使用して構成オプションを設定します。プロパティには、frame
、camera
、mapID
、backgroundColor
、screen
が含まれます。地図オプションの
camera
プロパティにGMSCameraPosition
オブジェクトを設定します。これにより、地図の中心とズームレベルを指定します。GMSMapView
options:
メソッドを使用してGMSMapView
クラスを作成してインスタンス化します。この地図をビュー コントローラの唯一のビューとして使用する場合は、地図オプションframe
のデフォルト値CGRectZero
をビューframe
として使用できます。この場合、地図は自動的にサイズ変更されます。GMSMapView
オブジェクトをビュー コントローラのビューとして設定します。例:self.view = mapView;
次の例では、シンガポールの繁華街を中心としたマップをアプリに追加しています。
Swift
import GoogleMaps class MapObjects : UIViewController { override func viewDidLoad() { super.viewDidLoad() let options = GMSMapViewOptions() options.camera = GMSCameraPosition(latitude: 1.285, longitude: 103.848, zoom: 12) options.frame = self.view.bounds; let mapView = GMSMapView(options:options) self.view = mapView } }
Objective-C
- (void)viewDidLoad { [super viewDidLoad]; GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init]; options.camera = [GMSCameraPosition cameraWithLatitude:1.285 longitude:103.848 zoom:12]; options.frame = self.view.bounds; GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options]; self.view = mapView; }
このステップを完了した後、GMSMapView
オブジェクトにさらに設定を行うこともできます。
次のステップ
このトピックの手順を完了したら、地図を設定するに進みます。