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

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

Tổng quan

Chế độ cài đặt cho giao diện người dùng của GMSMapView.

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

(void) setAllGesturesEnabled:
 Đặt tuỳ chọn bật (mặc định) hay tắt tất cả cử chỉ.

Thuộc tính

CẢM ƠNscrollGestures
 Kiểm soát việc bật (mặc định) hay tắt cử chỉ cuộn.
CẢM ƠNzoomGestures
 Kiểm soát xem bạn muốn bật (mặc định) hay tắt cử chỉ thu phóng.
CẢM ƠNtiltGestures
 Kiểm soát xem bạn muốn bật (mặc định) hay tắt cử chỉ nghiêng.
CẢM ƠNrotateGestures
 Kiểm soát xem bạn muốn bật (mặc định) hay tắt cử chỉ xoay.
CẢM ƠNconsumesGesturesInView
 Kiểm soát xem GMSMapView có sử dụng toàn bộ cử chỉ của người dùng hay không khi cử chỉ được bật (mặc định là CÓ).
CẢM ƠNcompassButton
 Bật hoặc tắt la bàn.
CẢM ƠNmyLocationButton
 Bật hoặc tắt nút Vị trí của tôi.
CẢM ƠNindoorPicker
 Bật (mặc định) hoặc tắt bộ chọn sàn trong nhà.
CẢM ƠNallowScrollGesturesDuringRotateOrZoom
 Kiểm soát xem có thể thực hiện các cử chỉ xoay và thu phóng hay không và cuộn xung quanh (mặc định là CÓ).
CẢM ƠNnavigationHeaderEnabled
 Bật hoặc tắt tiêu đề điều hướng.
CẢM ƠNnavigationFooterEnabled
 Bật hoặc tắt chân trang điều hướng.
CẢM ƠNnavigationTripProgressBarEnabled
 Bật hoặc tắt thanh tiến trình chuyến đi điều hướng.
CẢM ƠNrecenterButtonEnabled
 Bật hoặc tắt nút căn giữa.
CẢM ƠNshowsIncidentCards
 Liệu thẻ hiển thị thông tin chi tiết về sự cố có xuất hiện ở đầu bản đồ khi người dùng nhấn vào biểu tượng sự cố hay không, ví dụ như đường bị đóng.
CẢM ƠNshowsDestinationMarkers
 Liệu điểm đánh dấu điểm đến cho các tuyến đường có hiển thị hay không.
CẢM ƠNshowsTrafficLights
 Có hiển thị đèn giao thông dọc theo tuyến đường trong khi điều hướng hay không.
CẢM ƠNshowsStopSigns
 Có hiển thị biển báo dừng dọc theo tuyến đường trong khi di chuyển hay không.
UIColor * navigationHeaderPrimaryBackgroundColor
 Màu nền chính để sử dụng cho tiêu đề điều hướng.
UIColor * navigationHeaderSecondaryBackgroundColor
 Màu nền phụ để dùng cho tiêu đề điều hướng.
CGFloatnavigationHeaderBackgroundAlpha
 Giá trị alpha của chế độ xem tiêu đề điều hướng.
UIColor * navigationHeaderPrimaryBackgroundColorNightMode
 Màu nền chính của tiêu đề điều hướng (ở chế độ ban đêm) khi tiêu đề điều hướng hiển thị bước hiện tại.
UIColor * navigationHeaderSecondaryBackgroundColorNightMode
 Màu nền phụ của tiêu đề điều hướng (ở chế độ ban đêm) khi tiêu đề điều hướng hiển thị bước hiện tại.
UIColor * navigationHeaderLargeManeuverIconColor
 Màu của biểu tượng thao tác trong chế độ xem tiêu đề của phần điều hướng chính.
UIColor * navigationHeaderSmallManeuverIconColor
 Màu của biểu tượng điều khiển trong chế độ xem tiêu đề điều hướng khi rẽ tiếp theo.
