總覽
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)」。