Tài liệu tham khảo về lớp GMSNavigationServices

Tài liệu tham khảo về lớp GMSNavigationServices

Tổng quan

Các dịch vụ cho phép kiểm soát quyền truy cập trên thiết bị di động vào SDK điều hướng của Google Maps dành cho iOS.

Hàm thành viên công khai tĩnh

(BOOL) + areTermsAndConditionsAccepted
 Đối với phiên bản >= 5.5.0, cho biết liệu người dùng đã xác nhận các điều khoản và điều kiện hay chưa.
(void) + showTermsAndConditionsDialogIfNeededWithTitle:companyName:UIParams:callback:
 Hiển thị hộp thoại phương thức nếu người dùng ứng dụng chưa chấp nhận các điều khoản và điều kiện của SDK điều hướng.
(void) + showTermsAndConditionsDialogIfNeededWithTitle:companyName:callback:
 Hiển thị hộp thoại điều khoản và điều kiện bằng giao diện mặc định.
(void) + showTermsAndConditionsDialogIfNeededWithCompanyName:callback:
 Hiển thị hộp thoại điều khoản và điều kiện bằng cách sử dụng tiêu đề và giao diện mặc định.
(void) + resetTermsAndConditionsAccepted
 Đặt lại các điều khoản và điều kiện về trạng thái không được chấp nhận.
(void) + setAbnormalChấmReportingEnabled:
 Cho phép báo cáo các trường hợp chấm dứt SDK bất thường, chẳng hạn như sự cố ứng dụng trong khi SDK vẫn đang chạy.
(có thể nhận giá trị rỗng GMSNavigationSession *)+ createNavigationSession
 Tạo một phiên chỉ đường mới không liên kết với chế độ xem bản đồ.
(NSString *)+ openSourceLicenseInfo
 Trả về thông tin giấy phép phần mềm nguồn mở cho SDK Điều hướng của Google dành cho iOS.
(NSString *)+ navSDKVersion
 Trả về phiên bản của bản phát hành SDK điều hướng dành cho iOS này.

Thuộc tính

CẢM GIÁCshouldOnlyShowDriverAwarenesssDisclaimer
 Cho biết liệu showTermsAndConditionsDialogIfNeededWithCompanyName:callback: có nên chỉ hiển thị tuyên bố từ chối trách nhiệm để nâng cao mức độ nhận biết của người lái xe hay không.

(Lưu ý rằng đây không phải là các hàm thành phần.)

typedef void(^ GMSTermsResponseCallback )(Chấp nhận các điều khoản BOOL)
 Được gọi khi người dùng chấp nhận hoặc từ chối các điều khoản và điều kiện.

Tài liệu về hàm thành phần

Đối với phiên bản >= 5.5.0, cho biết liệu người dùng đã xác nhận các điều khoản và điều kiện hay chưa.

Đối với phiên bản cũ, cho biết liệu người dùng đã chấp nhận các điều khoản và điều kiện hay chưa.

Nếu bạn đặt chính sách này thành false, thì các dịch vụ sẽ tắt quyền truy cập vào giao diện điều hướng.

+ (vô hiệu) showTermsAndConditionsDialogIfNeededWithTitle: (nullable NSString *)  tiêu đề [title]
tên công ty: (NSString *) companyName
UIParams: (có thể nhận giá trị rỗng GMSNavigationTermsDialogUIParams *) UIParams
gọi lại: (GMSTermsResponseCallback) lệnh gọi lại

Hiển thị hộp thoại phương thức nếu người dùng ứng dụng chưa chấp nhận các điều khoản và điều kiện của SDK điều hướng.

Lệnh gọi lại được gửi trên hàng đợi chính cùng với phản hồi của người dùng.

Nếu người dùng đã chấp nhận các điều khoản và điều kiện, thì sẽ không có hộp thoại nào xuất hiện và lệnh gọi lại chứa termsAccepted = YES.

Đặt thông số companyName thành công ty của bạn. Tên công ty xuất hiện trong văn bản điều khoản và điều kiện. Văn bản này giải thích cho người dùng ứng dụng rằng dữ liệu vị trí có thể được chia sẻ với công ty này để cải thiện hoạt động.

Gọi phương thức này từ luồng chính. Nhiều lệnh gọi mà không phải chờ phản hồi sẽ không có tác dụng.

Các tham số:
titleTiêu đề của hộp thoại. Nếu title giá trị là rỗng, hộp thoại sẽ sử dụng tiêu đề mặc định.
Lưu ý:
Đối với tiêu đề tuỳ chỉnh, phương thức gọi của phương thức này cần phải bản địa hoá tham số này. Tiêu đề mặc định sẽ được các dịch vụ bản địa hoá tự động.
Các tham số:
companyNameTên của công ty phát hành ứng dụng và trong thoả thuận với Google để chia sẻ dữ liệu vị trí.
UIParamsCác tham số xác định giao diện của hộp thoại. Nếu giá trị không có, hộp thoại sẽ sử dụng giao diện mặc định.
số gọi lạiThao tác chặn được gửi trên hàng đợi chính cùng với phản hồi của người dùng.
+ (vô hiệu) showTermsAndConditionsDialogIfNeededWithTitle: (nullable NSString *)  tiêu đề [title]
tên công ty: (NSString *) companyName
gọi lại: (GMSTermsResponseCallback) lệnh gọi lại

