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

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

Tổng quan

Điểm đánh dấu là một biểu tượng được đặt tại một điểm cụ thể trên bề mặt bản đồ.

Biểu tượng của điểm đánh dấu được vẽ theo hướng dựa vào màn hình của thiết bị chứ không phải bề mặt của bản đồ; tức là biểu tượng này không nhất thiết sẽ thay đổi hướng do việc xoay, nghiêng hoặc thu phóng trên bản đồ.

Kế thừa GMSOverlay.

Kế thừa bởi GMSAdvancedMarker.

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

(loại thực thể)+ markerWithPosition:
 Hàm khởi tạo tiện lợi cho một điểm đánh dấu mặc định.
(Hình ảnh giao diện người dùng *)+ benchmarkImageWithColor:
 Tạo phiên bản phủ màu của hình ảnh điểm đánh dấu mặc định để sử dụng làm biểu tượng.

Thuộc tính

CLLocationCoordinate2Dvị trí
 Vị trí điểm đánh dấu.
NSString * đoạn mã
 Văn bản đoạn nội dung, hiển thị bên dưới tiêu đề trong cửa sổ thông tin khi được chọn.
Hình ảnh giao diện người dùng * biểu tượng
 Biểu tượng điểm đánh dấu để hiển thị.
UIView * iconView
 Khung hiển thị đánh dấu để kết xuất.
CẢM ƠNtracksViewChanges
 Kiểm soát xem có nên vẽ lại biểu tượng cho điểm đánh dấu này cho mọi khung hình hay không.
CẢM ƠNtracksInfoWindowChanges
 Kiểm soát xem có nên vẽ lại mọi khung hình trong cửa sổ thông tin cho điểm đánh dấu này hay không.
CGPointgroundAnchor
 Neo trên mặt đất chỉ định điểm trong hình ảnh biểu tượng được neo vào vị trí của điểm đánh dấu trên bề mặt Trái đất.
CGPointinfoWindowAnchor
 Neo cửa sổ thông tin chỉ định điểm trong hình ảnh biểu tượng mà tại đó cửa sổ thông tin sẽ được hiển thị trực tiếp phía trên điểm này.
GMSMarkerAnimationappearAnimation
 Kiểm soát ảnh động được sử dụng khi điểm đánh dấu này được đặt trên GMSMapView (kGMSMarkerAnimationNone mặc định, không có ảnh động).
CẢM ƠNcó thể kéo được
 Kiểm soát xem có thể kéo điểm đánh dấu này theo cách tương tác hay không (mặc định là KHÔNG).
CẢM ƠNbằng phẳng
 Kiểm soát xem điểm đánh dấu này nên nằm trên bề mặt Trái Đất (CÓ) hay biển quảng cáo hướng về máy ảnh (KHÔNG, mặc định).
CLLocation bằngxoay
 Đặt xoay điểm đánh dấu theo độ theo chiều kim đồng hồ đối với điểm neo của điểm neo.
float độ mờ
 Đặt độ mờ của điểm đánh dấu, từ 0 (hoàn toàn trong suốt) đến 1 (mặc định).
GMSMarkerLayerlớp
 Cung cấp lớp Ảnh động cốt lõi cho GMSMarker này.
GMSPanoramaViewpanoramaView
 panoramaView chỉ định chế độ xem toàn cảnh nào sẽ cố gắng hiển thị điểm đánh dấu này.
NSString * tiêu đề
 Tiêu đề, nội dung mô tả ngắn về lớp phủ.
GMSMapViewbản đồ
 Bản đồ có lớp phủ này.
CẢM ƠNcó thể nhấn
 Liệu lớp phủ này có gây ra thông báo nhấn không.
int zIndex
 Lớp phủ có giá trị zIndex cao hơn sẽ được vẽ trên các lớp và lớp ô có giá trị zIndex thấp hơn.
id [mã_nhận_dạng]userData
 Dữ liệu lớp phủ.

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

+ (instancetype) markerWithPosition: (CLLocationCoordinate2D)  vị trí

Hàm khởi tạo tiện lợi cho một điểm đánh dấu mặc định.

