概览
此类服务可用于控制通过移动设备访问 Google Maps Navigation SDK for iOS。
静态公开成员函数 | |
| (BOOL) | + areTermsAndConditionsAccepted |
| 对于 5.5.0 及更高版本，指明用户是否已确认条款及条件。 | |
| (void) | + showTermsAndConditionsDialogIfNeededWithOptions:callback: |
| 如果应用用户尚未接受 Navigation SDK 条款及条件，则显示模态对话框。 | |
| (void) | + showTermsAndConditionsDialogIfNeededWithTitle:companyName:UIParams:callback: |
| 已弃用。 | |
| (void) | + showTermsAndConditionsDialogIfNeededWithTitle:companyName:callback: |
| 已弃用。 | |
| (void) | + showTermsAndConditionsDialogIfNeededWithCompanyName:callback： |
| 已弃用。 | |
| (void) | + resetTermsAndConditionsAccepted |
| 将条款及条件重置为未接受状态。 | |
| (void) | + setAbnormalTerminationReportingEnabled:： |
| 启用对异常 SDK 终止（例如应用在 SDK 仍在运行时时发生崩溃）的报告。 | |
| （可为 null 的 GMSNavigationSession *） | + createNavigationSession |
| 创建一个未与地图视图相关联的新导航会话。 | |
| (NSString *) | + openSourceLicenseInfo |
| 返回 iOS 版 Google Navigation SDK 的开源软件许可信息。 | |
| (NSString *) | + navSDKVersion |
| 返回此版本的 Navigation SDK for iOS 的版本。 | |
属性 | |
| BOOL | shouldOnlyShowDriverAwarenesssDisclaimer |
| 已弃用。 | |
相关函数 | |
（请注意，这些并非成员函数。） | |
| 类型定义符 void(^ | GMSTermsResponseCallback（接受 BOOL 条款） |
| 在用户接受或拒绝条款及条件时调用。 | |
成员函数文档
| + (BOOL) areTermsAndConditionsAccepted |
对于 5.5.0 及更高版本，指明用户是否已确认条款及条件。
对于早期版本，指示用户是否已接受条款及条件。
如果为 false，服务将禁止访问导航界面。
| + (void) showTermsAndConditionsDialogIfNeededWithOptions: | (GMSNavigationTermsAndConditionsOptions *) | options | |
| 回调： | (GMSTermsResponseCallback) | 回调函数 | |
如果应用用户尚未接受 Navigation SDK 条款及条件，则显示模态对话框。
回调将随用户的响应一起发送到主队列中。
如果用户已接受条款及条件，系统不会显示任何对话框，并且回调会包含 termsAccepted = YES。
- 参数：
-
选项 GMSNavigationTermsAndConditionsOptions对象，用于修改条款及条件对话框的外观。如需了解详情，请参阅 @ GMSNavigationTermsAndConditionsOptions。callback 块随用户的响应一起在主队列中发送。
| + (void) showTermsAndConditionsDialogIfNeededWithTitle： | （可为 null 的 NSString *） | title | |
| 公司名称： | (NSString *) | companyName | |
| UIParams： | （可为 null 的 GMSNavigationTermsDialogUIParams *） | UIParams | |
| 回调： | (GMSTermsResponseCallback) | 回调函数 | |
已弃用。
请改用 showTermsAndConditionsDialogIfNeededWithOptions:callback:。
如果应用用户尚未接受 Navigation SDK 条款及条件，则显示模态对话框。回调将随用户的响应一起发送到主队列中。
如果用户已接受条款及条件，系统不会显示任何对话框，并且回调会包含 termsAccepted = YES。
将 companyName 参数设置为您的公司。公司名称会显示在条款及条件文本中。这段文字向应用用户解释，Google 可能会与这家公司分享位置数据，以便改善运营。
从主线程调用此方法。多次调用而不等待响应不会产生任何效果。
- 参数：
-
标题 对话框的标题。如果 title为 nil，则对话框使用默认标题。
- 注意：
- 对于自定义商品名，此方法的调用方需要本地化此参数。服务会自动本地化默认标题。
- 参数：
-
companyName 发布应用的公司的名称，该公司与 Google 就位置数据共享协议签订了协议。 UIParams 用于定义对话框外观和风格的参数。如果为 nil，则对话框使用默认外观和风格。 callback 块随用户的响应一起在主队列中发送。
| + (void) showTermsAndConditionsDialogIfNeededWithTitle： | （可为 null 的 NSString *） | title | |
| 公司名称： | (NSString *) | companyName | |
| 回调： | (GMSTermsResponseCallback) | 回调函数 | |
已弃用。
请改用 showTermsAndConditionsDialogIfNeededWithOptions:callback:。
显示使用默认外观和风格的条款及条件对话框。
如需了解详情（包括参数 companyName 和 callback 的说明），请参阅 +showTermsAndConditionsDialogIfNeededWithTitle:companyName:UIParams:callback:。
| + (void) showTermsAndConditionsDialogIfNeededWithCompanyName: | (NSString *) | companyName | |
| 回调： | (GMSTermsResponseCallback) | 回调函数 | |
已弃用。
请改用 showTermsAndConditionsDialogIfNeededWithOptions:callback:。
使用默认标题和外观和风格显示条款及条件对话框。
如需了解详情（包括参数 companyName 和 callback 的说明），请参阅 +showTermsAndConditionsDialogIfNeededWithTitle:companyName:UIParams:callback:。
| + (void) resetTermsAndConditionsAccepted |
将条款及条件重置为未接受状态。
调用此方法后，areTermsAndConditionsAccepted 会返回 NO，并且 #if SDK_BUILD_CONFIG(EnableNavSDKSkipToSOptions) showTermsAndConditionsDialogIfNeededWithOptions:callback: 和 #endif showTermsAndConditionsDialogIfNeededWithCompanyName:callback: 会显示条款及条件对话框。任何现有GMSMapView实例的navigationEnabled属性都将重置为 NO。
| + (void) setAbnormalTerminationReportingEnabled:： | (BOOL) | abnormalTerminationReportingEnabled |
启用对异常 SDK 终止（例如应用在 SDK 仍在运行时时发生崩溃）的报告。
这样，Google 便可以在适用时提高 SDK 的稳定性。默认值为 YES，在初始化服务实例之前必须更新该值。
此属性必须从主线程设置。
| +（可为 null 的 GMSNavigationSession *）createNavigationSession |
创建一个未与地图视图相关联的新导航会话。
这会分配并返回新的导航会话。可以在会话中设置航点和选项，并且可以向其中添加监听器。
如果尚未接受条款及条件，则此方法将返回 nil。这就是此方法会返回 nil 的唯一原因。
您可以在创建地图后，使用 GMSMapView 方法 -enableNavigationWithSession 将此会话与地图相关联：会话是消耗内存、数据和电量的重量级对象，因此只有在持续导航会话是应用的主要功能时才应分配会话。出于同样的原因，如果您的应用在建立导航会话后创建导航界面，请确保使用现有导航会话启动导航界面，而不是创建新的导航会话。
导航会话的生命周期由常规 Objective-C 语义控制。因此，此例程的调用方应保存对会话的引用。
| + (NSString *) openSourceLicenseInfo |
返回 iOS 版 Google Navigation SDK 的开源软件许可信息。
此信息必须在您的应用中提供。
| + (NSString *) navSDKVersion |
返回此版本的 Navigation SDK for iOS 的版本。
好友及相关函数文档
- (typedef void(^ GMSTermsResponseCallback)(BOOL termsAccepted) [related] |
在用户接受或拒绝条款及条件时调用。
对于 5.5.0 及更高版本，termsAccepted 将始终为 YES。
属性说明
- (BOOL) shouldOnlyShowDriverAwarenesssDisclaimer [read, write, assign] |
已弃用。
请改为将 GMSNavigationTermsAndConditionsOptions API 与 showTermsAndConditionsDialogIfNeededWithOptions:callback: 搭配使用。
指明 showTermsAndConditionsDialogIfNeededWithCompanyName:callback: 是否应仅显示驾驶员认知免责声明。默认值为 NO，除了 Navigation SDK 提供的默认条款和服务之外，系统还会显示免责声明。设置为 YES 可指示应仅显示驾驶员认知免责声明。
如果项目必须显示“条款及条件”对话框，则将此变量设置为 YES 不会产生任何影响。此外，getter 方法始终返回 NO。
必须在主线程中设置或读取此属性。
- 注意：
- 此 API 已弃用。请改用GMSNavigationTermsAndConditionsOptions API。