地圖是由 GMSMapView
類別 (UIView
的子類別) 在 API 中表示。地圖是 Maps SDK for iOS 中最重要的物件,會提供必要方法來新增、移除及管理其他物件,例如標記和折線。
引言
Maps SDK for iOS 可讓您在 iOS 應用程式中顯示 Google 地圖。這些地圖的外觀與 Google 地圖 iOS 應用程式中顯示的地圖相同,且 SDK 也提供許多相同的功能。
除了對應功能之外,這個 API 也支援與 iOS UI 模型一致的一系列互動。舉例來說,您可以定義回應使用者手勢 (例如輕觸和輕觸兩下) 的回應者,藉此設定與地圖的互動。
使用地圖物件時的金鑰類別為 GMSMapView
類別。GMSMapView
會自動處理以下作業:
- 連線到 Google 地圖服務。
- 下載地圖圖塊。
- 在裝置螢幕上顯示圖塊。
- 顯示各種控件,如平移和縮放。
- 藉由移動地圖及放大/縮小,回應平移和縮放手勢。
- 藉由傾斜地圖的視角,回應雙指手勢。
除了這些自動作業之外,您也可以透過 GMSMapView
類別公開的屬性和方法,控制地圖的行為和外觀。GMSMapView
可讓您新增及移除標記、區域疊加層和折線、變更顯示的地圖類型,以及透過 GMSCameraPosition
類別控制地圖上顯示的內容。
使用 SwiftUI 製作地圖
SwiftUI 還提供另一種使用宣告式建立 UI 的方式。您可以向 SwiftUI 指定檢視畫面,瞭解該檢視畫面的各種狀態,然後由系統完成其餘的事項。每當基礎狀態因事件或使用者動作而變更時,SwiftUI 都會處理更新檢視畫面。
Maps SDK for iOS 是以 UIKit
為基礎,不提供與 SwiftUI 相容的檢視畫面。如要在 SwiftUI 中加入地圖,必須符合 UIViewRepresentable
或 UIViewControllerRepresentable
。詳情請參閱程式碼研究室,瞭解如何使用 SwiftUI 在 iOS 應用程式中加入地圖。
新增地圖
加入地圖的基本步驟如下:
如要取得 SDK 和 API 金鑰並新增必要架構,請按照以下各篇文章的步驟操作:
在
AppDelegate
中,將 API 金鑰提供給GMSServices
的provideAPIKey:
類別方法。建立或更新
ViewController
。如果在這個檢視畫面控制器出現時顯示地圖,請務必在viewDidLoad
方法中建立地圖。初始化地圖檢視時,請使用
GMSMapViewOptions
設定設定選項。屬性包括frame
、camera
、mapID
、backgroundColor
或screen
。使用
GMSCameraPosition
物件設定地圖選項camera
屬性。這會指定地圖的中心點和縮放等級。使用
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
物件。
後續步驟
完成以上步驟後,您即可調整地圖設定。