Lớp phủ mặt đất

Chọn nền tảng: Android iOS JavaScript

Lớp phủ mặt đất là lớp phủ trên bản đồ được gắn với toạ độ vĩ độ/kinh độ, vì vậy lớp phủ này sẽ di chuyển khi bạn kéo hoặc thu phóng bản đồ.

Giới thiệu

Lớp phủ trên mặt đất là một hình ảnh được cố định vào bản đồ. Không giống như điểm đánh dấu, lớp phủ trên mặt đất được hướng dựa vào bề mặt của Trái đất thay vì màn hình. Vì vậy, việc xoay, nghiêng hoặc thu phóng bản đồ sẽ thay đổi hướng của hình ảnh.

Để thêm lớp phủ mặt đất, hãy tạo đối tượng GMSGroundOverlay xác định cả biểu tượng và ranh giới. Không chỉ định một trong hai tùy chọn này sẽ khiến lớp phủ mặt đất không xuất hiện trên bản đồ. Bạn có thể tuỳ ý chỉ định các chế độ cài đặt bổ sung ảnh hưởng đến vị trí của hình ảnh trên bản đồ. Sau khi xác định các tuỳ chọn cần thiết, hãy đặt thuộc tính map của đối tượng này để thêm lớp phủ.

Thêm lớp phủ

1. Tạo thực thể cho đối tượng GMSGroundOverlay mới
2. Đặt thuộc tính icon thành một thực thể của UIImage.
3. Đặt thuộc tính bounds thành một thực thể của GMSCoordinateBounds. Các ranh giới này đại diện cho các góc phía Tây Nam và Đông Bắc của hình ảnh.
4. Đặt các thuộc tính không bắt buộc, chẳng hạn như bearing và zoomLevel, nếu muốn.
5. Thiết lập thuộc tính map – hình ảnh sẽ xuất hiện trên bản đồ.

Ví dụ bên dưới minh hoạ cách thêm lớp phủ mặt đất vào đối tượng GMSMapView hiện có.

Swift

let southWest = CLLocationCoordinate2D(latitude: 40.712216, longitude: -74.22655)
let northEast = CLLocationCoordinate2D(latitude: 40.773941, longitude: -74.12544)
let overlayBounds = GMSCoordinateBounds(coordinate: southWest, coordinate: northEast)

// Image from http://www.lib.utexas.edu/maps/historical/newark_nj_1922.jpg
let icon = UIImage(named: "newark_nj_1922")

let overlay = GMSGroundOverlay(bounds: overlayBounds, icon: icon)
overlay.bearing = 0
overlay.map = mapView
      

Objective-C

CLLocationCoordinate2D southWest = CLLocationCoordinate2DMake(40.712216,-74.22655);
CLLocationCoordinate2D northEast = CLLocationCoordinate2DMake(40.773941,-74.12544);
GMSCoordinateBounds *overlayBounds = [[GMSCoordinateBounds alloc] initWithCoordinate:southWest
                                                                        coordinate:northEast];

// Image from http://www.lib.utexas.edu/maps/historical/newark_nj_1922.jpg
UIImage *icon = [UIImage imageNamed:@"newark_nj_1922"];
GMSGroundOverlay *overlay = [GMSGroundOverlay groundOverlayWithBounds:overlayBounds icon:icon];
overlay.bearing = 0;
overlay.map = mapView;
      

Xoá lớp phủ

Bạn có thể xóa lớp phủ mặt đất khỏi bản đồ bằng cách đặt thuộc tính map của GMSGroundOverlay thành nil. Ngoài ra, bạn có thể xoá tất cả các lớp phủ (bao gồm cả lớp phủ trên mặt đất hiện có trên bản đồ bằng cách gọi phương thức GMSMapView clear.

Swift

mapView.clear()
      

Objective-C

[mapView clear];
      

Nếu bạn muốn sửa đổi lớp phủ trên mặt đất sau khi thêm lớp phủ đó vào bản đồ, hãy nhớ giữ đối tượng GMSGroundOverlay. Bạn có thể sửa đổi lớp phủ mặt đất vào lúc khác bằng cách thay đổi đối tượng này.

Swift

let overlay = GMSGroundOverlay(bounds: overlayBounds, icon: icon)
overlay.bearing = 0
overlay.map = mapView

// ...

overlay.isTappable = true
      

Objective-C

GMSGroundOverlay *overlay = [GMSGroundOverlay groundOverlayWithBounds:overlayBounds icon:icon];
overlay.bearing = 0;
overlay.map = mapView;

// ...
overlay.tappable = YES;
      

Sự kiện

Bạn có thể theo dõi các sự kiện xảy ra trên bản đồ, chẳng hạn như khi người dùng nhấn vào một lớp phủ. Để theo dõi các sự kiện, bạn phải triển khai giao thức GMSMapViewDelegate. Xem hướng dẫn về sự kiện và danh sách phương thức trên GMSMapViewDelegate.