UIColor * navigationHeaderGuidanceRecommendedLaneColor
 Màu của làn đường hoặc các làn đường được đề xuất.
UIColor * navigationHeaderNextStepTextColor
 Màu của văn bản trong tiêu đề bước tiếp theo khi tiêu đề điều hướng hiển thị bước hiện tại.
UIFont * navigationHeaderNextStepFont
 Phông chữ của văn bản trong tiêu đề bước tiếp theo.
UIColor * navigationHeaderDistanceValueTextColor
 Màu của văn bản cho giá trị khoảng cách khi tiêu đề điều hướng hiển thị bước hiện tại.
UIFont * navigationHeaderDistanceValueFont
 Phông chữ của văn bản cho giá trị khoảng cách.
UIColor * navigationHeaderDistanceUnitsTextColor
 Màu của văn bản cho đơn vị khoảng cách khi tiêu đề điều hướng hiển thị bước hiện tại.
UIFont * navigationHeaderDistanceUnitsFont
 Phông chữ của văn bản cho đơn vị khoảng cách.
UIColor * navigationHeaderInstructionsTextColor
 Màu của văn bản trong phần hướng dẫn.
UIFont * navigationHeaderInstructionsFirstRowFont
 Phông chữ của văn bản cho hàng đầu tiên trong phần hướng dẫn.
UIFont * navigationHeaderInstructionsSecondRowFont
 Phông chữ của văn bản cho hàng thứ hai trong phần hướng dẫn.
UIFont * navigationHeaderInstructionsConjunctionsFont
 Phông chữ của văn bản cho các liên từ trong phần hướng dẫn.
GMSNavigationSpeedometerUIOptionsspeedometerUIOptions
 Đặt cấu hình giao diện người dùng của đồng hồ tốc độ dựa trên mức độ nghiêm trọng của cảnh báo tốc độ.

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

– (vô hiệu) setAllGesturesEnabled: (BOOL)  đã bật

Đặt tuỳ chọn bật (mặc định) hay tắt tất cả cử chỉ.

Điều này không hạn chế người dùng nhấn vào bất kỳ nút nào trên màn hình để di chuyển máy ảnh (ví dụ: la bàn hoặc bộ điều khiển thu phóng), cũng như không hạn chế các thao tác di chuyển có lập trình và ảnh động.


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

– (BOOL) scrollGestures [read, write, assign] (Cử chỉ cuộn)

Kiểm soát việc bật (mặc định) hay tắt cử chỉ cuộn.

Nếu được bật, người dùng có thể kéo để xoay máy ảnh. Điều này không hạn chế khả năng di chuyển có lập trình của camera.

– (BOOL) zoomGestures [read, write, assign] (Cử chỉ thu phóng)

Kiểm soát xem bạn muốn bật (mặc định) hay tắt cử chỉ thu phóng.

Nếu tính năng này được bật, người dùng có thể nhấn đúp/nhấn bằng hai ngón tay hoặc chụm để thu phóng máy ảnh. Điều này không hạn chế khả năng di chuyển có lập trình của camera.

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

Kiểm soát xem bạn muốn bật (mặc định) hay tắt cử chỉ nghiêng.

Nếu được bật, người dùng có thể sử dụng thao tác vuốt lên hoặc vuốt xuống bằng hai ngón tay để nghiêng máy ảnh. Điều này không giới hạn chế độ kiểm soát có lập trình đối với Góc xem của camera.

– (BOOL) rotateGestures (Cử chỉ xoay vòng) [read, write, assign]

Kiểm soát xem bạn muốn bật (mặc định) hay tắt cử chỉ xoay.

Nếu được bật, người dùng có thể sử dụng cử chỉ xoay bằng hai ngón tay để xoay máy ảnh. Điều này không giới hạn khả năng kiểm soát có lập trình đối với góc phương vị của máy ảnh.

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

