總覽
可控管 Google Maps Navigation SDK for iOS 行動存取權的服務。
靜態成員函式 | |
| (BOOL) | + areTermsAndConditionsAccepted |
| 如果是 >= 5.5.0 版本，指出使用者是否已確認條款及細則。 | |
| (void) | + showTermsAndConditionsDialogIfNeededWithTitle:companyName:UIParams:callback: |
| 如果應用程式使用者尚未接受 Navigation SDK 條款及細則，就會顯示強制回應對話方塊。 | |
| (void) | + showTermsAndConditionsDialogIfNeededWithTitle:companyName:callback: |
| 使用預設外觀和風格顯示條款及細則對話方塊。 | |
| (void) | + showTermsAndConditionsDialogIfNeededWithCompanyName:callback: |
| 使用預設標題和外觀和風格顯示條款及細則對話方塊。 | |
| (void) | + resetTermsAndConditionsAccepted |
| 將條款及細則重設為未接受狀態。 | |
| (void) | + setAbnormalTerminationReportingEnabled： |
| 啟用 SDK 異常終止的回報功能，例如應用程式在 SDK 運作期間異常終止。 | |
| (可為空值GMSNavigationSession *) | + createNavigationSession |
| 建立新的導覽工作階段，但不與地圖檢視建立關聯。 | |
| (NSString *) | + openSourceLicenseInfo |
| 傳回 Google Navigation SDK for iOS 的開放原始碼軟體授權資訊。 | |
| (NSString *) | + navSDKVersion |
| 傳回這個版本的 iOS 版 Navigation SDK 版本。 | |
資源 | |
| BOOL | shouldOnlyShowDriverAwarenesssDisclaimer |
指出 showTermsAndConditionsDialogIfNeededWithCompanyName:callback: 是否應只顯示駕駛人認知免責事項。 | |
相關函式 | |
(請注意，這些不是成員函式)。 | |
| typedef void(^) | GMSTermsResponseCallback )(BOOL 條款接受) |
| 在使用者接受或拒絕條款及細則時呼叫。 | |
成員函式說明文件
| + (BOOL) areTermsAndConditionsAccepted |
如果是 >= 5.5.0 版本，指出使用者是否已確認條款及細則。
如果是較舊的版本，指出使用者是否已接受條款及細則。
如果設為 false，服務會停用對導航介面的存取權。
| + (void) showTermsAndConditionsDialogIfNeededWithTitle： | (nullable NSString *) | title | |
| 公司名稱： | (NSString *) | companyName | |
| UIParams： | (可為空值GMSNavigationTermsDialogUIParams *) | UIParams | |
| 回呼： | (GMSTermsResponseCallback) | 回呼 | |
如果應用程式使用者尚未接受 Navigation SDK 條款及細則，就會顯示強制回應對話方塊。
回呼會與使用者回應一起傳送至主要佇列。
如果使用者已接受條款及細則，則不會顯示對話方塊，且回呼包含 termsAccepted = YES。
將 companyName 參數設為貴公司。公司名稱會顯示在條款及細則文字中。這段文字向使用者說明，該公司可能會將位置資料分享給這間公司，以提升營運效率。
從主執行緒呼叫此方法。多次呼叫而不等待回應不會產生任何效果。
- 參數：
-
title 對話方塊的標題。如果 title為 nil，對話方塊會使用預設標題。
- 注意：
- 對於自訂標題，這個方法的呼叫端需要將這個參數本地化。預設標題會由服務自動本地化。
- 參數：
-
companyName 發布應用程式的公司名稱，以及與 Google 達成分享位置資料的協議。 UIParams 定義對話方塊外觀和風格的參數。如果設為 nil，對話方塊會使用預設的外觀和風格。 回呼 封鎖已隨使用者回應傳送至主佇列。
| + (void) showTermsAndConditionsDialogIfNeededWithTitle： | (nullable NSString *) | title | |
| 公司名稱： | (NSString *) | companyName | |
| 回呼： | (GMSTermsResponseCallback) | 回呼 | |
使用預設外觀和風格顯示條款及細則對話方塊。
詳情請參閱 +showTermsAndConditionsDialogIfNeededWithTitle:companyName:UIParams:callback: 進一步瞭解參數 、companyName 和 callback。
| + (void) showTermsAndConditionsDialogIfNeededWithCompanyName： | (NSString *) | companyName | |
| 回呼： | (GMSTermsResponseCallback) | 回呼 | |
使用預設標題和外觀和風格顯示條款及細則對話方塊。
詳情請參閱「+showTermsAndConditionsDialogIf NeededWithTitle: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 |
傳回這個版本的 iOS 版 Navigation SDK 版本。
好友與相關職務說明文件
- (typedef void(^ GMSTermsResponseCallback)(BOOL 條款)) [related] |
在使用者接受或拒絕條款及細則時呼叫。
如果是 >= 5.5.0 以上的版本，termsAccepted 一律為 YES。
資源說明文件
- (BOOL) shouldOnlyShowDriverAwarenesssDisclaimer [read, write, assign] |
指出 showTermsAndConditionsDialogIfNeededWithCompanyName:callback: 是否應只顯示駕駛人認知免責事項。
預設值為 NO，且除了搭配 Navigation SDK 提供的預設條款和服務外，還會顯示免責事項。設為 YES，表示只應顯示駕駛人感知免責事項。
如果專案必須顯示「條款及細則」對話方塊，將這個變數設為 YES 就不會有任何作用。此外，getter 方法一律會傳回 NO。
這個屬性必須從主執行緒設定或讀取。