GMSServices 類別參考資料

GMSServices 類別參考

總覽

Google Maps SDK for iOS 的服務類別。

這個類別不安全,所有方法都只應在主執行緒上叫用。

靜態成員函式

(id< NSObject >)+ sharedServices
 提供 Google Maps SDK for iOS 的共享實例GMSServices,適用於 iOS,視需要建立。
(BOOL) + provideAPIKey:
 將 API 金鑰提供給 Google Maps SDK for iOS。
(BOOL) + provideAPIOptions:
 為 Google Maps SDK for iOS 提供您的 API 選項。
(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,適用於 iOS,視需要建立。

例如 GMSMapViewGMSPanoramaView 等類別會持有此例項,以便提供其與 Google 的連線。

這是不透明的物件。如果應用程式經常建立及刪除 Google Maps SDK for iOS 提供的檢視畫面或服務類別,直接保留此物件可能對您很有用,否則系統可能會定期重新啟動您與 Google 的連線。也可以在建立第一個地圖前先行取得此物件,以降低初始地圖建立效能的成本。

如果尚未呼叫 provideAPIKey:,此方法將擲回例外狀況。

+ (BOOL) provideAPIKey: (NSString *) APIKey

將 API 金鑰提供給 Google Maps SDK for iOS。

這組金鑰是透過 Google Cloud Platform 主控台為您的應用程式產生,並與應用程式的軟體包 ID 配對,以方便識別。應用程式只能呼叫一次這個方法,之後任何 iOS Maps SDK 物件才會初始化。

傳回:
如果已成功提供 APIKey,則為「是」。
+ (BOOL) provideAPIOptions: (NSArray< NSString * > *) APIOptions

為 Google Maps SDK for iOS 提供您的 API 選項。

傳送包含每個選項 NSString 的陣列。這些選項適用於所有地圖。

應用程式可能只會呼叫一次,而且必須在任何 iOS Maps SDK 物件初始化之前呼叫。

傳回:
如果成功提供所有 APIOptions,則為「是」。
+ (void) setMetalRendererEnabled: (BOOL)  已啟用

讓地圖使用 Metal 而非 OpenGL 算繪地圖。

轉譯器之間的算繪畫面可能會稍有不同。預設值為 YES,且必須在服務執行個體初始化前更新這個值。

這個屬性必須透過主執行緒進行設定。

+ (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)」。