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) + setAbnormalTeralityReportingEnabled
 允许报告异常 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 Console 为您的应用生成,并与您应用的软件包 ID 配对来识别它。在初始化任何 iOS Maps SDK 对象之前,您的应用必须正好调用该函数一次。

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

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

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

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

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

可让地图使用 Metal 而非 OpenGL 进行渲染。

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

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

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