Erweiterte Markierungen erstellen

Plattform auswählen: Android iOS JavaScript

Verwenden Sie die Unterklasse GMSAdvancedMarker, um einfache oder spezifische Markierungselemente zu erstellen, wie unten gezeigt. Als Unterklasse von GMSMarker bietet GMSAdvancedMarker Markierungen mehr Ausdruckskraft.

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: Zum Testen können Sie den Schritt zum Erstellen und Konfigurieren einer Karten-ID überspringen und einfach „mapId: DEMO_MAP_ID“ in Ihrem App-Code verwenden. DEMO_MAP_ID ist nur für Testzwecke vorgesehen. DEMO_MAP_ID darf nicht in einer Produktionsumgebung verwendet werden.

Erweiterte Markierung entfernen

Ähnlich wie bei GMSMarker können Sie eine erweiterte Markierung von der Karte entfernen, indem Sie die Karteneigenschaft des GMSAdvancedMarker auf nil setzen. Alternativ können Sie alle Overlays (einschließlich erweiterter Markierungen) auf der Karte entfernen, indem Sie die Methode GMSMapView clear 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, muss das Objekt GMSAdvancedMarker beibehalten werden. 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 unter GMSMapView wird eine programmatische Prüfung auf kartenspezifische Funktionen hinzugefügt. Das ist nützlich, wenn Sie wissen möchten, ob bestimmte Kartenfunktionen verfügbar sind, bevor Sie bestimmte APIs aufrufen. Die Funktion didChangeMapCapabilities 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;
}