Kiểm soát xem GMSMapView có sử dụng toàn bộ cử chỉ của người dùng hay không khi cử chỉ được bật (mặc định là CÓ).

Việc này ngăn khung hiển thị gốc nhận được những cử chỉ này.

Khi GMSMapView nằm trong UIScrollView (hoặc khu vực có thể cuộn khác), điều này có nghĩa là các cử chỉ trên bản đồ sẽ không được sử dụng thêm dưới dạng cử chỉ cuộn. Tuy nhiên, việc tắt tuỳ chọn này (đặt thành NO) có thể hữu ích để hỗ trợ các yêu cầu hoặc hệ phân cấp khung hiển thị phức tạp.

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

Bật hoặc tắt la bàn.

La bàn là một biểu tượng trên bản đồ cho biết hướng bắc trên bản đồ.

Nếu được bật, thông số này chỉ hiển thị khi máy ảnh bị xoay khỏi hướng mặc định (biện pháp mang giá trị 0). Khi người dùng nhấn vào la bàn, máy ảnh sẽ tự định hướng về hướng mặc định và biến mất ngay sau đó. Nếu bị tắt, la bàn sẽ không bao giờ được hiển thị.

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

Bật hoặc tắt nút Vị trí của tôi.

Đây là nút hiển thị trên bản đồ. Nút này sẽ được căn giữa bản đồ vào vị trí hiện tại của người dùng khi người dùng nhấn vào.

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

Bật (mặc định) hoặc tắt bộ chọn sàn trong nhà.

Nếu được bật, chế độ xem này chỉ hiển thị khi chế độ xem tập trung vào một toà nhà có dữ liệu về tầng trong nhà. Nếu bị tắt, bạn vẫn có thể kiểm soát tầng đã chọn thông qua thuộc tính internalDisplay mapView.

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

Kiểm soát xem có thể thực hiện các cử chỉ xoay và thu phóng hay không và cuộn xung quanh (mặc định là CÓ).

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

Bật hoặc tắt tiêu đề điều hướng.

Tiêu đề hiển thị hướng dẫn ở phía trên cùng của bản đồ. Trường này mặc định là YES.

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

Bật hoặc tắt chân trang điều hướng.

Chân trang hiển thị thông tin về khoảng cách và giờ đến dự kiến ở cuối bản đồ. Trường này mặc định là YES.

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

Bật hoặc tắt thanh tiến trình chuyến đi điều hướng.

Thanh tiến trình chuyến đi hiển thị các chi tiết của chuyến đi phía trước trong chế độ xem tuyến tính ở cạnh sau của bản đồ. Chính sách này mặc định là KHÔNG.

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

Bật hoặc tắt nút căn giữa.

Nếu bạn đặt thành CÓ, nút căn giữa sẽ hiển thị nếu máy ảnh hiện không đi theo vị trí của người dùng hoặc nếu máy ảnh đang theo dõi nhưng mức thu phóng khác biệt đáng kể so với mặc định. Trường này mặc định là YES.

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

Liệu thẻ hiển thị thông tin chi tiết về sự cố có xuất hiện ở đầu bản đồ khi người dùng nhấn vào biểu tượng sự cố hay không, ví dụ như đường bị đóng.

Trường này mặc định là YES.

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

Liệu điểm đánh dấu điểm đến cho các tuyến đường có hiển thị hay không.

Trường này mặc định là YES.

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

Có hiển thị đèn giao thông dọc theo tuyến đường trong khi điều hướng hay không.

Các thay đổi đối với chế độ cài đặt này chỉ có hiệu lực trong các yêu cầu định tuyến tiếp theo.

Sau khi áp dụng chế độ cài đặt này, giao diện người dùng sẽ hiển thị 3 đèn giao thông sắp tới hoặc biển báo dừng bất cứ lúc nào trong khi đi theo chỉ dẫn, miễn là có sẵn dữ liệu.

Giá trị mặc định là NO.

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

Có hiển thị biển báo dừng dọc theo tuyến đường trong khi di chuyển hay không.

