<GMSMapViewdelegate> Tài liệu tham khảo về giao thức

Tham chiếu giao thức <GMSMapViewdelegate>

Tổng quan

Uỷ quyền cho các sự kiện trên GMSMapView.

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

(void) mapView:willMove:
 Được gọi trước khi máy ảnh trên bản đồ thay đổi, do cử chỉ, ảnh động (ví dụ: do người dùng nhấn vào nút "Vị trí của tôi") hoặc do được cập nhật rõ ràng qua máy ảnh hoặc ảnh động có độ dài bằng 0 trên lớp.
(void) mapView:didChangeCameraPosition:
 Được gọi nhiều lần trong bất kỳ ảnh động hoặc cử chỉ nào trên bản đồ (hoặc một lần, nếu máy ảnh được đặt rõ ràng).
(void) mapView:idleAtCameraPosition:
 Được gọi khi bản đồ chuyển sang trạng thái rảnh, sau khi mọi cử chỉ hoặc ảnh động nổi bật đã hoàn tất (hoặc sau khi máy ảnh đã được đặt rõ ràng).
(void) - mapView:didTapAtCoordinate:
 Được gọi sau cử chỉ nhấn tại một toạ độ cụ thể, nhưng chỉ khi không nhấn vào một điểm đánh dấu.
(void) - mapView:didLongPressAtCoordinate:
 Được gọi sau một cử chỉ nhấn và giữ tại một toạ độ cụ thể.
(BOOL) mapView:didTapMarker:
 Được gọi sau khi nhấn vào một điểm đánh dấu.
(void) mapView:didTapInfoWindowOfMarker:
 Được gọi sau khi bạn nhấn vào cửa sổ thông tin của một điểm đánh dấu.
(void) mapView:didLongPressInfoWindowOfMarker:
 Được gọi sau khi bạn nhấn và giữ cửa sổ thông tin của một điểm đánh dấu.
(void) mapView:didTapOverlay:
 Được gọi sau khi nhấn vào một lớp phủ.
(void) mapView:didTapPOIWithPlaceID:name:location:
 Được gọi sau khi nhấn vào một địa điểm yêu thích.
(UIView rỗng *)mapView:markerInfoWindow:
 Được gọi khi một điểm đánh dấu sắp được chọn, đồng thời cung cấp một cửa sổ thông tin tuỳ chỉnh không bắt buộc để sử dụng cho điểm đánh dấu đó nếu phương thức này trả về một UIView.
(UIView rỗng *)- mapView:markerInfoContents:
 Được gọi khi mapView:markerInfoWindow: trả về nil.
(void) mapView:didCloseInfoWindowOfMarker:
 Được gọi khi cửa sổ thông tin của điểm đánh dấu bị đóng.
(void) mapView:didBeginDraggingMarker:
 Được gọi khi thao tác kéo đã được bắt đầu trên một điểm đánh dấu.
(void) mapView:didEndDraggingMarker:
 Được gọi sau khi kết thúc kéo một điểm đánh dấu.
(void) mapView:didDragMarker:
 Được gọi trong khi một điểm đánh dấu đang được kéo.
(BOOL) didTapMyLocationButtonForMapView:
 Được gọi khi nhấn vào nút Vị trí của tôi.
(void) mapView:didTapMyLocation:
 Được gọi khi người dùng nhấn vào Dấu chấm vị trí của tôi.
(void) mapViewDidStartTileRendering:
 Được gọi khi thẻ thông tin vừa được yêu cầu hoặc nhãn vừa bắt đầu kết xuất.
(void) mapViewDidFinishTileRendering:
 Được gọi khi tất cả các ô đã được tải (hoặc bị lỗi vĩnh viễn) và nhãn đã được hiển thị.
(void) mapViewSnapshotReady:
 Được gọi khi bản đồ ổn định (các thẻ thông tin được tải, nhãn được kết xuất, máy ảnh ở trạng thái rảnh) và các đối tượng lớp phủ đã được kết xuất.
(void) mapView:didChangeMapCapabilities:
 Được gọi mỗi khi các chức năng của bản đồ được thay đổi.
(void) mapView:didTapFeatures:inFeatureLayer:atLocation:
 Được gọi sau khi các đối tượng trong lớp tính năng định kiểu theo hướng dữ liệu được nhấn vào.

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

- (vô hiệu) mapView: (GMSMapView *) mapView
willMove: (BOOL)  cử chỉ
[optional]

Được gọi trước khi máy ảnh trên bản đồ thay đổi, do cử chỉ, ảnh động (ví dụ: do người dùng nhấn vào nút "Vị trí của tôi") hoặc do được cập nhật rõ ràng qua máy ảnh hoặc ảnh động có độ dài bằng 0 trên lớp.

Các tham số:
mapViewChế độ xem bản đồ được nhấn vào.
cử chỉNếu CÓ, điều này xảy ra do cử chỉ của người dùng.
- (vô hiệu) mapView: (GMSMapView *) mapView
wasChangeCameraPosition: (GMSCameraPosition *) vị trí
[optional]

