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. 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.

Xóa đ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ả cá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 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 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 bạn vẫn 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;

Chức năng của bản đồ

Thuộc tính mapCapabilities trên GMSMapView bổ sung tính năng 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 các tính năng bản đồ nhất định 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 chức năng thay đổi. Truy vấn này sẽ xác định xem chế độ xem bản đồ có hỗ trợ các đ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;
}