總覽
Google Maps SDK for iOS 的服務類別。
這個類別並非執行緒安全。所有方法都只能在主執行緒上叫用。
靜態公開成員函式 | |
(id< NSObject >) | + sharedServices |
提供 Google Maps SDK for iOS 的共用例項GMSServices,可視需要建立。 | |
(BOOL) | + ProvideAPIKey: |
將 API 金鑰提供給 Google Maps SDK for iOS。 | |
(BOOL) | + provideAPIOptions: |
將 API 選項提供給 Google Maps SDK for iOS。 | |
(void) | + setMetalRendererEnabled: |
讓地圖使用 Metal (而非 OpenGL) 進行算繪。 | |
(void) | + setAbnormalTerminationReportingEnabled: |
啟用異常 SDK 終止情形的報告,例如應用程式在 SDK 執行期間停止運作。 | |
(NSString *) | + openSourceLicenseInfo |
傳回 Google Maps SDK for iOS 的開放原始碼軟體授權資訊。 | |
(NSString *) | + SDKVersion 鍵 |
傳回這個版本的 Google Maps SDK for iOS 版本。 | |
(NSString *) | + SDKLongVersion |
傳回此版本的 Google Maps SDK for iOS 完整版本。 |
成員職能說明文件
+ (id<NSObject>) sharedServices |
提供 Google Maps SDK for iOS 的共用例項GMSServices,可視需要建立。
像是GMSMapView和 GMSPanoramaView 之類的類別會存放此例項,以提供其與 Google 的連線。
這是不透明物件,如果應用程式經常建立及刪除 Google Maps SDK for iOS 提供的檢視畫面或服務類別,請直接保留到這個物件上,否則與 Google 之間的連線可能會定期重新啟動。建議在第一次建立地圖之前就取得這個物件,有助於降低初始建立地圖的效能成本。
若尚未呼叫提供 APIKey:,此方法將擲回例外狀況。
+ (BOOL) ProvideAPIKey: | (NSString *) | API 金鑰 |
將 API 金鑰提供給 Google Maps SDK for iOS。
系統是透過 Google Cloud Platform 主控台為應用程式產生這個金鑰,並與您應用程式的繫結 ID 配對,以便識別金鑰。在初始化任何 iOS Maps SDK 物件之前,應用程式只能呼叫一次。
- 傳回:
- 如果已成功提供 APIKey,則答案為是。
+ (BOOL) ProvideAPIOptions: | (NSArray< NSString * > *) | APIOptions |
將 API 選項提供給 Google Maps SDK for iOS。
針對每個選項傳遞包含 NSString 的陣列。這些選項適用於所有地圖。
應用程式可只會呼叫一次,而且必須在任何 iOS Maps SDK 物件初始化之前呼叫。
- 傳回:
- 是,如果已成功提供所有 APIOptions。
+ (void) setMetalRendererEnabled: | (BOOL) | 已啟用 |
讓地圖使用 Metal (而非 OpenGL) 進行算繪。
轉譯器之間的算繪畫面可能稍有不同。預設值為 YES
,且這個值必須在服務執行個體初始化前更新。
這個屬性必須透過主執行緒設定。
- 注意:
- 這個方法已淘汰。如果未叫用這個 API,現在系統會將 Metal 設為預設轉譯器。未來, Metal 算繪會是唯一可用的實作,這個 API 是免人工管理的。我們鼓勵客戶從程式碼中移除對此方法的呼叫。
+ (void) setAbnormalTerminationReportingEnabled: | (BOOL) | 已啟用 |
啟用異常 SDK 終止情形的報告,例如應用程式在 SDK 執行期間停止運作。
這樣一來,Google 就能改善 SDK 的穩定性 (如適用)。預設值為 YES
,且必須先更新值,才能初始化服務執行個體。
這個屬性必須透過主執行緒設定。
+ (NSString *) openSourceLicenseInfo |
傳回 Google Maps SDK for iOS 的開放原始碼軟體授權資訊。
這項資訊必須在申請中提供。
+ (NSString *) SDKVersion |
傳回這個版本的 Google Maps SDK for iOS 版本。
例如「1.0.0」。
+ (NSString *) SDKLongVersion |
傳回此版本的 Google Maps SDK for iOS 完整版本。
例如「1.0.0 (102.1)」。