GMSNavigationServices 類別參考資料

靜態公開成員函式 | 資源 | 相關函式

GMSNavigationServices 類別參考資料

---

總覽

此服務可讓使用者控制在行動裝置存取 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 執行期間停止運作。
(可為空值GMSNavigationSession *)	+ createNavigationSession
	建立與地圖檢視無關的新導航工作階段。
(NSString *)	+ openSourceLicenseInfo
	傳回 Google Navigation SDK for iOS 的開放原始碼軟體授權資訊。
(NSString *)	+ navSDKVersion
	傳回此版本 Navigation SDK for iOS 的版本。
房源
BOOL	shouldOnlyShowDriverAwarenesssDisclaimer
	已淘汰。
相關函式
(請注意，這些並非成員函式)。
typedef void(^	GMSTermsResponseCallback )(接受 BOOL 條款)
	使用者接受或拒絕條款及細則時呼叫。

---

成員職能說明文件

+ (BOOL) areTermsAndConditionsAccepted

針對 5.5.0 版以上的版本，會指出是否已使用者確認條款及細則。

如果是較舊的版本，顯示使用者是否已接受條款及細則。

如果為 false，服務會停用導覽介面的存取權。

+ (void) showTermsAndConditionsDialogIfNeededWithOptions：		(GMSNavigationTermsAndConditionsOptions *)	選項
回呼：		(GMSTermsResponseCallback)	回呼

如果應用程式使用者尚未接受 Navigation SDK 條款及細則，系統會顯示強制回應對話方塊。

回呼會連同使用者的回應傳送至主要佇列。

如果使用者已接受條款及細則，系統就不會顯示對話方塊，且回呼包含 termsAccepted = YES。

參數：

選項	GMSNavigationTermsAndConditionsOptions 物件，用來修改條款及細則對話方塊的外觀。如需更多資訊，請參閱 @ GMSNavigationTermsAndConditionsOptions。
回呼	封鎖會在主要佇列中傳送使用者回應。

+ (void) showTermsAndConditionsDialogIfNeededWithTitle：		(可為空值的 NSString *)	title
companyName：		(NSString *)	companyName
UIParams：		(可為空值 GMSNavigationTermsDialogUIParams *)	UIParams
回呼：		(GMSTermsResponseCallback)	回呼

已淘汰，

請改用 showTermsAndConditionsDialogIfNeededWithOptions:callback:。

如果應用程式使用者尚未接受 Navigation SDK 條款及細則，系統會顯示強制回應對話方塊。回呼會連同使用者的回應傳送至主要佇列。

如果使用者已接受條款及細則，系統就不會顯示對話方塊，且回呼包含 termsAccepted = YES。

將 companyName 參數設為貴公司。公司名稱會顯示在條款及細則文字中。這段文字說明應用程式使用者可能會將位置資料與這間公司分享，以改善營運效率。

從主執行緒呼叫此方法。多次呼叫無需等待回應，不會有任何效果。

參數：

title

對話方塊的標題。如果 title 為 nil，對話方塊會使用預設標題。

注意：

如果是自訂標題，這個方法的呼叫端需要將這個參數本地化。預設標題會自動由服務本地化。

參數：

companyName	發布應用程式的公司名稱，以及與 Google 達成分享位置資料的協議。
UIParams	定義對話方塊外觀和風格的參數。如果是 nil，對話方塊會使用預設外觀和風格。
回呼	封鎖會在主要佇列中傳送使用者回應。

+ (void) showTermsAndConditionsDialogIfNeededWithTitle：		(可為空值的 NSString *)	title
companyName：		(NSString *)	companyName
回呼：		(GMSTermsResponseCallback)	回呼

已淘汰，

請改用 showTermsAndConditionsDialogIfNeededWithOptions:callback:。

使用預設外觀和風格顯示條款及細則對話方塊。

詳情請參閱「+showTermsAndConditionsDialogIfRequireedWithTitle:companyName:UIParams:callback:」，包括參數的說明、companyName 和 callback。

+ (void) showTermsAndConditionsDialogIfNeededWithCompanyName：		(NSString *)	companyName
回呼：		(GMSTermsResponseCallback)	回呼

已淘汰，

請改用 showTermsAndConditionsDialogIfNeededWithOptions:callback:。

使用預設標題、外觀和風格，顯示條款及細則對話方塊。

詳情請參閱「+showTermsAndConditionsDialogIfRequireedWithTitle:companyName:UIParams:callback:」，包括參數 companyName 和 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，且必須先更新值，才能初始化服務執行個體。

這個屬性必須透過主執行緒設定。

+ (可為空值 GMSNavigationSession *) createNavigationSession

建立與地圖檢視無關的新導航工作階段。

這會分配並傳回新的導覽工作階段。路線控點和選項可在工作階段上設定，而且可能會加入事件監聽器。

如果條款及細則尚未接受，此方法會傳回 nil。這個方法只會傳回 nil 的唯一原因。

建立這個工作階段後，您可以使用 GMSMapView 方法 -enableNavigationWithSession：工作階段是較重的物件，會耗用記憶體、資料和電池，因此只有在應用程式的主要功能是持續瀏覽工作階段時，才應分配這些物件。基於相同理由，如果您的應用程式在建立導覽工作階段後建立導覽 UI，請務必使用現有的導覽工作階段啟動導覽 UI，而不要建立新的導覽工作階段。

導覽工作階段的生命週期是由一般 Objective-C 語意所規範。因此，此常式的呼叫端應儲存工作階段的參照。

+ (NSString *) openSourceLicenseInfo

傳回 Google Navigation SDK for iOS 的開放原始碼軟體授權資訊。

請務必在應用程式中提供這項資訊。

+ (NSString *) navSDKVersion

傳回此版本 Navigation SDK for iOS 的版本。

---

好友及相關功能說明文件

- (typedef void(^ GMSTermsResponseCallback)(BOOL terms)) [related]

使用者接受或拒絕條款及細則時呼叫。

如果是 5.5.0 以上版本，termsAccepted 會一律為 YES。

---

屬性說明文件

- (BOOL) shouldOnlyShowDriverAwarenesssDisclaimer [read, write, assign]

已淘汰，

請改為將 GMSNavigationTermsAndConditionsOptions API 與 showTermsAndConditionsDialogIfNeededWithOptions:callback: 搭配使用。

表示 showTermsAndConditionsDialogIfNeededWithCompanyName:callback: 是否應只顯示駕駛人感知免責事項。預設值為 NO，因此除了 Navigation SDK 提供的預設條款和服務外，還會顯示免責事項。設為 YES，代表系統只應顯示駕駛人感知免責事項。

如果專案必須顯示「條款及細則」對話方塊，將此變數設為 YES 就不會產生任何作用。此外，getter 方法一律會傳回 NO。

這個屬性必須在主執行緒中設定或讀取。

注意：

這項功能已淘汰，請改用GMSNavigationTermsAndConditionsOptions API。