Erweiterte Markierungen erstellen

Plattform auswählen: Android iOS JavaScript

Sie können die abgeleitete GMSAdvancedMarker-Klasse verwenden, um grundlegende oder spezifische Markierungsfunktionen zu erstellen (siehe unten). Als abgeleitete Klasse von GMSMarker bietet GMSAdvancedMarker Markierungen mit mehr Ausdrücken.

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;

Hinweis: Für Testzwecke können Sie den Schritt zum Erstellen und Konfigurieren einer Karten-ID überspringen, indem Sie in Ihrem App-Code „mapId: DEMO_MAP_ID“ verwenden. DEMO_MAP_ID ist nur für Testzwecke vorgesehen. Verwenden Sie DEMO_MAP_ID nicht in einer Produktionsumgebung.

Erweiterte Markierungen entfernen

Ähnlich wie bei GMSMarker kannst du eine erweiterte Markierung von der Karte entfernen, indem du die Karteneigenschaft der GMSAdvancedMarker auf nil setzt. Alternativ können Sie alle Overlays (einschließlich erweiterter Markierungen) auf der Karte entfernen, indem Sie die clear-Methode GMSMapView aufrufen.

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];
      

Wenn Sie eine Markierung ändern möchten, nachdem Sie sie der Karte hinzugefügt haben, verwenden Sie das Objekt GMSAdvancedMarker. Sie können die Markierung später mithilfe dieses Objekts ändern.

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;

Kartenfunktionen

Mit der Eigenschaft mapCapabilities für GMSMapView wird die programmatische Prüfung für kartenspezifische Elemente aktiviert. Das ist nützlich, wenn Sie wissen möchten, ob bestimmte Kartenfunktionen verfügbar sind, bevor Sie bestimmte APIs aufrufen. Die didChangeMapCapabilities-Funktion von GMSMapViewDelegate wird auch aufgerufen, wenn sich die Funktionen ändern. Mit dieser Abfrage wird ermittelt, ob die Kartenansicht erweiterte Markierungen unterstützt.

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;
}