+ (UIImage *) markerImageWithColor: (nullable UIColor *)  color [màu sắc]

Tạo phiên bản phủ màu của hình ảnh điểm đánh dấu mặc định để sử dụng làm biểu tượng.


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

- (CLLocationCoordinate2D) vị trí [read, write, assign]

Vị trí điểm đánh dấu.

Hoạt ảnh.

– (NSString*) snippet [read, write, copy]

Văn bản đoạn nội dung, hiển thị bên dưới tiêu đề trong cửa sổ thông tin khi được chọn.

- (UIImage*) biểu tượng [read, write, assign]

Biểu tượng điểm đánh dấu để hiển thị.

Nếu không có giá trị, hãy sử dụng điểm đánh dấu địa điểm SDK mặc định.

Hỗ trợ hình ảnh động, nhưng mỗi khung hình phải có cùng kích thước, nếu không hành vi thì không xác định.

Hỗ trợ việc sử dụng alignRectInsets để chỉ định khu vực nhấn giảm. Thao tác này cũng xác định lại cách chỉ định neo. Đối với hình ảnh động, giá trị cho ảnh động được sử dụng, không phải của từng khung hình riêng lẻ.

– (UIView*) iconView [read, write, assign]

Khung hiển thị đánh dấu để kết xuất.

Nếu giá trị không có, hãy quay lại thuộc tính icon.

Hỗ trợ ảnh động của tất cả các thuộc tính có thể tạo ảnh động của UIView, ngoại trừ framecenter. Không hỗ trợ việc thay đổi các thuộc tính này hoặc phiên bản CALayer tương ứng, bao gồm cả position.

Lưu ý rằng khung hiển thị hoạt động như thể clipsToBounds được đặt thành YES, bất kể giá trị thực tế là gì.

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

Kiểm soát xem có nên vẽ lại biểu tượng cho điểm đánh dấu này cho mọi khung hình hay không.

Xin lưu ý rằng khi biểu tượng này thay đổi từ KHÔNG thành CÓ, chúng tôi đảm bảo sẽ vẽ lại khung hình tiếp theo.

Giá trị mặc định là YES. Không có tác dụng nếu iconView giá trị bằng không.

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

Kiểm soát xem có nên vẽ lại mọi khung hình trong cửa sổ thông tin cho điểm đánh dấu này hay không.

Xin lưu ý rằng khi điều này thay đổi từ NO thành YES, cửa sổ thông tin đảm bảo sẽ được vẽ lại khung tiếp theo.

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

– (CGPoint) groundAnchor [read, write, assign]

Neo trên mặt đất chỉ định điểm trong hình ảnh biểu tượng được neo vào vị trí của điểm đánh dấu trên bề mặt Trái đất.

Điểm này được xác định trong không gian liên tục [0,0, 1,0] x [0,0, 1,0], trong đó (0,0) là góc trên cùng bên trái của hình ảnh, và (1,1) là góc dưới cùng bên phải.

Nếu hình ảnh có căn chỉnhRectInsets khác 0, thì phần trên cùng bên trái và dưới cùng bên phải được đề cập ở trên tham chiếu đến phần phần lồng ghép của hình ảnh.

– (CGPoint) infoWindowAnchor [read, write, assign]

Neo cửa sổ thông tin chỉ định điểm trong hình ảnh biểu tượng mà tại đó cửa sổ thông tin sẽ được hiển thị trực tiếp phía trên điểm này.

Điểm này được chỉ định trong cùng một không gian với surfaceAnchor.

– (GMSMarkerAnimation) appearAnimation [read, write, assign]

Kiểm soát ảnh động được sử dụng khi điểm đánh dấu này được đặt trên GMSMapView (kGMSMarkerAnimationNone mặc định, không có ảnh động).

– (BOOL) có thể kéo [read, write, assign]

Kiểm soát xem có thể kéo điểm đánh dấu này theo cách tương tác hay không (mặc định là KHÔNG).

– (BOOL) đồng đều [read, write, assign]

