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 điểm đánh dấu cơ bản hoặc cụ thể, như minh hoạ bên dưới. Là một lớp con của GMSMarker, GMSAdvancedMarker cung cấp các điểm đánh dấu có biểu thức phong phú 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. DEMO_MAP_ID chỉ dành cho mục đích thử nghiệm. Không sử dụng DEMO_MAP_ID trong môi trường phát hành chính thức.

Xoá điểm đánh dấu nâng cao

Tương tự như GMSMarker, bạn có thể xoá một đ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ả điểm đánh dấu nâng cao) trên bản đồ bằng cách gọi phương thức clear GMSMapView.

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 giữ lại đối tượng GMSAdvancedMarker. Bạn có thể sửa đổi điểm đánh dấu sau này 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;

Khả năng của bản đồ

Thuộc tính mapCapabilities trên GMSMapView thêm tính năng kiểm tra theo phương thứ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 bạn muốn biết liệu có một số tính năng bản đồ nhất định 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 xem 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;
}