GMSServices 類別參考資料

GMSServices 類別參考資料

總覽

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,視需要建立。

諸如GMSMapViewGMSPanoramaView等類別可保留這個實例,以便將其與 Google 連接。

此為不透明物件。如果您的應用程式經常建立並刪除由 Google Maps SDK for iOS 提供的檢視或服務類別,建議您直接保留此物件,否則與 Google 的連線可能會定期重新啟動。在第一次建立地圖之前就先擷取此物件,以減少初始地圖建立效能的成本。

如果尚未呼叫 provideAPIKey:,這個方法會擲回例外狀況。

+ (BOOL) provideAPIKey: (NSString *) API 金鑰

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

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

傳回:
「是」,如果已成功提供 API 金鑰,
+ (BOOL) provideAPIOptions: (NSArray< NSString * > *) APIOptions

提供 API 選項給 Google Maps SDK for iOS。

為每個選項傳送包含 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)」。