Được gọi nhiều lần trong bất kỳ ảnh động hoặc cử chỉ nào trên bản đồ (hoặc một lần, nếu máy ảnh được đặt rõ ràng).

Có thể một số vị trí trung gian của máy ảnh sẽ không được gọi. Thuộc tính này luôn được gọi cho vị trí cuối cùng của ảnh động hoặc cử chỉ.

- (vô hiệu) mapView: (GMSMapView *) mapView
nhàn rỗiAtCameraPosition: (GMSCameraPosition *) vị trí
[optional]

Được gọi khi bản đồ chuyển sang trạng thái rảnh, sau khi mọi cử chỉ hoặc ảnh động nổi bật đã hoàn tất (hoặc sau khi máy ảnh đã được đặt rõ ràng).

- (vô hiệu) mapView: (GMSMapView *) mapView
DidTapAtCoordinate: (CLLocationCoordinate2D)  tọa độ
[optional]

Được gọi sau cử chỉ nhấn tại một toạ độ cụ thể, nhưng chỉ khi không nhấn vào một điểm đánh dấu.

Thao tác này được gọi trước khi bỏ chọn bất kỳ điểm đánh dấu hiện được chọn nào (hành động ngầm ẩn để nhấn vào bản đồ).

- (vô hiệu) mapView: (GMSMapView *) mapView
DidLongPressAtCoordinate: (CLLocationCoordinate2D)  tọa độ
[optional]

Được gọi sau một cử chỉ nhấn và giữ tại một toạ độ cụ thể.

Các tham số:
mapViewChế độ xem bản đồ được nhấn vào.
toạ độVị trí đã nhấn.
- (BOOL) mapView: (GMSMapView *) mapView
wasTapMarker: (GMSMarker *) điểm đánh dấu
[optional]

Được gọi sau khi nhấn vào một điểm đánh dấu.

Các tham số:
mapViewChế độ xem bản đồ được nhấn vào.
điểm đánh dấuĐiểm đánh dấu đã nhấn.
Trả về:
CÓ nếu phương thức uỷ quyền này xử lý sự kiện nhấn, điều này ngăn bản đồ thực hiện hành vi lựa chọn mặc định, và KHÔNG nếu bản đồ sẽ tiếp tục với hành vi lựa chọn mặc định.
- (vô hiệu) mapView: (GMSMapView *) mapView
wasTapInfoWindowOfMarker: (Hoạt động ) (GMSMarker *) điểm đánh dấu
[optional]

Được gọi sau khi bạn nhấn vào cửa sổ thông tin của một điểm đánh dấu.

- (vô hiệu) mapView: (GMSMapView *) mapView
DidLongPressInfoWindowOfMarker: (GMSMarker *) điểm đánh dấu
[optional]

Được gọi sau khi bạn nhấn và giữ cửa sổ thông tin của một điểm đánh dấu.

- (vô hiệu) mapView: (GMSMapView *) mapView
wasTapOverlay: (Lớp phủ): (GMSOverlay *) lớp phủ
[optional]

Được gọi sau khi nhấn vào một lớp phủ.

Phương thức này không được gọi cho các lượt nhấn vào điểm đánh dấu.

Các tham số:
mapViewChế độ xem bản đồ được nhấn vào.
lớp phủLớp phủ được nhấn.
- (vô hiệu) mapView: (GMSMapView *) mapView
DidTapPOIWithPlaceID: (NSString *) placeID
tên: (NSString *) name
vị trí: (CLLocationCoordinate2D)  vị trí
[optional]

Được gọi sau khi nhấn vào một địa điểm yêu thích.

Các tham số:
mapViewChế độ xem bản đồ được nhấn vào.
placeIDMã địa điểm của địa điểm yêu thích đã được nhấn vào.
tênTên địa điểm yêu thích đã được nhấn.
vị tríVị trí của POI đã được nhấn vào.
- (nullable UIView *) mapView: (GMSMapView *) mapView
cửa sổ thông tin đánh dấu: (GMSMarker *) điểm đánh dấu
[optional]

Được gọi khi một điểm đánh dấu sắp được chọn, đồng thời cung cấp một cửa sổ thông tin tuỳ chỉnh không bắt buộc để sử dụng cho điểm đánh dấu đó nếu phương thức này trả về một UIView.

Nếu bạn thay đổi chế độ xem này sau khi gọi phương thức này, những thay đổi đó sẽ không nhất thiết được phản ánh trong phiên bản đã hiển thị.

UIView được trả về không được có giới hạn lớn hơn 500 điểm ở một trong hai chiều. Vì chỉ có một cửa sổ thông tin xuất hiện tại một thời điểm, nên chế độ xem được trả về có thể được sử dụng lại giữa các cửa sổ thông tin khác.

Việc xóa điểm đánh dấu khỏi bản đồ hoặc thay đổi điểm đánh dấu đã chọn của bản đồ trong cuộc gọi này dẫn đến hành vi không xác định.

Trả về:
Cửa sổ thông tin tuỳ chỉnh cho điểm đánh dấu được chỉ định hoặc nil cho mặc định
- (nullable UIView *) mapView: (GMSMapView *) mapView
labelInfoContents: (GMSMarker *) điểm đánh dấu
[optional]