Các thay đổi đối với chế độ cài đặt này chỉ có hiệu lực trong các yêu cầu định tuyến tiếp theo.

Sau khi áp dụng chế độ cài đặt này, giao diện người dùng sẽ hiển thị 3 đèn giao thông sắp tới hoặc biển báo dừng bất cứ lúc nào trong khi đi theo chỉ dẫn, miễn là có sẵn dữ liệu.

Giá trị mặc định là NO.

– (UIColor*) navigationHeaderPrimaryBackgroundColor [read, write, copy]

Màu nền chính để sử dụng cho tiêu đề điều hướng.

Giá trị mặc định là nil. Khi giá trị của thuộc tính này là nil, màu xanh lục sẽ được dùng làm màu nền chính.

– (UIColor*) navigationHeaderSecondaryBackgroundColor [read, write, copy]

Màu nền phụ để dùng cho tiêu đề điều hướng.

Xuất hiện dưới dạng màu nền trong trình đơn thả xuống hướng dẫn làn đường và ngã rẽ tiếp theo. Giá trị mặc định là nil. Khi giá trị của thuộc tính này là bằng không, màu xanh lục đậm sẽ được dùng làm màu nền phụ. UIColor cung cấp phải nằm trong hệ màu hỗ trợ [UIColor getRed:green:blue:alpha]. Nếu không, thuộc tính này sẽ bị bỏ qua.

– (CGFloat) navigationHeaderBackgroundAlpha [read, write, assign]

Giá trị alpha của chế độ xem tiêu đề điều hướng.

Giá trị này mặc định là 1.0f (mờ hoàn toàn).

– (UIColor*) navigationHeaderPrimaryBackgroundColorNightMode [read, write, copy]

Màu nền chính của tiêu đề điều hướng (ở chế độ ban đêm) khi tiêu đề điều hướng hiển thị bước hiện tại.

Giá trị mặc định là nil. Khi giá trị của thuộc tính này bằng 0, navigationHeaderPrimaryBackgroundColor sẽ được sử dụng.

– (UIColor*) navigationHeaderSecondaryBackgroundColorNightMode [read, write, copy]

Màu nền phụ của tiêu đề điều hướng (ở chế độ ban đêm) khi tiêu đề điều hướng hiển thị bước hiện tại.

Giá trị mặc định là nil. Khi giá trị của thuộc tính này bằng 0, navigationHeaderSecondaryBackgroundColor sẽ được sử dụng.

– (UIColor*) navigationHeaderLargeManeuverIconColor [read, write, copy]

Màu của biểu tượng thao tác trong chế độ xem tiêu đề của phần điều hướng chính.

– (UIColor*) navigationHeaderSmallManeuverIconColor [read, write, copy]

Màu của biểu tượng điều khiển trong chế độ xem tiêu đề điều hướng khi rẽ tiếp theo.

– (UIColor*) navigationHeaderGuidanceRecommendedLaneColor [read, write, copy]

Màu của làn đường hoặc các làn đường được đề xuất.

Giá trị mặc định là màu trắng. Thuộc tính này chỉ được xem xét nếu tiêu đề điều hướng hiển thị bước điều hướng hiện tại. Lưu ý rằng các làn đường khác (là những làn đường mà người lái xe không nên đi) sẽ được tô màu tự động bằng cách sử dụng phiên bản xám của màu nền phụ.

– (UIColor*) navigationHeaderNextStepTextColor [read, write, copy]

Màu của văn bản trong tiêu đề bước tiếp theo khi tiêu đề điều hướng hiển thị bước hiện tại.

Giá trị mặc định là nil. Khi giá trị của thuộc tính này bằng không hoặc khi điều hướng hiển thị bất kỳ bước nào khác, màu trắng sẽ được sử dụng.

- (UIFont*) navigationHeaderNextStepFont [read, write, copy]

Phông chữ của văn bản trong tiêu đề bước tiếp theo.

