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

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

Tổng quan

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

Kế thừa GMSMarker.

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

(instancetype)+ markerWithPosition:
 Hàm khởi tạo tiện lợi cho một điểm đánh dấu mặc định.
(Giao diện người dùng *)+ markerImageWithColor:
 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

GMSCollisionBehaviorcollisionBehavior
 Hành vi va chạm của điểm đánh dấu, xác định liệu khả năng hiển thị của điểm đánh dấu có bị ảnh hưởng bởi các điểm đánh dấu khác hoặc nội dung được gắn nhãn trên bản đồ hay không.
CLLocationVị trí2Dvị trí
 Vị trí điểm đánh dấu.
NSString * đoạn trích
 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 để kết xuất.
UIView * iconView
 Khung hiển thị điểm đánh dấu để kết xuất.
CẢM GIÁCtracksViewChanges
 Kiểm soát xem có nên vẽ lại biểu tượng cho điểm đánh dấu này ở mọi khung hình hay không.
CẢM GIÁCtracksInfoWindowChanges
 Kiểm soát xem có nên vẽ lại cửa sổ thông tin cho điểm đánh dấu này hay không.
CGPointgroundAnchor
 Neo 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 để neo cửa sổ thông tin, sẽ được hiển thị ngay 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 (mặc định là kGMSMarkerAnimationNone, không có ảnh động).
CẢM GIÁCcó thể kéo
 Kiểm soát việc 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 GIÁCcố định
 Kiểm soát xem điểm đánh dấu này có 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 (KHÔNG, mặc định).
CLLocation bằngxoay
 Đặt hướng xoay điểm đánh dấu theo độ theo chiều kim đồng hồ đối với điểm neo của điểm đánh dấu.
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ố hiển thị điểm đánh dấu này.
NSString * tiêu đề [title]
 Tiêu đề, một đoạn mô tả ngắn về lớp phủ.
GMSMapViewbản đồ
 Bản đồ có lớp phủ này.
CẢM GIÁCcó thể nhấn
 Liệu lớp phủ này có gây ra thông báo nhấn hay không.
int zIndex
 Lớp phủ có giá trị zIndex cao hơn sẽ được vẽ trên các lớp xếp kề và lớp phủ có giá trị zIndex thấp hơn.
mã nhận dạnguserData
 Dữ liệu lớp phủ.

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

+ (instancetype) markerWithPosition: (CLLocation Phối hợp2D) 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ề tài sản

– (GMSCollisionBehavior) collisionBehavior [read, write, assign]

Hành vi va chạm của điểm đánh dấu, xác định liệu khả năng hiển thị của điểm đánh dấu có bị ảnh hưởng bởi các điểm đánh dấu khác hoặc nội dung được gắn nhãn trên bản đồ hay không.

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

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

Hoạt hình.

– (NSString*) đoạn trích [read, write, copy, inherited]

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, inherited]

Biểu tượng điểm đánh dấu để kết xuất.

Nếu không có, 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 phải có cùng kích thước, nếu không hành vi không được xác định.

Hỗ trợ việc sử dụng alignRectInsets để chỉ định khu vực nhấn thu nhỏ. Việ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, inherited]

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

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

Hỗ trợ ảnh động của mọi thuộc tính có thể tạo ảnh động của UIView, ngoại trừ framecenter. Hệ thống không hỗ trợ 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ị sẽ hoạt động như thể clipsToBounds được đặt thành YES, bất kể giá trị thực tế.

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

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

Lưu ý rằng khi biểu tượng này thay đổi từ KHÔNG thành CÓ, biểu tượng này chắc chắn sẽ được vẽ lại khung tiếp theo.

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

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

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

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

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

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

Neo 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 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 nêu trên tham chiếu đến phần lồng ghép của hình ảnh.

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

Neo cửa sổ thông tin chỉ định điểm trong hình ảnh biểu tượng để neo cửa sổ thông tin, sẽ được hiển thị ngay trên điểm này.

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

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

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

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

Kiểm soát việc 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) bằng phẳng [read, write, assign, inherited]

Kiểm soát xem điểm đánh dấu này có 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 (KHÔNG, mặc định).

Xoay (CLLocationdegrees) [read, write, assign, inherited]

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

Trục xoay 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 hình.

Khi điểm đánh dấu nằm bằng phẳng trên bản đồ, vị trí mặc định sẽ được căn chỉnh theo hướng bắc và xoay để điểm đánh dấu luôn bằng phẳng trên bản đồ. Khi điểm đánh dấu là biển quảng cáo, vị trí mặc định sẽ 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.

- (độ mờ) độ mờ [read, write, assign, inherited]

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

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

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

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

panoramaView chỉ định chế độ xem toàn cảnh nào sẽ cố 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 vị trí ảnh toàn cảnh hiện tại của panoramaView quá xa, điểm đánh dấu sẽ không được hiển thị vì vị trí quá nhỏ.

Có thể đặt thành nil để xoá điểm đánh dấu khỏi bất kỳ chế độ xem toàn cảnh hiện tại nào có đính kèm điểm đánh dấu đó.

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 đề, một đoạn 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ị tên trên bản đồ. Tiêu đề cũng là văn bản hỗ trợ tiếp cận mặc định.

– (GMSMapView*) bản đồ [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 đồ. Nếu bạn đặt giá trị này thành nil, thì lớp phủ này sẽ bị xoá khỏi bản đồ. Lớp phủ có thể hoạt động 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 hay không.

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

– (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 xếp kề và lớp phủ có giá trị zIndex thấp hơn.

Các giá trị bằng nhau dẫn đến thứ tự 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 thẻ thông tin và các lớp phủ không phải dấu đánh dấu khác; chúng được coi là nằm trong một 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, một chu kỳ lưu giữ có thể được tạo ra (ngăn các đối tượng được phát hành).