Tổng quan
Đây là lớp chính của SDK Google Maps dành cho iOS và là điểm vào cho tất cả các phương pháp có liên quan đến bản đồ.
Bạn phải tạo thực thể cho bản đồ bằng một trong các hàm khởi tạo -init hoặc -initWithOptions:.
Bạn chỉ có thể đọc và sửa đổi GMSMapView trên luồng chính, tương tự như tất cả đối tượng UIKit. Việc gọi các phương thức này từ một luồng khác sẽ dẫn đến một ngoại lệ hoặc hành vi không xác định.
Hàm thành phần công khai | |
(instancetype) | – init |
Khởi động bằng CGctZero và các tuỳ chọn mặc định. | |
(instancetype) | – initWithOptions: |
Tạo chế độ xem bản đồ mới với các tuỳ chọn được cung cấp. | |
(instancetype) | – initWithFrame: |
(loại thực thể có thể mang giá trị rỗng) | – initWithCoder: |
(instancetype) | – initWithFrame:camera: |
Tạo và trả về một chế độ xem bản đồ, có mục tiêu là khung và máy ảnh. | |
(instancetype) | – initWithFrame:mapID:camera: |
Tạo và trả về chế độ xem bản đồ có khung, mã bản đồ và mục tiêu máy ảnh. | |
(vô hiệu) | – startRendering |
Yêu cầu bản đồ này tăng cường sức mạnh cho trình kết xuất của nó. | |
(vô hiệu) | - stopRendering |
Yêu cầu bản đồ này tắt nguồn trình kết xuất của nó. | |
(vô hiệu) | – xoá |
Xóa tất cả nội dung đánh dấu đã được thêm vào bản đồ, bao gồm điểm đánh dấu, hình nhiều đường và lớp mặt đất. | |
(vô hiệu) | – setMinZoom:maxZoom: |
Đặt minZoom và maxZoom . | |
(GMSCameraPosition có thể nhận giá trị rỗng *) | – cameraForBounds:insets: |
Tạo GMSCameraPosition hiển thị bounds với padding . | |
(vô hiệu) | – moveCamera: |
Thay đổi camera theo update . | |
(BOOL) | – areEqualForRenderingPosition:position: |
Kiểm tra xem các vị trí camera đã cho có thực sự khiến camera kết xuất như nhau hay không, có xét đến mức độ chính xác và các phép biến đổi được sử dụng nội bộ. | |
(GMSFeatureLayer < GMSPlaceFeature * > *) | – featureLayerOfFeatureType: |
Trả về lớp đối tượng thuộc kiểu được chỉ định. | |
(GMSDatasetFeatureLayer *) | – datasetFeatureLayerOfDatasetID: |
Trả về một lớp đối tượng tập dữ liệu của tập dữ liệu được chỉ định. | |
(vô hiệu) | – invalidateLayoutForAccessoryView: |
Vô hiệu hoá một khung hiển thị phụ kiện và kích hoạt bố cục lại cho khung hiển thị đó. | |
(vô hiệu) | – setHeaderAccessoryView: |
Đặt vị trí của chế độ xem phụ kiện bên dưới tiêu đề chính của giao diện người dùng điều hướng. | |
(vô hiệu) | – animateToCameraPosition: |
Tạo ảnh động cho máy ảnh của bản đồ này thành cameraPosition . | |
(vô hiệu) | – animateToLocation: |
As animateToCameraPosition:, nhưng chỉ thay đổi vị trí của máy ảnh (tức là từ vị trí hiện tại thành location ). | |
(vô hiệu) | – animateToZoom: |
Như animateToCameraPosition: nhưng chỉ thay đổi mức thu phóng của máy ảnh. | |
(vô hiệu) | – animateToBearing: |
Như animateToCameraPosition:, nhưng chỉ thay đổi góc của máy ảnh (tính bằng độ). | |
(vô hiệu) | – animateToViewingAngle: |
Như animateToCameraPosition:, nhưng chỉ thay đổi góc nhìn của camera (tính bằng độ). | |
(vô hiệu) | – animateWithCameraUpdate: |
Áp dụng cameraUpdate cho máy ảnh hiện tại, sau đó dùng kết quả theo animateToCameraPosition:. | |
(vô hiệu) | – didBeginPanGesture |
Phương thức này phải được gọi từ quá trình triển khai phương thức CPMapTemplateDelegate của ứng dụng -mapTemplateDidBeginPanCử chỉ: để triển khai cử chỉ kéo cho mẫu bản đồ trên CarPlay. | |
(vô hiệu) | – didUpdatePanGestureWithTranslation:velocity: |
Phương thức này phải được gọi từ quá trình triển khai của ứng dụng đối với phương thức CPMapTemplateDelegate -mapTemplate:didUpdatePanelectionWithTranslation: để triển khai cử chỉ kéo cho mẫu bản đồ CarPlay. | |
(vô hiệu) | – didEndPanGestureWithVelocity: |
Phương thức này phải được gọi từ quá trình triển khai của ứng dụng đối với phương thức CPMapTemplateDelegate -mapTemplate:didEndPanCử chỉWithVelocity: để triển khai cử chỉ kéo cho mẫu bản đồ trên CarPlay. | |
(BOOL) | – enableNavigationWithSession: |
Bắt đầu điều hướng trong chế độ xem bản đồ này bằng phiên điều hướng nhất định. | |
Hàm thành phần công khai tĩnh | |
(instancetype) | + mapWithFrame:camera: |
Tạo và trả về một chế độ xem bản đồ có mục tiêu khung và máy ảnh. | |
(instancetype) | + mapWithFrame:mapID:camera: |
Trình khởi chạy tiện lợi để tạo và trả về chế độ xem bản đồ với khung, ID bản đồ và mục tiêu máy ảnh. | |
Tài sản | |
Mã IBOutlet< GMSMapViewDelegate > | uỷ quyền |
uỷ quyền GMSMapView. | |
GMSCameraPosition * | máy ảnh |
Kiểm soát máy ảnh, giúp xác định cách hướng bản đồ. | |
GMSProjection * | phép chiếu |
Trả về đối tượng GMSProjection mà bạn có thể sử dụng để chuyển đổi giữa toạ độ màn hình và toạ độ vĩ độ/kinh độ. | |
HOẠT ĐỘNG | myLocationEnabled |
Kiểm soát việc có bật vòng kết nối dấu chấm và độ chính xác Vị trí của tôi hay không. | |
CLLocation * | myLocation |
Nếu Vị trí của tôi được bật, hiển thị nơi dấu chấm vị trí thiết bị đang được vẽ. | |
GMSMarker * | selectedMarker |
Điểm đánh dấu đã chọn. | |
HOẠT ĐỘNG | trafficEnabled |
Kiểm soát việc bản đồ có đang vẽ dữ liệu giao thông hay không, nếu có. | |
GMSMapViewType | mapType |
Kiểm soát loại ô bản đồ sẽ được hiển thị. | |
GMSMapStyle * | mapStyle |
Kiểm soát kiểu của bản đồ. | |
UIUserInterfaceStyle | overrideUserInterfaceStyle |
Thay đổi bản đồ thành [UIUserInterfaceStyle](https://developer.apple.com/documentation/uikit/uiuserinterfacestyle?language=objc) mong muốn. | |
độ chính xác đơn | minZoom |
Thu phóng tối thiểu (xa nhất mà camera có thể thu nhỏ). | |
độ chính xác đơn | maxZoom |
Thu phóng tối đa (máy ảnh có thể gần Trái đất nhất). | |
HOẠT ĐỘNG | buildingsEnabled |
Nếu được đặt, toà nhà 3D sẽ hiển thị nếu có. | |
HOẠT ĐỘNG | indoorEnabled |
Đặt liệu bản đồ trong nhà có hiển thị hay không (nếu có). | |
GMSIndoorDisplay * | indoorDisplay |
Tải thực thể GMSIndoorDisplay cho phép quan sát hoặc kiểm soát các khía cạnh của tính năng hiển thị dữ liệu trong nhà. | |
GMSUISettings * | chế độ cài đặt |
Lấy đối tượng GMSUISettings, đối tượng này kiểm soát các chế độ cài đặt giao diện người dùng cho bản đồ. | |
UIEdgeInsets | khoảng đệm |
Kiểm soát quyền "hiển thị" của chế độ xem. | |
GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
Kiểm soát cách thêm các phần lồng ghép vùng an toàn vào giá trị khoảng đệm. | |
HOẠT ĐỘNG | accessibilityElementsHidden |
Giá trị mặc định là YES. | |
GMSMapLayer * | lớp |
Trình truy cập cho loại CALayer tuỳ chỉnh dùng cho lớp. | |
GMSFrameRate | preferredFrameRate |
Kiểm soát tốc độ khung hình kết xuất. | |
GMSCoordinateBounds * | cameraTargetBounds |
Nếu không, hãy ràng buộc mục tiêu máy ảnh để các cử chỉ không thể khiến mục tiêu máy ảnh rời khỏi các giới hạn đã chỉ định. | |
GMSMapCapabilityFlags | mapCapabilities |
Tất cả các khả năng hiện có theo điều kiện (phụ thuộc vào mapID hoặc các chế độ cài đặt khác của bản đồ) hiện có tại thời điểm hiện tại. | |
Mã IBOutlet < GMSMapViewNavigationUIDelegate > | navigationUIDelegate |
Một thực thể đại diện của GMSMapView nhận lệnh gọi lại cho các sự kiện trên giao diện người dùng điều hướng. | |
HOẠT ĐỘNG | navigationEnabled |
Liệu chức năng điều hướng có được bật cho bản đồ này hay không. | |
GMSNavigator * | trình điều hướng |
Trình điều hướng cho GMSMapView này, cho phép yêu cầu các tuyến đường và bắt đầu hướng dẫn từng chặng. | |
GMSRoadSnappedLocationProvider * | roadSnappedLocationProvider |
Cho phép đăng ký nhận cập nhật vị trí đã xác định. | |
GMSLocationSimulator * | locationSimulator |
Cho phép bạn mô phỏng thông tin vị trí của thiết bị. | |
GMSNavigationCameraMode | cameraMode |
Chế độ của máy ảnh xác định hành vi của máy ảnh khi thuộc tính navigationEnabled được đặt thành YES. | |
GMSNavigationCameraPerspective | followingPerspective |
Góc nhìn của máy ảnh sẽ được dùng khi theo dõi vị trí của thiết bị. | |
GMSNavigationTravelMode | travelMode |
Chế độ đi lại xác định loại tuyến đường sẽ được tìm nạp và cách xác định hướng của thiết bị. | |
GMSNavigationLightingMode | lightingMode |
Chế độ ánh sáng xác định bảng phối màu nào sẽ được sử dụng để kết xuất bản đồ. | |
HOẠT ĐỘNG | shouldDisplaySpeedLimit |
Xác định xem có hiển thị giới hạn tốc độ khi hướng dẫn đang hoạt động và dữ liệu giới hạn tốc độ có sẵn hay không. | |
HOẠT ĐỘNG | shouldDisplaySpeedometer |
Chỉ định xem biểu tượng đồng hồ tốc độ có xuất hiện hay không. | |
UILayoutGuide * | navigationHeaderLayoutGuide |
Hình chữ nhật bị tiêu đề điều hướng che phủ. | |
UILayoutGuide * | navigationFooterLayoutGuide |
Hình chữ nhật nằm trong phần chân trang điều hướng. | |
GMSNavigationRouteCalloutFormat | routeCalloutFormat |
Chỉ định định dạng chú thích tuyến đường (mặc định, thời gian hoặc khoảng cách) để sử dụng. | |
độ chính xác đơn | followingZoomLevel |
Mức thu phóng được tuỳ chỉnh trong khi điều hướng. | |
GMSRoadSnappedLocationProvider * | roadSnappedMyLocationSource |
Đặt nhà cung cấp Vị trí của tôi cho chế độ xem bản đồ này. | |
Hàm liên quan | |
(Lưu ý rằng đây không phải là các hàm thành phần). | |
NSString *const | kGMSAccessibilityCompass |
Giá trị nhận dạng hỗ trợ tiếp cận cho nút la bàn. | |
NSString *const | kGMSAccessibilityMyLocation |
Giá trị nhận dạng hỗ trợ tiếp cận cho "vị trí của tôi" . | |
NSString *const | kGMSAccessibilityOutOfQuota |
Giá trị nhận dạng hỗ trợ tiếp cận cho tình trạng "hết hạn mức" nhãn lỗi. |
Tài liệu về chức năng của thành viên
– (instancetype) init |
Khởi động bằng CGctZero và các tuỳ chọn mặc định.
– (instancetype) initWithOptions: | (nonnull GMSMapViewOptions *) | tuỳ chọn |
Tạo chế độ xem bản đồ mới với các tuỳ chọn được cung cấp.
Phương thức này sẽ sao chép giá trị của đối tượng tuỳ chọn.
– (instancetype) initWithFrame: | (CGCG) | khung hình |
– (instancetype có thể mang giá trị rỗng) initWithCoder: | (NSCoder *) | bộ lập trình |
+ (instancetype) mapWithFrame: | (CGCG) | khung hình | |
máy ảnh: | (GMSCameraPosition *) | máy ảnh | |
Tạo và trả về một chế độ xem bản đồ có mục tiêu khung và máy ảnh.
+ (instancetype) mapWithFrame: | (CGCG) | khung hình | |
mapID: | (GMSMapID *) | mapID | |
máy ảnh: | (GMSCameraPosition *) | máy ảnh | |
Trình khởi chạy tiện lợi để tạo và trả về chế độ xem bản đồ với khung, ID bản đồ và mục tiêu máy ảnh.
– (instancetype) initWithFrame: | (CGCG) | khung hình | |
máy ảnh: | (GMSCameraPosition *) | máy ảnh | |
Tạo và trả về một chế độ xem bản đồ, có mục tiêu là khung và máy ả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 -init hoặc -initWithOptions:.
– (instancetype) initWithFrame: | (CGCG) | khung hình | |
mapID: | (GMSMapID *) | mapID | |
máy ảnh: | (GMSCameraPosition *) | máy ảnh | |
Tạo và trả về chế độ xem bản đồ có khung, mã bản đồ và mục tiêu máy ả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 -init hoặc -initWithOptions:.
– (vô hiệu) startRendering |
Yêu cầu bản đồ này tăng cường sức mạnh cho trình kết xuất của nó.
Trường này không bắt buộc và không thay đổi.
- Lưu ý:
- Tính năng này không còn được dùng nữa. Phương thức này đã lỗi thời và sẽ bị xoá trong bản phát hành sau này.
– (vô hiệu) stopRendering |
Yêu cầu bản đồ này tắt nguồn trình kết xuất của nó.
Trường này không bắt buộc và không thay đổi.
- Lưu ý:
- Tính năng này không còn được dùng nữa. Phương thức này đã lỗi thời và sẽ bị xoá trong bản phát hành sau này.
– (vô hiệu) xoá |
Xóa tất cả nội dung đánh dấu đã được thêm vào bản đồ, bao gồm điểm đánh dấu, hình nhiều đường và lớp mặt đất.
Thao tác này sẽ không xoá dấu chấm vị trí hiển thị hoặc đặt lại MapType hiện tại.
– (vô hiệu) setMinZoom: | (số thực có độ chính xác đơn) | minZoom | |
maxZoom: | (số thực có độ chính xác đơn) | maxZoom | |
Đặt minZoom
và maxZoom
.
Phương thức này dự kiến giá trị tối thiểu sẽ nhỏ hơn hoặc bằng giá trị tối đa và nếu không, sẽ gửi một ngoại lệ có tên NSPhạmException.
– (GMSCameraPosition *) cameraForBounds: | (GMSCoordinateBounds *) | giới hạn | |
phần lồng ghép: | (UIEdgeInsets) | phần lồng ghép | |
Tạo GMSCameraPosition hiển thị bounds
với padding
.
Máy ảnh sẽ có góc xoay và độ nghiêng bằng 0 (tức là hướng về phía bắc và nhìn trực tiếp vào Trái đất). Thao tác này sẽ tính đến khung và khoảng đệm của GMSMapView này.
Nếu các giới hạn không hợp lệ, phương thức này sẽ trả về một máy ảnh nil.
– (vô hiệu) moveCamera: | (GMSCameraUpdate *) | cập nhật |
Thay đổi camera theo update
.
Quá trình thay đổi camera sẽ diễn ra ngay lập tức (không có ảnh động).
– (BOOL) areEqualForRenderingPosition: | (GMSCameraPosition *) | vị trí | |
vị trí: | (GMSCameraPosition *) | otherPosition | |
Kiểm tra xem các vị trí camera đã cho có thực sự khiến camera kết xuất như nhau hay không, có xét đến mức độ chính xác và các phép biến đổi được sử dụng nội bộ.
– (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType: | (GMSFeatureType) | featureType |
Trả về lớp đối tượng thuộc kiểu được chỉ định.
Bạn phải định cấu hình các lớp tính năng trong Cloud Console.
Nếu một lớp thuộc loại đã chỉ định không tồn tại trên bản đồ này hoặc nếu chưa bật định kiểu dựa trên dữ liệu hoặc nếu không sử dụng khung kết xuất Kim loại, thì "isAvailable" của lớp thu được sẽ là NO
và sẽ không phản hồi bất kỳ lệnh gọi nào.
Cần có trình kết xuất đồ hoạ Metal. Tìm hiểu cách bật Metal tại https://developers.google.com/maps/documentation/ios-sdk/config#use-metal
– (GMSDatasetFeatureLayer *) datasetFeatureLayerOfDatasetID: | (NSString *) | datasetID |
Trả về một lớp đối tượng tập dữ liệu của tập dữ liệu được chỉ định.
Bạn phải định cấu hình mã tập dữ liệu trong Cloud Console.
Nếu tập dữ liệu có mã nhận dạng được chỉ định không tồn tại trên bản đồ này hoặc nếu không bật tính năng định kiểu dựa trên dữ liệu, thì "isAvailable" của lớp thu được sẽ là NO
và sẽ không phản hồi bất kỳ lệnh gọi nào.
– (vô hiệu) invalidateLayoutForAccessoryView: | (UIView< GMSNavigationAccessoryView > *) | accessoryView |
Vô hiệu hoá một khung hiển thị phụ kiện và kích hoạt bố cục lại cho khung hiển thị đó.
Chế độ xem phải là một trong các chế độ xem phụ kiện hiện tại. Nếu hướng dẫn không hoạt động, thì lệnh gọi này sẽ là hướng dẫn KHÔNG HOẠT ĐỘNG.
– (vô hiệu) setHeaderAccessoryView: | (nullable UIView< GMSNavigationAccessoryView > *) | headerAccessoryView |
Đặt vị trí của chế độ xem phụ kiện bên dưới tiêu đề chính của giao diện người dùng điều hướng.
Khi bạn chuyển giá trị 0, khung hiển thị phụ kiện sẽ bị xoá. Nếu hướng dẫn không hoạt động, thì lệnh gọi này là hướng dẫn KHÔNG HOẠT ĐỘNG.
@note Nếu chế độ xem bản đồ ngắn, SDK sẽ ẩn chế độ xem phụ kiện do không gian bị giới hạn. Các chế độ xem được quản lý nội bộ để tối ưu hóa việc hiển thị bản đồ.
– (vô hiệu) animateToCameraPosition: | (GMSCameraPosition *) | cameraPosition |
Tạo ảnh động cho máy ảnh của bản đồ này thành cameraPosition
.
– (vô hiệu) animateToLocation: | (CLLocationLocation2D) | vị trí |
As animateToCameraPosition:, nhưng chỉ thay đổi vị trí của máy ảnh (tức là từ vị trí hiện tại thành location
).
– (vô hiệu) animateToZoom: | (số thực có độ chính xác đơn) | thu phóng |
Như animateToCameraPosition: nhưng chỉ thay đổi mức thu phóng của máy ảnh.
Giá trị này được giới hạn bằng [kGMSMinZoom Level, kGMSMaxZoomLevel].
– (vô hiệu) animateToBearing: | (CLLocationDirection) | mang |
Như animateToCameraPosition:, nhưng chỉ thay đổi góc của máy ảnh (tính bằng độ).
Số 0 nghĩa là hướng chính bắc.
– (vô hiệu) animateToViewingAngle: | (gấp đôi) | viewingAngle |
Như animateToCameraPosition:, nhưng chỉ thay đổi góc nhìn của camera (tính bằng độ).
Giá trị này sẽ được giới hạn ở mức tối thiểu là 0 (tức là hướng thẳng xuống) và trong khoảng từ 30 đến 45 độ về phía đường chân trời, tuỳ thuộc vào độ gần tương đối với trái đất.
– (vô hiệu) animateWithCameraUpdate: | (GMSCameraUpdate *) | cameraUpdate |
Áp dụng cameraUpdate
cho máy ảnh hiện tại, sau đó dùng kết quả theo animateToCameraPosition:.
- (vô hiệu) didBeginPanGesture |
Phương thức này phải được gọi từ quá trình triển khai phương thức CPMapTemplateDelegate của ứng dụng -mapTemplateDidBeginPanCử chỉ: để triển khai cử chỉ kéo cho mẫu bản đồ trên CarPlay.
- (vô hiệu) DidUpdatePanCử chỉWithTranslation: | (CGPoint) | bản dịch | |
vận tốc: | (CGPoint) | vận tốc | |
Phương thức này phải được gọi từ quá trình triển khai của ứng dụng đối với phương thức CPMapTemplateDelegate -mapTemplate:didUpdatePanelectionWithTranslation: để triển khai cử chỉ kéo cho mẫu bản đồ CarPlay.
- (vô hiệu) didEndPanGestureWithVelocity: | (CGPoint) | vận tốc |
Phương thức này phải được gọi từ quá trình triển khai của ứng dụng đối với phương thức CPMapTemplateDelegate -mapTemplate:didEndPanCử chỉWithVelocity: để triển khai cử chỉ kéo cho mẫu bản đồ trên CarPlay.
– (BOOL) enableNavigationWithSession: | (GMSNavigationSession *) | navigationSession |
Bắt đầu điều hướng trong chế độ xem bản đồ này bằng phiên điều hướng nhất định.
- Lưu ý:
- để sử dụng bộ nhớ và CPU hiệu quả nhất, hãy gọi phương thức này trước khi gọi bất kỳ phương thức điều hướng nào khác liên quan đến điều hướng trên chế độ xem bản đồ này.
- Trường hợp trả lại hàng:
- Liệu quá trình chỉ đường đã bắt đầu thành công hay chưa (ví dụ: hệ thống sẽ trả về NO nếu bạn chưa chấp nhận các điều khoản và điều kiện).
Tài liệu về bạn bè và hàm liên quan
– (NSString* const) kGMSAccessibilityCompass [related] |
Giá trị nhận dạng hỗ trợ tiếp cận cho nút la bàn.
– (NSString* const) kGMSAccessibilityMyLocation [related] |
Giá trị nhận dạng hỗ trợ tiếp cận cho "vị trí của tôi" .
– (NSString* const) kGMSAccessibilityOutOfQuota [related] |
Giá trị nhận dạng hỗ trợ tiếp cận cho tình trạng "hết hạn mức" nhãn lỗi.
Tài liệu về thuộc tính
– (IBOutlet id<GMSMapViewDelegate>) uỷ quyền [read, write, assign] |
uỷ quyền GMSMapView.
– (GMSCameraPosition*) máy ảnh [read, write, copy] |
Kiểm soát máy ảnh, giúp xác định cách hướng bản đồ.
Quá trình sửa đổi thuộc tính này sẽ diễn ra ngay lập tức.
– (GMSProjection*) phép chiếu [read, assign] |
Trả về đối tượng GMSProjection mà bạn có thể sử dụng để chuyển đổi giữa toạ độ màn hình và toạ độ vĩ độ/kinh độ.
Đây là ảnh chụp nhanh của phép chiếu hiện tại và sẽ không tự động cập nhật khi máy ảnh di chuyển. Nó biểu thị hình chiếu của khung GMSMapView được vẽ gần đây nhất hoặc; nơi camera đã được đặt rõ ràng hoặc bản đồ vừa tạo, khung hình sắp tới. Nó sẽ không bao giờ là con số không.
– (BOOL) myLocationEnabled [read, write, assign] |
Kiểm soát việc có bật vòng kết nối dấu chấm và độ chính xác Vị trí của tôi hay không.
Mặc định là KHÔNG.
– (CLLocation*) myLocation [read, assign] |
Nếu Vị trí của tôi được bật, hiển thị nơi dấu chấm vị trí thiết bị đang được vẽ.
Nếu tính năng này bị tắt hoặc được bật nhưng không có dữ liệu vị trí, thì giá trị này sẽ là con số không. Bạn có thể quan sát thuộc tính này bằng KVO.
– (GMSMarker*) selectedMarker [read, write, assign] |
Điểm đánh dấu đã chọn.
Việc đặt thuộc tính này sẽ chọn một điểm đánh dấu cụ thể, hiển thị cửa sổ thông tin trên đó. Nếu thuộc tính này là 0, việc đặt thuộc tính này là 0 sẽ bỏ chọn điểm đánh dấu, ẩn cửa sổ thông tin. Bạn có thể quan sát thuộc tính này bằng KVO.
– (BOOL) trafficEnabled [read, write, assign] |
Kiểm soát việc bản đồ có đang vẽ dữ liệu giao thông hay không, nếu có.
Điều này phụ thuộc vào tính sẵn có của dữ liệu lưu lượng truy cập. Mặc định là KHÔNG.
– (GMSMapViewType) mapType [read, write, assign] |
Kiểm soát loại ô bản đồ sẽ được hiển thị.
Giá trị mặc định là kGMSTypeNormal.
– (GMSMapStyle*) mapStyle [read, write, assign] |
Kiểm soát kiểu của bản đồ.
MapStyle không phải là 0 sẽ chỉ áp dụng nếu mapType là Bình thường.
- (UIUserInterfaceStyle) overrideUserInterfaceStyle [read, write, assign] |
Thay đổi bản đồ thành [UIUserInterfaceStyle](https://developer.apple.com/documentation/uikit/uiuserinterfacestyle?language=objc) mong muốn.
Thao tác này sẽ ghi đè hành vi mặc định của UIKit và đặt giá trị mặc định là UIUserInterfaceStyleLight để đảm bảo khả năng tương thích ngược. Điều này ảnh hưởng đến bảng phối màu của các loại bản đồ Bình thường và Địa hình.
– (float) minZoom [read, assign] |
Thu phóng tối thiểu (xa nhất mà camera có thể thu nhỏ).
Giá trị mặc định là kGMSMinZoomLevel. Đã sửa đổi bằng -setMinZoom:maxZoom:.
– (float) maxZoom [read, assign] |
Thu phóng tối đa (máy ảnh có thể gần Trái đất nhất).
Giá trị mặc định là kGMSMaxZoomLevel. Đã sửa đổi bằng -setMinZoom:maxZoom:.
– (BOOL) buildingsEnabled [read, write, assign] |
Nếu được đặt, toà nhà 3D sẽ hiển thị nếu có.
Giá trị mặc định là YES.
Điều này có thể hữu ích khi thêm một lớp ô tuỳ chỉnh vào bản đồ, để làm cho lớp rõ hơn ở các mức thu phóng cao. Việc thay đổi giá trị này sẽ khiến tất cả các thẻ thông tin bị mất hiệu lực trong một thời gian ngắn.
– (BOOL) indoorEnabled [read, write, assign] |
Đặt liệu bản đồ trong nhà có hiển thị hay không (nếu có).
Giá trị mặc định là YES.
Nếu bạn đặt chính sách này thành KHÔNG, thì bộ nhớ đệm cho dữ liệu trong nhà có thể bị xoá hoàn toàn và mọi giá sàn mà người dùng cuối hiện đã chọn có thể được đặt lại.
– (GMSIndoorDisplay*) indoorDisplay [read, assign] |
Tải thực thể GMSIndoorDisplay cho phép quan sát hoặc kiểm soát các khía cạnh của tính năng hiển thị dữ liệu trong nhà.
- (GMSUISettings*) cài đặt [read, assign] |
Lấy đối tượng GMSUISettings, đối tượng này kiểm soát các chế độ cài đặt giao diện người dùng cho bản đồ.
– (UIEdgeInsets) khoảng đệm [read, write, assign] |
Kiểm soát quyền "hiển thị" của chế độ xem.
Bằng cách áp dụng khoảng đệm, một khu vực xung quanh cạnh của chế độ xem có thể được tạo ra. Khu vực này sẽ chứa dữ liệu bản đồ nhưng sẽ không chứa các thành phần điều khiển trên giao diện người dùng.
Nếu khoảng đệm không cân bằng, tâm thị giác của khung hiển thị sẽ di chuyển khi thích hợp. Khoảng đệm cũng sẽ ảnh hưởng đến thuộc tính projection
, vì vậy, vùng hiển thị sẽ không bao gồm vùng đệm. GMSCameraUpdate fitToBounds sẽ đảm bảo rằng cả khoảng đệm này và mọi khoảng đệm được yêu cầu sẽ được tính đến.
Thuộc tính này có thể được tạo ảnh động trong một khối ảnh động dựa trên UIView.
- (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] |
Kiểm soát cách thêm các phần lồng ghép vùng an toàn vào giá trị khoảng đệm.
Giống như khoảng đệm, vùng an toàn lồng ghép các công cụ điều khiển vị trí trên bản đồ, chẳng hạn như la bàn, nút vị trí của tôi và bộ chọn tầng trong vùng an toàn của thiết bị.
Giá trị mặc định là kGMSMapViewPadding AdjustBehaviorAlways.
– (BOOL) accessibilityElementsHidden [read, write, assign] |
Giá trị mặc định là YES.
Nếu bạn đặt thành KHÔNG, GMSMapView sẽ tạo phần tử hỗ trợ tiếp cận cho các đối tượng lớp phủ, chẳng hạn như GMSMarker và GMSPolyline.
Thuộc tính này tuân theo giao thức UIAccessibility không chính thức, ngoại trừ giá trị mặc định là YES.
– (GMSMapLayer*) lớp [read, retain] |
Trình truy cập cho loại CALayer tuỳ chỉnh dùng cho lớp.
– (GMSFrameRate) preferredFrameRate [read, write, assign] |
Kiểm soát tốc độ khung hình kết xuất.
Giá trị mặc định là kGMSFrameRateOptimize.
– (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign] |
Nếu không, hãy ràng buộc mục tiêu máy ảnh để các cử chỉ không thể khiến mục tiêu máy ảnh rời khỏi các giới hạn đã chỉ định.
– (GMSMapCapabilityFlags) mapCapabilities [read, assign] |
Tất cả các khả năng hiện có theo điều kiện (phụ thuộc vào mapID hoặc các chế độ cài đặt khác của bản đồ) hiện có tại thời điểm hiện tại.
Không bao gồm các tính năng có thể sử dụng bất cứ lúc nào.
– (IBOutlet id<GMSMapViewNavigationUIDelegate>) navigationUIDelegate [read, write, assign] |
Một thực thể đại diện của GMSMapView nhận lệnh gọi lại cho các sự kiện trên giao diện người dùng điều hướng.
– (BOOL) navigationEnabled [read, write, assign] |
Liệu chức năng điều hướng có được bật cho bản đồ này hay không.
Nếu lựa chọn này là CÓ, các tuyến đường và đường đi theo từng chặng có thể hiển thị trên bản đồ, camera có thể chuyển sang chế độ sau và nút căn giữa lại sẽ xuất hiện khi camera không theo dõi thông tin vị trí của thiết bị.
Nếu người dùng chưa chấp nhận các điều khoản và điều kiện của Google Navigation, việc đặt thuộc tính này sẽ không có hiệu lực. Để hiện hộp thoại điều khoản và điều kiện, hãy xem các phương thức trên GMSNavigationServices.
– (GMSNavigator*) trình điều hướng [read, assign] |
Trình điều hướng cho GMSMapView này, cho phép yêu cầu các tuyến đường và bắt đầu hướng dẫn từng chặng.
Nếu người dùng chưa chấp nhận các điều khoản và điều kiện của Google Navigation, thì giá trị này sẽ là con số không. Để hiện hộp thoại điều khoản và điều kiện, hãy xem các phương thức trên GMSNavigationServices.
– (GMSRoadSnappedLocationProvider*) roadSnappedLocationProvider [read, assign] |
Cho phép đăng ký nhận cập nhật vị trí đã xác định.
Nếu người dùng chưa chấp nhận các điều khoản và điều kiện của Google Navigation, thì giá trị này sẽ là con số không. Để hiện hộp thoại điều khoản và điều kiện, hãy xem các phương thức trên GMSNavigationServices.
– (GMSLocationSimulator*) locationSimulator [read, assign] |
Cho phép bạn mô phỏng thông tin vị trí của thiết bị.
Vị trí được mô phỏng ảnh hưởng đến vị trí của dấu chữ v trên bản đồ, tiến trình của hướng dẫn từng chặng và thông tin cập nhật do nhà cung cấp vị trí đã chụp được cung cấp.
Nếu người dùng chưa chấp nhận các điều khoản và điều kiện của Google Navigation, thì giá trị này sẽ là con số không. Để hiện hộp thoại điều khoản và điều kiện, hãy xem các phương thức trên GMSNavigationServices.
– (GMSNavigationCameraMode) cameraMode [read, write, assign] |
Chế độ của máy ảnh xác định hành vi của máy ảnh khi thuộc tính navigationEnabled được đặt thành YES.
Hãy xem GMSNavigationCameraMode
để biết các chế độ hiện có.
– (GMSNavigationCameraPerspective) followingPerspective [read, write, assign] |
Góc nhìn của máy ảnh sẽ được dùng khi theo dõi vị trí của thiết bị.
Bạn phải đặt thuộc tính navigationEnabled
thành YES và đặt cameraMode
thành GMSNavigationCameraModeSau để phối cảnh này có hiệu lực.
– (GMSNavigationTravelMode) travelMode [read, write, assign] |
Chế độ đi lại xác định loại tuyến đường sẽ được tìm nạp và cách xác định hướng của thiết bị.
Ở chế độ lái xe, hành trình của thiết bị dựa trên hướng chuyển động. Khi ở chế độ đi xe đạp hoặc đi bộ, khoá học sẽ dựa trên hướng la bàn mà thiết bị đang gặp. Khoá học của thiết bị được biểu thị bằng hướng của điểm đánh dấu vị trí thiết bị và do GMSRoadSnappedLocationProvider báo cáo.
– (GMSNavigationLightingMode) lightingMode [read, write, assign] |
Chế độ chiếu sáng xác định bảng phối màu nào sẽ được sử dụng để kết xuất bản đồ.
Thuộc tính này cũng được dùng để xác định màu mặc định của nhiều thành phần trên giao diện.
– (BOOL) shouldDisplaySpeedLimit [read, write, assign] |
Xác định xem có hiển thị giới hạn tốc độ khi hướng dẫn đang hoạt động và dữ liệu giới hạn tốc độ có sẵn hay không.
Giá trị mặc định là KHÔNG.
– (BOOL) shouldDisplaySpeedometer [read, write, assign] |
Chỉ định xem biểu tượng đồng hồ tốc độ có xuất hiện hay không.
Khi được bật, biểu tượng đồng hồ tốc độ cho biết tốc độ của xe sẽ xuất hiện ở góc dưới cùng trong khi hướng dẫn. Khi có dữ liệu giới hạn tốc độ đáng tin cậy, biểu tượng giới hạn tốc độ cũng sẽ xuất hiện và được đính kèm với biểu tượng đồng hồ tốc độ. Biểu tượng đồng hồ tốc độ có thể có các màu khác nhau cho văn bản và nền, tuỳ thuộc vào mức độ nghiêm trọng của cảnh báo tốc độ.
Nếu nút căn giữa được bật, thì giới hạn tốc độ và biểu tượng đồng hồ tốc độ tạm thời bị ẩn khi nút căn giữa xuất hiện.
– (UILayoutGuide*) navigationHeaderLayoutGuide [read, assign] |
Hình chữ nhật bị tiêu đề điều hướng che phủ.
Chiều cao bằng 0 khi tiêu đề bị ẩn.
– (UILayoutGuide*) navigationFooterLayoutGuide [read, assign] |
Hình chữ nhật nằm trong phần chân trang điều hướng.
Chiều cao bằng 0 khi chân trang bị ẩn.
– (GMSNavigationRouteCalloutFormat) routeCalloutFormat [read, write, assign] |
Chỉ định định dạng chú thích tuyến đường (mặc định, thời gian hoặc khoảng cách) để sử dụng.
– (float) followingZoomLevel [read, write, assign] |
Mức thu phóng được tuỳ chỉnh trong khi điều hướng.
Việc đặt giá trị này sẽ ghi đè mức thu phóng mặc định của SDK điều hướng khi máy ảnh đang theo vị trí của thiết bị (tức là cameraMode
bằng GMSNavigationCameraModeFollowing
). Bạn có thể đặt giá trị này thành GMSNavigationNoFollowingZoomLevel
nếu không sử dụng chế độ ghi đè mức thu phóng nào.
– (GMSRoadSnappedLocationProvider*) roadSnappedMyLocationSource [read, write, assign] |
Đặt nhà cung cấp Vị trí của tôi cho chế độ xem bản đồ này.
Thông thường, dấu chấm Vị trí của tôi và vòng tròn độ chính xác cho chế độ xem bản đồ được định hướng bởi vị trí thực tế của thiết bị. Bằng cách đặt thuộc tính này, dấu chấm và vòng tròn Độ chính xác của Vị trí của tôi sẽ được định hướng theo vị trí đã xác định của đường từ nhà cung cấp vị trí nhất định. Để trở về trạng thái bình thường, hãy đặt thuộc tính này thành Null.
Việc này không có hiệu lực khi bạn bật navigationEnabled
cho chế độ xem bản đồ này.