Kiểm soát xem điểm đánh dấu này nên nằm trên bề mặt Trái Đất (CÓ) hay biển quảng cáo hướng về máy ảnh (KHÔNG, mặc định).

– (CLLocationdegrees) xoay [read, write, assign]

Đặt xoay điểm đánh dấu theo độ theo chiều kim đồng hồ đối với điểm neo của điểm neo.

Trục quay vuông góc với điểm đánh dấu. Xoay 0 tương ứng với vị trí mặc định của điểm đánh dấu. Hoạt ảnh.

Khi điểm đánh dấu nằm trên bản đồ, vị trí mặc định được căn chỉnh theo hướng bắc và xoay sao cho điểm đánh dấu luôn ở trạng thái phẳng trên bản đồ. Khi điểm đánh dấu là biển quảng cáo, vị trí mặc định là hướng lên trên và xoay sao cho điểm đánh dấu luôn hướng về phía máy ảnh.

– (nổi) độ mờ [read, write, assign]

Đặt độ mờ của điểm đánh dấu, từ 0 (hoàn toàn trong suốt) đến 1 (mặc định).

– (GMSMarkerLayer*) lớp [read, assign]

Cung cấp lớp Ảnh động cốt lõi cho GMSMarker này.

– (GMSPanoramaView*) panoramaView [read, write, assign]

panoramaView chỉ định chế độ xem toàn cảnh nào sẽ cố gắng hiển thị điểm đánh dấu này.

Lưu ý rằng nếu position của điểm đánh dấu cách quá xa vị trí ảnh toàn cảnh hiện tại của panoramaView, nó sẽ không được hiển thị vì kích thước quá nhỏ.

Có thể đặt thành giá trị rỗng để xoá điểm đánh dấu khỏi bất kỳ chế độ xem ảnh toàn cảnh hiện tại nào mà điểm đánh dấu này được đính kèm vào.

Một điểm đánh dấu có thể được hiển thị trên cả ảnh toàn cảnh và bản đồ cùng một lúc.

– (NSString*) title [read, write, copy, inherited]

Tiêu đề, nội dung mô tả ngắn về lớp phủ.

Một số lớp phủ, chẳng hạn như điểm đánh dấu, sẽ hiển thị tiêu đề trên bản đồ. Tiêu đề cũng là văn bản hỗ trợ tiếp cận mặc định.

- (GMSMapView*) map [read, write, assign, inherited]

Bản đồ có lớp phủ này.

Việc đặt thuộc tính này sẽ thêm lớp phủ vào bản đồ. Đặt nó thành nil sẽ xoá lớp phủ này khỏi bản đồ. Lớp phủ có thể được kích hoạt trên tối đa một bản đồ tại bất kỳ thời điểm nào.

– (BOOL) có thể nhấn [read, write, assign, inherited]

Liệu lớp phủ này có gây ra thông báo nhấn không.

Theo mặc định, một số lớp phủ, chẳng hạn như điểm đánh dấu, sẽ có thể nhấn vào.

– (int) zIndex [read, write, assign, inherited]

Lớp phủ có giá trị zIndex cao hơn sẽ được vẽ trên các lớp và lớp ô có giá trị zIndex thấp hơn.

Các giá trị bằng nhau dẫn đến thứ tự bản vẽ không xác định. Điểm đánh dấu là một ngoại lệ. Bất kể zIndex là gì, chúng sẽ luôn được vẽ phía trên các lớp ô và các lớp phủ không phải điểm đánh dấu khác; chúng được xem xét một cách hiệu quả để nằm trong nhóm chỉ mục z riêng biệt so với các lớp phủ khác.

– (id) userData [read, write, assign, inherited]

Dữ liệu lớp phủ.

Bạn có thể sử dụng thuộc tính này để liên kết một đối tượng tuỳ ý với lớp phủ này. SDK Google Maps dành cho iOS không đọc hay ghi thuộc tính này.

Xin lưu ý rằng userData không được chứa bất kỳ tham chiếu rõ ràng nào đến bất kỳ đối tượng Maps nào, nếu không, chu kỳ giữ lại có thể sẽ được tạo (ngăn các đối tượng được giải phóng).