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 的连接可能会定期重启。另外,在首次创建地图前获取此对象也可能有助于降低初始地图创建的性能开销。

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

+ (BOOL) provideAPIKey (NSString *)  API 密钥

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

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

返回
如果 APIKey 已成功提供,则为“是”。
+ (BOOL) provideAPIOptions (NSArray< NSString * > *) APIOptions

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

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

您的应用可以仅调用一次此函数,并且必须在初始化任何 iOS Maps SDK 对象之前调用。

返回
如果成功提供了所有 APIOptions,则为是。
+(空)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)”。