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) + setAbnormalTeriationReportingEnabled
 启用对异常 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 *)  APIKey

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

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

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

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

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

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

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

启用地图以使用 Metal 而不是 OpenGL 进行渲染。

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

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

注意:
此方法已废弃。如果未调用此 API, Metal 现在是默认渲染程序。将来,Metal 渲染将是唯一可用的实现,此 API 也将成为空操作。我们建议客户从其代码中移除对此方法的调用。
+ (void) setAbnormalTeriationReportingEnabled (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)”。