Hiển thị hộp thoại điều khoản và điều kiện bằng giao diện mặc định.

Vui lòng xem +showTermsAndConditionsDialogIfNeededWithTitle:companyName:UIParams:callback: để biết chi tiết, bao gồm cả nội dung mô tả về các tham số , companyNamecallback.

+ (vô hiệu) showTermsAndConditionsDialogIfDemandedWithCompanyName: (NSString *) companyName
gọi lại: (GMSTermsResponseCallback) lệnh gọi lại

Hiển thị hộp thoại điều khoản và điều kiện bằng cách sử dụng tiêu đề và giao diện mặc định.

Hãy xem +showTermsAndConditionsDialogIfDemandedWithTitle:companyName:UIParams:callback: để biết chi tiết, bao gồm cả nội dung mô tả các tham số companyNamecallback.

Đặt lại các điều khoản và điều kiện về trạng thái không được chấp nhận.

Sau khi gọi phương thức này, areTermsAndConditionsAccepted sẽ trả về giá trị KHÔNG, đồng thời #if SDK_BUILD_CONFIG(EnableNavSDKSkipToSOptions) showTermsAndConditionsDialogIfNeededWithOptions:callback: và #endif showTermsAndConditionsDialogIfNeededWithCompanyName:callback: sẽ hiển thị hộp thoại điều khoản và điều kiện. Thuộc tính navigationEnabled của mọi thực thể GMSMapView hiện có sẽ được đặt lại thành NO.

+ (void) setAbnormalReportingReportingEnabled: (BOOL)  abnormalTerminationReportingEnabled

Cho phép báo cáo các trường hợp chấm dứt SDK bất thường, chẳng hạn như sự cố ứng dụng trong khi SDK vẫn đang chạy.

Việc này giúp Google cải thiện độ ổn định của SDK (nếu có). Giá trị mặc định là YES và giá trị phải được cập nhật trước khi khởi chạy thực thể dịch vụ.

Thuộc tính này phải được đặt từ luồng chính.

+ (có thể nhận GMSNavigationSession rỗng *) createNavigationSession

Tạo một phiên chỉ đường mới không liên kết với chế độ xem bản đồ.

Thao tác này sẽ phân bổ và trả về một phiên điều hướng mới. Bạn có thể đặt các điểm tham chiếu và tuỳ chọn trong phiên và người nghe có thể được thêm vào đó.

Nếu bạn chưa chấp nhận các điều khoản và điều kiện, thì phương thức này sẽ trả về giá trị bằng 0. Đó là lý do duy nhất khiến phương thức này trả về nil.

Bạn có thể liên kết phiên này với một bản đồ sau khi tạo bản đồ bằng cách sử dụng phương thức GMSMapView -enableNavigationWithSession:. Phiên là các đối tượng nặng sử dụng bộ nhớ, dữ liệu và pin. Vì vậy, chỉ nên phân bổ phiên nếu một phiên chỉ đường liên tục là một tính năng chính của ứng dụng. Cũng vì lý do này, nếu ứng dụng của bạn tạo một giao diện người dùng điều hướng sau khi thiết lập một phiên điều hướng, hãy nhớ bắt đầu giao diện người dùng điều hướng bằng phiên điều hướng hiện có thay vì tạo một phiên mới.

Thời gian tồn tại của phiên chỉ đường chịu sự điều chỉnh của ngữ nghĩa Objective-C thông thường. Do đó, phương thức gọi của quy trình này sẽ lưu tham chiếu đến phiên.

+ (NSString *) openSourceLicenseInfo

Trả về thông tin giấy phép phần mềm nguồn mở cho SDK Điều hướng của Google dành cho iOS.

Thông tin này phải có trong đơn đăng ký của bạn.

+ (NSString *) navSDKVersion

Trả về phiên bản của bản phát hành SDK điều hướng dành cho iOS này.


– (typedef void(^ GMSTermsResponseCallback)(điều khoản BOOL được chấp nhận)) [related]

Được gọi khi người dùng chấp nhận hoặc từ chối các điều khoản và điều kiện.

Đối với các phiên bản >= 5.5.0, termsAccepted sẽ luôn là YES.


Tài liệu về tài sản

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

Cho biết liệu showTermsAndConditionsDialogIfNeededWithCompanyName:callback: có nên chỉ hiển thị tuyên bố từ chối trách nhiệm để nâng cao mức độ nhận biết của người lái xe hay không.

Tuỳ chọn mặc định là NO và tuyên bố từ chối trách nhiệm sẽ hiển thị cùng với các điều khoản và dịch vụ mặc định được cung cấp kèm theo SDK Điều hướng. Đặt thành YES để cho biết rằng chỉ tuyên bố từ chối trách nhiệm về mức độ nhận biết của người lái xe mới được hiển thị.

Nếu dự án phải hiện hộp thoại Điều khoản và điều kiện, thì việc đặt biến này thành YES sẽ không có hiệu lực. Ngoài ra, phương thức getter luôn trả về NO .

Thuộc tính này phải được đặt hoặc đọc từ luồng chính.