GMSServices 类参考文档

GMSServices 类参考文档

概览

Google Maps SDK for iOS 的服务类。

此类不是线程安全的。所有方法只应在主线程上调用。

静态公共成员函数

(id< NSObject >)+ sharedServices
 提供 Google Maps SDK for iOS 的共享 GMSServices 实例,并在必要时创建。
(BOOL)+ provideAPIKey
 向 Google Maps SDK for iOS 提供您的 API 密钥。
(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 实例,并在必要时创建。

GMSMapViewGMSPanoramaView等类将保存此实例,使其与 Google 相关联。

这是一个不透明对象。如果您的应用经常创建和销毁由 Google Maps SDK for iOS 提供的视图类或服务类,那么直接持有此对象可能会很有用,否则您可能会定期重新启动与 Google 的连接。在首次创建地图之前采用此对象可能也很有用,以降低初始地图创建性能成本。

如果未调用提供 APIKey:,此方法将抛出异常。

+ (BOOL) ProvideAPIKey: (NSString *)  API 密钥

向 Google Maps SDK for iOS 提供您的 API 密钥。

此密钥通过 Google Cloud Platform Console 为您的应用生成,并与应用的软件包 ID 配对以进行识别。在初始化任何 iOS Maps SDK 对象之前,您的应用必须只调用此函数一次。

返回
如果 APIKeyKey 已成功提供,则为 YES。
+ (BOOL) provideAPIOptions (NSArray< NSString * > *) API 选项

向 Google Maps SDK for iOS 提供 API 选项。

传递一个包含每个选项的 NSString 的数组。这些选项适用于所有地图。

您的应用可能只调用一次该方法,并且必须在初始化任何 iOS Maps SDK 对象之前调用。

返回
如果所有 APIOptions 都已成功提供,则为 YES。
+ (void) setMetalRendererEnabled: (BOOL) 已启用

让地图使用 Metal 而不是 OpenGL 渲染。

各个渲染程序的渲染效果可能略有不同。默认值为 NO,必须在服务实例初始化之前更新值。

此属性必须从主线程设置。

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