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 từ thiết bị di động vào SDK điều hướng của Google Maps dành cho iOS.

Hàm thành phần công khai tĩnh

(BOOL)+ areTermsAndConditionsAccepted của chúng tôi
 Đối với phiên bản >= 5.5.0, hãy 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.
(vô hiệu)+ showTermsAndConditionsDialogIfNeededWithOptions: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.
(vô hiệu)+ showTermsAndConditionsDialogIfNeededWithTitle:companyName:UIParams:callback:
 Không dùng nữa.
(vô hiệu)+ showTermsAndConditionsDialogIfNeededWithTitle:companyName:callback:
 Không dùng nữa.
(vô hiệu)+ showTermsAndConditionsDialogIfCầnedWithCompanyName:callback:
 Không dùng nữa.
(vô hiệu)+ resetTermsAndConditionsAccepted
 Đặt lại điều khoản và điều kiện về trạng thái không được chấp nhận.
(vô hiệu)+ setAbnormalTerminationReportingEnabled:
 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ư ứng dụng gặp sự cố trong khi SDK vẫn đang chạy.
(GMSNavigationSession rỗng *)+ createNavigationSession
 Tạo một phiên điều hướng mới không được 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 cho bản phát hành SDK điều hướng dành cho iOS này.

Tài sản

HOẠT ĐỘNGshouldOnlyShowDriverAwarenesssDisclaimer
 Không dùng nữa.

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

typedef trống(^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ề chức năng của thành viên

Đối với phiên bản >= 5.5.0, hãy 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 các phiên bản cũ hơn, hãy 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 đặt là false, các dịch vụ sẽ vô hiệu hoá quyền truy cập vào giao diện điều hướng.

+ (vô hiệu) showTermsAndConditionsDialogIfneededWithOptions: (GMSNavigationTermsAndConditionsOptions *) tuỳ chọn
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.

Các tham số:
tùy chọnĐối tượng GMSNavigationTermsAndConditionsOptions sửa đổi giao diện của hộp thoại điều khoản và điều kiện. Hãy xem @ GMSNavigationTermsAndConditionsOptions để biết thêm thông tin.
số gọi lạiChặ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) showTermsAndConditionsDialogIfCầnedWithTitle: (NSString rỗng *) tiêu đề
Tên công ty: (NSString *) companyName
UIParams: (GMSNavigationTermsDialogUIParams rỗng *) UIParams
gọi lại: (GMSTermsResponseCallback) lệnh gọi lại

Không dùng nữa.

Thay vào đó, hãy sử dụng showTermsAndConditionsDialogIfNeededWithOptions: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. 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 tham 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 cần chờ phản hồi sẽ không có hiệu lực.

Các tham số:
tiêu đềTiêu đề của hộp thoại. Nếu title là giá trị 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 bản địa hoá tham số này. Nội dung mặc định đượ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à ghi trong thoả thuận với Google về việc 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 là giá trị rỗng, hộp thoại sẽ sử dụng giao diện mặc định.
số gọi lạiChặ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) showTermsAndConditionsDialogIfCầnedWithTitle: (NSString rỗng *) tiêu đề
Tên công ty: (NSString *) companyName
gọi lại: (GMSTermsResponseCallback) lệnh gọi lại

Không dùng nữa.

Thay vào đó, hãy sử dụng showTermsAndConditionsDialogIfNeededWithOptions:callback:.

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

Hãy xem +showTermsAndConditionsDialogIfCầnedWithTitle:companyName:UIParams:callback: để biết thông tin chi tiết, bao gồm cả nội dung mô tả về các thông số companyNamecallback.

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

Không dùng nữa.

Thay vào đó, hãy sử dụng showTermsAndConditionsDialogIfNeededWithOptions:callback:.

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

Hãy xem +showTermsAndConditionsDialogIfCầnedWithTitle:companyName:UIParams:callback: để biết thông tin chi tiết, bao gồm cả nội dung mô tả về các tham số companyNamecallback.

Đặt lại đ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ề KHÔNG và #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 KHÔNG.

+ (vô hiệu) setAbnormalTerminationReportingEnabled: (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ư ứng dụng gặp sự cố trong khi SDK vẫn đang chạy.

Việc này cho phé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 phiên bản dịch vụ.

Thuộc tính này phải được thiết lập từ luồng chính.

Tạo một phiên điều hướng mới không được liên kết với chế độ xem bản đồ.

Việc này sẽ phân bổ và trả về một phiên điều hướng mới. Các điểm tham chiếu và lựa chọn có thể được thiết lập trong phiên và có thể thêm trình nghe vào phiên đó.

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

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 tiêu tốn bộ nhớ, dữ liệu và pin, vì vậy, bạn chỉ nên phân bổ phiên hoạt động nếu phiên điều hướng liên tục là tính năng chính của ứng dụng. Do đó, 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 theo chỉ dẫn, hãy nhớ bắt đầu giao diện người dùng điều hướng bằng phiên đi theo chỉ dẫn hiện có thay vì tạo một phiên mới.

Thời gian tồn tại của phiên điều hướng chịu sự điều chỉnh của ngữ nghĩa Đối tượng-C thông thường. Do đó, phương thức gọi của quy trình này phải lưu một tệp 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 cho bản phát hành SDK điều hướng dành cho iOS này.


- (typedef void(^ GMSTermsResponseCallback)(BOOL điều khoản đượ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 phiên bản >= 5.5.0, termsAccepted sẽ luôn có.


Tài liệu về thuộc tính

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

Không dùng nữa.

Thay vào đó, hãy sử dụng API GMSNavigationTermsAndConditionsOptions với showTermsAndConditionsDialogIfNeededWithOptions:callback:.

Cho biết liệu showTermsAndConditionsDialogIfNeededWithCompanyName:callback: có chỉ hiển thị tuyên bố từ chối trách nhiệm về mức độ nhận biết của người lái xe hay không. Giá trị mặc định là NO và tuyên bố từ chối trách nhiệm sẽ xuất hiện cùng với các điều khoản và dịch vụ mặc định mà SDK điều hướng cung cấp. Đặt thành YES để cho biết rằng chỉ hiển thị tuyên bố từ chối trách nhiệm về mức độ nhận biết của người lái xe.

Nếu dự án phải hiển thị 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 đọc từ luồng chính.

Lưu ý:
Tính năng này không còn được dùng nữa. Thay vào đó, hãy sử dụng API GMSNavigationTermsAndConditionsOptions.