Được gọi khi mapView:markerInfoWindow: trả về nil.

Nếu phương thức này trả về một khung hiển thị, thì khung hiển thị đó sẽ được đặt trong khung cửa sổ thông tin mặc định. Nếu phương thức này trả về giá trị nil, thì phương thức kết xuất mặc định sẽ được sử dụng.

Các tham số:
mapViewChế độ xem bản đồ mà bạn đã nhấn.
điểm đánh dấuĐiểm đánh dấu đã được nhấn.
Trả về:
Thành phần hiển thị tuỳ chỉnh để hiển thị dưới dạng nội dung trong cửa sổ thông tin hoặc không để sử dụng tính năng hiển thị nội dung mặc định
- (vô hiệu) mapView: (GMSMapView *) mapView
wasCloseInfoWindowOfMarker: (GMSMarker *) điểm đánh dấu
[optional]

Được gọi khi cửa sổ thông tin của điểm đánh dấu bị đóng.

- (vô hiệu) mapView: (GMSMapView *) mapView
DidBeginDraggingMarker: (GMSMarker *) điểm đánh dấu
[optional]

Được gọi khi thao tác kéo đã được bắt đầu trên một điểm đánh dấu.

- (vô hiệu) mapView: (GMSMapView *) mapView
DidEndDraggingMarker: (GMSMarker *) điểm đánh dấu
[optional]

Được gọi sau khi kết thúc kéo một điểm đánh dấu.

- (vô hiệu) mapView: (GMSMapView *) mapView
DidDragMarker: (GMSMarker *) điểm đánh dấu
[optional]

Được gọi trong khi một điểm đánh dấu đang được kéo.

– (BOOL) didTapMyLocationButtonForMapView: (GMSMapView *) mapView [optional]

Được gọi khi nhấn vào nút Vị trí của tôi.

Trả về:
CÓ nếu trình nghe đã sử dụng sự kiện (tức là hành vi mặc định không nên xảy ra), KHÔNG nếu không (tức là hành vi mặc định sẽ xảy ra). Hành vi mặc định là để máy ảnh di chuyển sao cho máy ảnh được căn giữa trên vị trí của thiết bị.
- (vô hiệu) mapView: (GMSMapView *) mapView
wasTapMyLocation: (CLLocationCoordinate2D)  vị trí
[optional]

Được gọi khi người dùng nhấn vào Dấu chấm vị trí của tôi.

Các tham số:
mapViewChế độ xem bản đồ được nhấn vào.
vị tríVị trí của thiết bị khi dấu chấm vị trí được nhấn.
- (vô hiệu) mapViewDidStartTileRendering: (GMSMapView *) mapView [optional]

Được gọi khi thẻ thông tin vừa được yêu cầu hoặc nhãn vừa bắt đầu kết xuất.

- (vô hiệu) mapViewDidFinishTileRendering: (GMSMapView *) mapView [optional]

Được gọi khi tất cả các ô đã được tải (hoặc bị lỗi vĩnh viễn) và nhãn đã được hiển thị.

– (vô hiệu) mapViewSnapshotReady: (GMSMapView *) mapView [optional]

Được gọi khi bản đồ ổn định (các thẻ thông tin được tải, nhãn được kết xuất, máy ảnh ở trạng thái rảnh) và các đối tượng lớp phủ đã được kết xuất.

- (vô hiệu) mapView: (GMSMapView *) mapView
wasChangeMapCapabilities: (GMSMapCapabilityFlags) mapCapabilities
[optional]

Được gọi mỗi khi các chức năng của bản đồ được thay đổi.

Các tham số:
mapViewChế độ xem bản đồ nơi mapCapabilities đã thay đổi.
mapCapabilitiesCờ thể hiện các chức năng hiện có trên bản đồ.
- (vô hiệu) mapView: (GMSMapView *) mapView
DidTapFeatures: (NSArray< id< GMSFeature >> *) tính năng
inFeatureLayer: (GMSFeatureLayer *) featureLayer
tại Vị trí: (CLLocationCoordinate2D)  vị trí
[optional]

Được gọi sau khi các đối tượng trong lớp tính năng định kiểu theo hướng dữ liệu được nhấn vào.

Tất cả các đối tượng chồng chéo với điểm đang được nhấn sẽ được đưa vào. Nếu các đối tượng thuộc về các lớp đối tượng khác nhau, phương thức này sẽ được gọi nhiều lần (một lần cho mỗi lớp đối tượng riêng lẻ).

Không có thứ tự được đảm bảo giữa các sự kiện trên các lớp đối tượng khác nhau hoặc giữa các sự kiện trên các lớp đối tượng và các đối tượng khác trên bản đồ cơ sở.

Các tham số:
mapViewChế độ xem bản đồ được nhấn vào.
tính năngLoạt tất cả các đối tượng được nhấp vào trong lớp.
featureLayerLớp đối tượng có chứa tính năng.
vị tríVị trí của điểm nhấn thực tế.