地図を追加する

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

地図は、API で GMSMapView クラス UIView のサブクラス。地図は、地図の中で最も重要なオブジェクトで、 Maps SDK for iOS をサポートしており、アプリの追加、削除、 マーカーやポリラインなどのオブジェクトの管理も行います。

はじめに

Maps SDK for iOS を使用すると、Google マップを ダウンロードしますこれらの地図の外観は、 Google マップ この SDK では同じ機能の多くが公開されます。

マッピング機能に加えて、API では iOS UI モデルと整合性のあるインタラクションを実装します。たとえば ユーザーの操作に反応するレスポンダを定義して、地図の操作 タップやダブルタップなどの操作を行えます

Map オブジェクトの操作で重要なクラスは GMSMapView クラスです。 GMSMapView は、次の操作を自動的に処理します。

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

これらの自動オペレーションに加えて、動作と制御の によって公開されるプロパティとメソッドによる地図の外観。 GMSMapView クラス。GMSMapView: マーカー、地面を追加、削除できます オーバーレイとポリラインの表示、表示される地図の種類の変更、 GMSCameraPosition を通じて地図上に表示される情報 クラスです。

SwiftUI で地図を作成する

SwiftUI では、宣言型のアプローチで UI を作成することもできます。マイページ さまざまな状態とともにビューをどのように表示するかを SwiftUI に指示する あとはシステムが処理しますSwiftUI は常にビューの更新を処理します。 基になる状態がイベントやユーザーのアクションによって変化します。

Maps SDK for iOS は UIKit 上に構築されており、 SwiftUI 互換のビュー。SwiftUI で地図を追加するには、次のいずれかに準拠する必要があります。 UIViewRepresentable または UIViewControllerRepresentable。詳しくは、 Codelabで、 SwiftUI。

地図を追加する

マップを追加するための基本的なステップは次のとおりです。

  1. SDK の入手、API キーの取得、必要なフレームワークの追加を行う手順は次のとおりです。 手順は次のとおりです。

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

    2. API キーを使用する

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

    4. AppDelegate で、API キーを provideAPIKey: に渡します。 GMSServices クラスメソッドを使用します。

    5. ViewController を作成または更新します。地図の他の場所に地図を表示する場合、 ビュー コントローラは、モジュール内で作成してください。 viewDidLoad メソッドを使用します。

    6. マップビューを初期化するときに、 GMSMapViewOptions。プロパティには、frame、camera、 mapID、backgroundColor、または screen。

    7. 地図のオプションの camera プロパティに GMSCameraPosition オブジェクト。画像の中心とズームレベルを指定します。 表示されます。

    8. GMSMapView を使用して GMSMapView クラスを作成し、インスタンス化する options: メソッドを使用します。このマップをビュー コントローラの 表示のみの場合、マップ オプション frame のデフォルト値 CGRectZero は ビューの frame として使用されます。地図のサイズが自動的に調整されます。

    9. 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 をさらに設定できます。 渡されます。

次のステップ

これらの手順を完了したら、地図を設定できます。 設定をご覧ください。