Giá trị mặc định là nil. Khi giá trị của thuộc tính này bằng nil, phông chữ hệ thống có kích thước 16.0f sẽ được sử dụng.

– (UIColor*) navigationHeaderDistanceValueTextColor [read, write, copy]

Màu của văn bản cho giá trị khoảng cách khi tiêu đề điều hướng hiển thị bước hiện tại.

Giá trị mặc định là nil. Khi giá trị của thuộc tính này bằng không hoặc khi điều hướng hiển thị bất kỳ bước nào khác, màu trắng sẽ được sử dụng.

- (UIFont*) navigationHeaderDistanceValueFont [read, write, copy]

Phông chữ của văn bản cho giá trị khoảng cách.

Giá trị mặc định là nil. Khi giá trị của thuộc tính này bằng nil, hệ thống sẽ sử dụng phông chữ đậm có kích thước 24.0f.

– (UIColor*) navigationHeaderDistanceUnitsTextColor [read, write, copy]

Màu của văn bản cho đơn vị khoảng cách khi tiêu đề điều hướng hiển thị bước hiện tại.

Giá trị mặc định là nil. Khi giá trị của thuộc tính này bằng không hoặc khi điều hướng hiển thị bất kỳ bước nào khác, màu xám sẽ được sử dụng.

- (UIFont*) navigationHeaderDistanceUnitsFont [read, write, copy]

Phông chữ của văn bản cho đơn vị khoảng cách.

Giá trị mặc định là nil. Khi giá trị của thuộc tính này là nil, phông chữ hệ thống có kích thước 18.0f sẽ được sử dụng.

– (UIColor*) navigationHeaderInstructionsTextColor [read, write, copy]

Màu của văn bản trong phần hướng dẫn.

Giá trị mặc định là nil. Khi giá trị của thuộc tính này bằng 0, màu trắng sẽ được sử dụng.

- (UIFont*) navigationHeaderInstructionsFirstRowFont [read, write, copy]

Phông chữ của văn bản cho hàng đầu tiên trong phần hướng dẫn.

Giá trị mặc định là nil. Khi giá trị của thuộc tính này bằng không, phông chữ đậm của hệ thống có kích thước 30 sẽ được sử dụng.

– (UIFont*) navigationHeaderInstructionsSecondRowFont [read, write, copy]

Phông chữ của văn bản cho hàng thứ hai trong phần hướng dẫn.

Giá trị mặc định là nil. Khi giá trị của thuộc tính này bằng không, phông chữ đậm của hệ thống có kích thước 24 sẽ được sử dụng.

- (UIFont*) navigationHeaderInstructionsConjunctionsFont [read, write, copy]

Phông chữ của văn bản cho các liên từ trong phần hướng dẫn.

Giá trị mặc định là nil. Khi giá trị của thuộc tính này bằng 0, phông chữ đậm của hệ thống có kích thước 18 sẽ được sử dụng.

Đặt cấu hình giao diện người dùng của đồng hồ tốc độ dựa trên mức độ nghiêm trọng của cảnh báo tốc độ.

Bằng cách thiết lập GMSNavigationSpeedometerUIOptions, bạn sẽ xoá thành phần trước đó nếu đã đặt. Khi không có GMSNavigationSpeedometerUIOptions được định cấu hình, giao diện người dùng cảnh báo tốc độ sẽ chuyển sang cấu hình mặc định của NavSDK:

  • Cảnh báo tốc độ nhỏ ở chế độ ban ngày: văn bản màu đỏ trên nền trắng.
  • Cảnh báo tốc độ nhỏ ở chế độ ban đêm: văn bản màu đỏ trên nền tối.
  • Cảnh báo tốc độ lớn ở chế độ ban ngày: văn bản màu trắng trên nền đỏ.
  • Cảnh báo tốc độ lớn ở chế độ ban đêm: văn bản màu trắng trên nền đỏ.