Tạo điểm đánh dấu nâng cao

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

Sử dụng lớp con GMSAdvancedMarker để tạo các tính năng đánh dấu cơ bản hoặc cụ thể, như minh hoạ dưới đây. Là một lớp con của GMSMarker, GMSAdvancedMarker cung cấp các điểm đánh dấu có nhiều biểu thức hơn.

Swift

let camera = GMSCameraPosition( target: coordinate, zoom: 14)
let mapID = GMSMapID(identifier: "YOUR_MAP_ID")
let mapView = GMSMapView(frame: view.bounds, mapID: mapID, camera: camera)

let marker = GMSAdvancedMarker(position: coordinate)
marker.map = mapView

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithTarget:kCoordinate zoom:16];
GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:"YOUR_MAP_ID"];

self.mapView = [GMSMapView mapWithFrame:self.view.bounds mapID:mapID camera:camera];

GMSAdvancedMarker *marker = [GMSAdvancedMarker markerWithPosition:kCoordinate];
Marker.map = self.mapView;

Lưu ý: Để kiểm thử, bạn có thể bỏ qua bước tạo và định cấu hình mã bản đồ bằng cách sử dụng mapId: DEMO_MAP_ID trong mã ứng dụng của mình. DEMO_MAP_ID chỉ dành cho mục đích thử nghiệm. Đừng sử dụng DEMO_MAP_ID trong môi trường phát hành chính thức.

Xóa điểm đánh dấu nâng cao

Tương tự như GMSMarker, bạn có thể xoá điểm đánh dấu nâng cao khỏi bản đồ bằng cách đặt thuộc tính bản đồ của GMSAdvancedMarker thành nil. Ngoài ra, bạn có thể xoá tất cả lớp phủ (bao gồm cả các điểm đánh dấu nâng cao) trên bản đồ bằng cách gọi phương thức GMSMapView clear.

Swift

let camera = GMSCameraPosition.camera(
  withLatitude: -33.8683,
  longitude: 151.2086,
  zoom: 6
)
let mapView = GMSMapView.map(withFrame: .zero, camera: camera)
// ...
mapView.clear()
      

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
// ...
[mapView clear];
      

Nếu bạn muốn sửa đổi một điểm đánh dấu sau khi đã thêm điểm đánh dấu đó vào bản đồ, hãy đảm bảo rằng bạn đang giữ đối tượng GMSAdvancedMarker. Bạn có thể sửa đổi điểm đánh dấu sau bằng cách thay đổi đối tượng này.

Swift

let position = CLLocationCoordinate2D(latitude: 10, longitude: 10)
let marker = GMSAdvancedMarker(position: position)
marker.map = mapView
// ...
marker.map = nil

Objective-C

CLLocationCoordinate2D position = CLLocationCoordinate2DMake(10, 10);
GMSAdvancedMarker *marker = [GMSAdvancedMarker markerWithPosition:position];
marker.map = mapView;
// ...
marker.map = nil;

Các chức năng của bản đồ

Thuộc tính mapCapabilities trên GMSMapView thêm quy trình kiểm tra có lập trình cho các tính năng dành riêng cho bản đồ. Điều này rất hữu ích khi muốn biết liệu một số chức năng nhất định của bản đồ có sẵn hay không trước khi gọi các API cụ thể. Hàm didChangeMapCapabilities của GMSMapViewDelegate cũng được gọi khi các chức năng thay đổi. Truy vấn này xác định liệu chế độ xem bản đồ có hỗ trợ điểm đánh dấu nâng cao hay không.

Swift

// ...

let advancedMarker: GMSAdvancedMarker = {
GMSAdvancedMarker(position: CLLocationCoordinate2D(latitude: 47.6089945, longitude: -122.3410462))
}()

let marker: GMSMarker = {
GMSMarker(position: CLLocationCoordinate2D(latitude: 47.6089945, longitude: -122.3410462))
}()

func addMarker() {
  if mapView.mapCapabilities.contains(.advancedMarkers) {
      advancedMarker.map = mapView
    } else {
      marker.map = mapView
    }
}

extension MapCapabilities: GMSMapViewDelegate {
  func mapView(_ mapView: GMSMapView, didChangeMapCapabilities mapCapabilities: GMSMapCapabilityFlags) {

     let advancedMarkerAvailable = mapCapabilities.contains(.advancedMarkers)

     advancedMarker.map = advancedMarkerAvailable ? mapView : nil
     marker.map = advancedMarkerAvailable ? nil : mapView
  }
}

Objective-C

// ...

_advancedMarker = [GMSAdvancedMarker markerWithPosition:  kSeattleCoordinates];
_fallbackMarker = [GMSMarker markerWithPosition: kSeattleCoordinates];

-   (void)addMarker {

  if (_mapView.mapCapabilities & GMSMapCapabilityFlagsAdvancedMarkers) {
    _advancedMarker.map = _mapView;
    } else {
    _fallbackMarker.map = _mapView;
  }
}

#pragma mark - GMSMapViewDelegate

-   (void)mapView:(GMSMapView *)mapView
    didChangeMapCapabilities:(GMSMapCapabilityFlags)mapCapabilities {
  BOOL advancedMarkersAvailable = mapCapabilities & GMSMapCapabilityFlagsAdvancedMarkers;
  _advancedMarker.map = advancedMarkersAvailable ? _mapView : nil;
  _fallbackMarker.map = advancedMarkersAvailable ? nil : _mapView;
}